WhatsApp: reagir a mensagens
Reaja com um emoji a uma mensagem de uma conversa de WhatsApp, ou tire a reação, pela API da XBASE, usando o id da mensagem na Meta.
Atualizado em
Uma reação é um emoji aplicado a uma mensagem da conversa, como no WhatsApp do celular. Ela vale para mensagens recebidas do contato e para mensagens enviadas pela empresa.
Reagir a uma mensagem
POST https://api.xbase.app/api/external/v1/whatsapp/messages/{messageId}/reactionmessageId é o id da mensagem na Meta (wamid.…): o que volta na resposta dos envios e chega nos eventos dos webhooks do workspace.
| Campo | Tipo | Obrigatório | Regra |
|---|---|---|---|
emoji | texto | sim | Um emoji só, como "👍" ou "❤️". Vazio ("") tira a reação |
curl -X POST https://api.xbase.app/api/external/v1/whatsapp/messages/wamid.HBgNNTUyMTk5OTk5MDAwMBUCABIYFDNBMjc1QjE3RjdCNEE1QzlEMjA4AA==/reaction \
-H "Authorization: Bearer $XBASE_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "emoji": "👍" }'Resposta 200:
{ "success": true }Como a reação aparece
- O contato vê o emoji na mensagem, no WhatsApp dele. A reação também aparece na mensagem, no Chatcenter.
- A empresa tem uma reação por mensagem: reagir de novo troca o emoji.
- A XBASE não confere a janela de 24 horas na reação: quem decide é a Meta. Se ela recusar, a resposta é 422
META_ERROR. - A Meta não aceita reação a mensagem com mais de 30 dias (422
META_ERROR).
Erros
| Status | code | Quando |
|---|---|---|
| 400 | (sem code) | emoji com mais de um emoji ou com texto, ou messageId fora do formato |
| 404 | MESSAGE_NOT_FOUND | A mensagem não é de uma conversa de WhatsApp deste workspace |
| 422 | SEND_REJECTED | A XBASE recusou, por exemplo, porque o número da conversa foi desconectado |
| 422 | META_ERROR | A Meta recusou, por exemplo, mensagem com mais de 30 dias |
Veja o formato completo em Erros.
Perguntas frequentes
Veja também
Mensagens
Envie texto, imagem, vídeo, áudio, documento, figurinha, localização, botões e lista no WhatsApp pela API da XBASE, na janela de 24 horas.
Marcar como lida
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.