WhatsApp APIAPI

WhatsApp: reaccionar a mensajes

Reacciona con un emoji a un mensaje de una conversación de WhatsApp, o quita la reacción, por la API de XBASE con el id del mensaje en Meta.

Actualizado el

Una reacción es un emoji aplicado a un mensaje de la conversación, como en el WhatsApp del celular. Vale para mensajes recibidos del contacto y para mensajes enviados por la empresa.

Reaccionar a un mensaje

POST https://api.xbase.app/api/external/v1/whatsapp/messages/{messageId}/reaction

messageId es el id del mensaje en Meta (wamid.…): el que vuelve en la respuesta de los envíos y llega en los eventos de los webhooks del workspace.

CampoTipoObligatorioRegla
emojitextosíUn solo emoji, como "👍" o "❤️". Vacío ("") quita la reacción
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": "👍" }'

Respuesta 200:

{ "success": true }

Cómo aparece la reacción

  • El contacto ve el emoji en el mensaje, en su WhatsApp. La reacción también aparece en el mensaje, en el Chatcenter.
  • La empresa tiene una reacción por mensaje: reaccionar de nuevo cambia el emoji.
  • XBASE no revisa la ventana de 24 horas en la reacción: decide Meta. Si Meta la rechaza, la respuesta es 422 META_ERROR.
  • Meta no acepta reacciones a mensajes con más de 30 días (422 META_ERROR).

Errores

EstadocodeCuándo
400(sin code)emoji con más de un emoji o con texto, o messageId con formato incorrecto
404MESSAGE_NOT_FOUNDEl mensaje no es de una conversación de WhatsApp de este workspace
422SEND_REJECTEDXBASE rechazó, por ejemplo, porque el número de la conversación se desconectó
422META_ERRORMeta rechazó, por ejemplo, un mensaje con más de 30 días

Mira el formato completo en Errores.

Preguntas frecuentes

Ver también

En esta página