Endpoint
GET /v1/conversations/:id/messages
read:conversations
Parâmetros de query
| Parâmetro | Tipo | Descrição |
|---|---|---|
limit | integer | Itens por página. Padrão: 50. Máximo: 100 |
cursor | string | Token de paginação |
order | string | desc (padrão, mais recentes primeiro) ou asc |
Exemplo de requisição
curl "https://api.socialsell.ai/v1/conversations/664632f1260b42723a5ed4ed/messages?limit=20&order=asc" \
-H "Authorization: Bearer sk_live_..."
Exemplo de resposta
{
"data": [
{
"id": "664314fda3abe63975abff27",
"conversation_id": "664632f1260b42723a5ed4ed",
"content": "Olá! Gostaria de saber mais sobre os planos.",
"type": "text",
"sender": "contact",
"sent_by": null,
"media": null,
"is_internal_note": false,
"reactions": [],
"sent_at": "2026-06-10T10:05:00.000Z"
},
{
"id": "664c7d6322882046cece02f6",
"conversation_id": "664632f1260b42723a5ed4ed",
"content": "Olá! Com prazer! Temos planos Starter, Growth e Scale. Qual melhor se encaixa na sua necessidade?",
"type": "text",
"sender": "agent",
"sent_by": {
"id": "664a1b2c3d4e5f6789012345",
"name": "Maria Santos"
},
"media": null,
"is_internal_note": false,
"reactions": [
{ "emoji": "👍", "sender": "contact" }
],
"sent_at": "2026-06-10T10:07:00.000Z"
},
{
"id": "66468f896da3f6445c391e5f",
"conversation_id": "664632f1260b42723a5ed4ed",
"content": null,
"type": "image",
"sender": "contact",
"sent_by": null,
"media": {
"url": "https://s3.amazonaws.com/...",
"mime_type": "image/jpeg",
"filename": "screenshot.jpg",
"size_bytes": 245760
},
"is_internal_note": false,
"reactions": [],
"sent_at": "2026-06-10T10:10:00.000Z"
}
],
"meta": {
"total": 47,
"has_more": true,
"next_cursor": "eyJpZCI6IjY2NGsybDNtNG41bzZwMXExcjJzM3Q0dTVpIiwiY2EiOiIyMDI2LTA2LTEwVDEwOjEwOjAwLjAwMFoifQ"
}
}
Objeto mensagem
| Campo | Tipo | Descrição |
|---|---|---|
id | string | ID da mensagem |
conversation_id | string | ID da conversa |
content | string|null | Texto da mensagem |
type | string | text, image, video, audio, document |
sender | string | contact, agent, ai_agent, system |
sent_by | object|null | Membro que enviou {id, name}. null para mensagens do contato, do agente de IA e das que saíram pelo celular, pela API ou por automação |
media | object|null | Mídia: {url, mime_type, filename, size_bytes} |
is_internal_note | boolean | Se é comentário interno (não visível ao contato) |
reactions | array | Reações: [{emoji, sender}] |
sent_at | string | Timestamp de envio |
edited_at | string | null | Quando a mensagem foi editada, se foi |
meta.total vem de um contador denormalizado da conversa e pode divergir levemente da contagem real
das mensagens. Use has_more como condição de parada da paginação, não o total.Erros
| Código | Status | Descrição |
|---|---|---|
INVALID_ID | 400 | ID com formato inválido |
NOT_FOUND | 404 | Conversa não encontrada |