WhatsApp APIAPI
WhatsApp: marcar mensagens como lidas
Marque como lida uma mensagem recebida no WhatsApp, para o contato ver os dois tiques azuis, e mostre o aviso de digitando pela API da XBASE.
Atualizado em
Marcar como lida faz o contato ver os dois tiques azuis na mensagem dele. Com typing, ele também vê o aviso digitando… enquanto a resposta não chega.
Marcar como lida
POST https://api.xbase.app/api/external/v1/whatsapp/messages/{messageId}/readmessageId é o id da mensagem recebida do contato (wamid.…), como chega no evento whatsapp.message.received dos webhooks do workspace. A leitura sai pelo número que recebeu a mensagem, e a Meta marca como lidas também as mensagens anteriores da conversa.
| Campo | Tipo | Obrigatório | Regra |
|---|---|---|---|
typing | booleano | não | true mostra digitando… para o contato até a próxima mensagem do número, por no máximo 25 segundos |
curl -X POST https://api.xbase.app/api/external/v1/whatsapp/messages/wamid.HBgNNTUyMTk5OTk5MDAwMBUCABIYFDNBMjc1QjE3RjdCNEE1QzlEMjA4AA==/read \
-H "Authorization: Bearer $XBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "typing": true }'Resposta 200:
{ "success": true }O corpo é opcional: sem ele, a mensagem é só marcada como lida.
Quando usar
- Quando o seu sistema ou agente lê a mensagem, antes de responder.
- Com
typing: true, quando a resposta vai levar alguns segundos, como a de um agente de IA. - A leitura não muda a janela de 24 horas: só a mensagem do contato abre a janela.
Erros
| Status | code | Quando |
|---|---|---|
| 400 | (sem code) | Corpo inválido ou messageId fora do formato |
| 400 | NOT_INCOMING_MESSAGE | A mensagem foi enviada pela empresa: só mensagem recebida pode ser marcada como lida |
| 404 | MESSAGE_NOT_FOUND | A mensagem não é de uma conversa de WhatsApp deste workspace |
| 422 | NUMBER_DISCONNECTED | O número que recebeu a mensagem está desconectado |
| 422 | SEND_REJECTED | A XBASE recusou, por exemplo, porque o número da conversa foi desconectado |
| 422 | META_ERROR | A Meta recusou |
Veja o formato completo em Erros.