Atendimento

Mensagens

Envie pelo WhatsApp e leia o histórico das conversas.

Nesta página

Enviar texto

POST /conversations/{id}/messages envia uma mensagem na conversa. Ela sai de verdade pelo WhatsApp, pelo número da conversa, e aparece no NextChat para a equipe.

POST/conversations/{id}/messagesbash

curl -X POST "$NEXTCHAT_API/conversations/ID_DA_CONVERSA/messages" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"3f1c1e0e-5c1a-4a52-9a43-8f9a1a1b2c3d","text":"Sua guia já está disponível."}'

Campo	Obrigatório	Descrição
`client_id`	Sim	UUID escolhido por você. Repetir o mesmo `client_id` devolve a mensagem já criada em vez de enviar de novo.
`text`	Sem `media_id`	Texto da mensagem (ou a legenda do arquivo).
`media_id`	Não	Arquivo enviado antes em `POST /media`.
`reply_to_external_id`	Não	Responde citando uma mensagem da conversa.

Sem duplicar envios

Gere o client_id uma vez por mensagem e guarde-o junto do pedido no seu sistema. Se a conexão cair e você repetir a chamada, o cliente recebe uma mensagem só.

Enviar arquivo

Primeiro envie o arquivo em POST /media (multipart/form-data, campo file, permissão media:write). A resposta traz o id; use-o como media_id na mensagem.

POST/mediabash

curl -X POST "$NEXTCHAT_API/media" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -F "[email protected]"

POST/conversations/{id}/messagesbash

curl -X POST "$NEXTCHAT_API/conversations/ID_DA_CONVERSA/messages" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"client_id":"9b2e4a10-7d3c-4f1e-8a2b-1c0d9e8f7a6b","media_id":"ID_DO_ARQUIVO","text":"Segue o boleto de outubro."}'

Ler o histórico

GET /conversations/{id}/messages lê da mais recente para trás. Use limit e before (ou after) para paginar. GET /messages/{id} traz uma mensagem só, e GET /media/{id}/url devolve um link temporário para baixar o arquivo de uma mensagem.

GET/conversations/{id}/messagesbash

curl "$NEXTCHAT_API/conversations/ID_DA_CONVERSA/messages?limit=50" \
  -H "Authorization: Bearer $NEXTCHAT_API_KEY"

Para receber cada mensagem nova sem consultar a API o tempo todo, use o evento message.received dos webhooks.

Endpoints

Método	Caminho	Ação	Permissão
GET	`/conversations/{id}/messages`	Ler mensagens	`messages:read`
POST	`/conversations/{id}/messages`	Enviar mensagem (idempotente por client_id)	`messages:send`
GET	`/messages/{id}`	Uma mensagem	`messages:read`
POST	`/media`	Enviar arquivo (multipart/form-data, campo file)	`media:write`
GET	`/media/{id}/url`	Link temporário da mídia	`messages:read`