Referencia (endpoints)Atender una conversación
Reaccionar a un mensaje
Úsalo para reaccionar con un emoji a un mensaje de una conversación, por ejemplo para acusar recibo sin escribir una respuesta.
PUT
Permiso requerido: Contactos y conversaciones → Enviar
Pone o reemplaza la reacción de tu cuenta a un mensaje del contacto: un emoji en emoji. Para quitarla, DELETE en la misma ruta.
- Se procesa después:
202sin cuerpo quiere decir que la reacción se aceptó, no que ya se aplicó. Se envía a WhatsApp desde una cola y queda aplicada solo cuando WhatsApp la confirma. - Cómo saber el resultado: la reacción vigente de cada mensaje está en
reactionsdeGET /contacts/{contact_id}/messages; la de tu cuenta viene conactorbusiness. Ese dato cambia solo cuando WhatsApp confirma la reacción. - Si falla después del
202(por ejemplo, WhatsApp la rechaza, no hay saldo de WhatsApp o el pago del número está vencido),reactionsqueda como estaba y se emite el evento de webhookmessage.reaction_failed, una vez por pedido, con el motivo enreasony el momento en que se aceptó el pedido enrequested_at. Para recibirlo, suscríbete amessage.reaction_failed(sección «Webhooks»).
| HTTP | Cuándo |
|---|---|
| 404 | El contacto o el mensaje no existe o es de otra cuenta, el mensaje es de otro contacto, el mensaje pasó por un número de otro workspace de tu cuenta, o la clave es de un agente y el contacto no está asignado a ese agente. Es la misma respuesta en todos los casos. |
| 422 | No se puede reaccionar a ese mensaje y no se envía nada. error dice por qué: no_provider_uid (el mensaje no tiene un id de WhatsApp, por ejemplo una nota o un envío que no salió), message_not_reactable (ese tipo de mensaje no admite reacciones), message_deleted (el mensaje se eliminó), device_disconnected (el número por el que pasó el mensaje ya no está o está desconectado), provider_unsupported (ese número no admite reacciones) o window_expired (en un número de la API oficial de WhatsApp, pasaron más de 24 horas desde el último mensaje que el contacto le escribió a ese número). recipient_unsupported si el contacto es un grupo, una lista de difusión o un canal. En un PUT, también si emoji no es un emoji. |
| 429 | rate_limited: se superó el ritmo de la sección «Envío de mensajes con clave» (ver Retry-After). |
httpheader
AuthorizationBearer <clave>contact*stringId opaco: un texto que empieza con ctc_. Se usa tal como llega; no se arma ni se interpreta.
Patrón
^ctc_[A-Za-z0-9]{23}$message*stringId opaco: un texto que empieza con msg_. Se usa tal como llega; no se arma ni se interpreta.
Patrón
^msg_[A-Za-z0-9]{23}$application/json- body
emoji*stringLargo
length <= 32Accepted
curl -X PUT "https://example.com/contacts/ctc_AAOzYSKDiqHT4hM8LdPB8Ut/messages/msg_As2pkZIkjmvC3nnoiFlYfDo/reaction" \ -H "Content-Type: application/json" \ -d '{ "emoji": "string" }'Vacío