Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Retorna uma lista paginada de conversas do inbox multi-canal.
GET /v1/conversations
read:conversations
| Parâmetro | Tipo | Descrição |
|---|---|---|
limit | integer | Itens por página. Padrão: 25. Máximo: 100 |
cursor | string | Token de paginação |
status | string | open ou closed (arquivada) |
channel | string | whatsapp, instagram, messenger, web_chat (chat do site) ou other |
assigned_to | string | ID do membro responsável |
contact_id | string | ID do contato |
unread | boolean | true — apenas conversas não lidas |
updated_after | string | ISO 8601 — conversas atualizadas após esta data |
objective | string | Depreciado. Aceito por compatibilidade, sem filtrar os resultados |
ai_managed | boolean | true — gerenciadas por agente de IA |
whatsapp_instance_id | string | ID da instância WhatsApp |
messenger_page_id | string | ID da página Messenger |
instagram_account_id | string | ID da conta Instagram |
curl "https://api.socialsell.ai/v1/conversations?status=open&channel=whatsapp&unread=true" \
-H "Authorization: Bearer sk_live_..."
{
"data": [
{
"id": "664632f1260b42723a5ed4ed",
"contact": {
"id": "664f1a2b3c4d5e6f78901234",
"name": "João Silva",
"phone": "+5511999999999"
},
"channel": "whatsapp",
"whatsapp_instance": {
"id": "6643cb19da1774a51495b603",
"name": "WhatsApp Principal",
"phone": "+5511333344445"
},
"messenger_page": null,
"instagram_account": null,
"status": "open",
"assigned_to": {
"id": "664a1b2c3d4e5f6789012345",
"name": "Maria Santos"
},
"objective": null,
"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"
}
}
| Campo | Tipo | Descrição |
|---|---|---|
id | string | ID da conversa |
contact | object | null | Contato {id, name, phone} |
channel | string | whatsapp, instagram, messenger, web_chat ou other |
channel | string | whatsapp, instagram, messenger, web_chat (chat do site) ou other |
whatsapp_instance | object|null | Instância WhatsApp {id, name, phone} |
messenger_page | object|null | Página Messenger {id, page_id, page_name} |
instagram_account | object|null | Conta Instagram {id, username} |
status | string | open ou closed |
assigned_to | object|null | Responsável {id, name} |
objective | string|null | Depreciado. Retorna null; não representa modo ou estado da conversa |
ai_agent | object|null | Agente ativo {id, name, paused, activated_at}. Ver nota sobre paused |
unread_count | integer | Mensagens não lidas |
last_message | object|null | Última mensagem {content, sent_at, sender} |
tags | string[] | Tags da conversa |
created_at | string | Timestamp de criação |
updated_at | string | Timestamp de atualização |
type: "direct"). O chat interno da equipe nunca
aparece aqui.ai_agent.paused é legado: ele não reflete uma pausa daquela conversa, e sim se o atendimento
automático da organização está desligado. O nome foi mantido para não quebrar integrações existentes.| Código | Status | Descrição |
|---|---|---|
INTERNAL_ERROR | 500 | Falha interna ao processar a requisição |