Skip to main content

Endpoint

GET /v1/conversations
Escopo necessário: read:conversations

Parâmetros de query

ParâmetroTipoDescrição
limitintegerItens por página. Padrão: 25. Máximo: 100
cursorstringToken de paginação
statusstringopen ou closed (arquivada)
channelstringwhatsapp, instagram, messenger
assigned_tostringID do membro responsável
contact_idstringID do contato
unreadbooleantrue — apenas conversas não lidas
updated_afterstringISO 8601 — conversas atualizadas após esta data
objectivestringsales ou support
ai_managedbooleantrue — gerenciadas por agente de IA
whatsapp_instance_idstringID da instância WhatsApp
messenger_page_idstringID da página Messenger
instagram_account_idstringID da conta Instagram

Exemplo de requisição

curl "https://api.socialsell.ai/v1/conversations?status=open&channel=whatsapp&unread=true" \
  -H "Authorization: Bearer sk_live_..."

Exemplo de resposta

{
  "data": [
    {
      "id": "664g2h3i4j5k6l7m8n9o0p1q",
      "contact": {
        "id": "664f1a2b3c4d5e6f78901234",
        "name": "João Silva",
        "phone": "+5511999999999"
      },
      "channel": "whatsapp",
      "whatsapp_instance": {
        "id": "664h3i4j5k6l7m8n9o0p1q2r",
        "name": "WhatsApp Principal",
        "phone": "+5511333344445"
      },
      "messenger_page": null,
      "instagram_account": null,
      "status": "open",
      "assigned_to": {
        "id": "664a1b2c3d4e5f6789012345",
        "name": "Maria Santos"
      },
      "objective": "sales",
      "ai_agent": null,
      "unread_count": 3,
      "last_message": {
        "content": "Olá, gostaria de saber mais sobre os planos.",
        "sent_at": "2026-06-10T15:45:00.000Z",
        "sender": "contact"
      },
      "tags": ["quente"],
      "created_at": "2026-06-10T10:00:00.000Z",
      "updated_at": "2026-06-10T15:45:00.000Z"
    }
  ],
  "meta": {
    "total": 128,
    "has_more": true,
    "next_cursor": "eyJpZCI6IjY2NGcyaDNpNGo1azZsN204bjlvMHAxcSIsImNhIjoiMjAyNi0wNi0xMFQxNTo0NTowMC4wMDBaIn0"
  }
}

Objeto conversa

CampoTipoDescrição
idstringID da conversa
contactobjectContato {id, name, phone}
channelstringwhatsapp, instagram, messenger
whatsapp_instanceobject|nullInstância WhatsApp {id, name, phone}
messenger_pageobject|nullPágina Messenger {id, page_id, page_name}
instagram_accountobject|nullConta Instagram {id, username}
statusstringopen ou closed
assigned_toobject|nullResponsável {id, name}
objectivestring|nullsales ou support
ai_agentobject|nullAgente ativo {id, name, paused, activated_at}
unread_countintegerMensagens não lidas
last_messageobject|nullÚltima mensagem {content, sent_at, sender}
tagsstring[]Tags da conversa
created_atstringTimestamp de criação
updated_atstringTimestamp de atualização