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
/contacts/{contact}/messages/{message}/reaction

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: 202 sin 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 reactions de GET /contacts/{contact_id}/messages; la de tu cuenta viene con actor business. 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), reactions queda como estaba y se emite el evento de webhook message.reaction_failed, una vez por pedido, con el motivo en reason y el momento en que se aceptó el pedido en requested_at. Para recibirlo, suscríbete a message.reaction_failed (sección «Webhooks»).
HTTPCuándo
404El 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.
422No 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.
429rate_limited: se superó el ritmo de la sección «Envío de mensajes con clave» (ver Retry-After).

Autorización

http
headerAuthorizationBearer <clave>

Parámetros de la ruta

contact*string

Id 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*string

Id 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}$

Cuerpo del pedido

application/json
  1. body
emoji*string
Largolength <= 32

Cuerpo de la respuesta

Accepted

curl -X PUT "https://example.com/contacts/ctc_AAOzYSKDiqHT4hM8LdPB8Ut/messages/msg_As2pkZIkjmvC3nnoiFlYfDo/reaction" \  -H "Content-Type: application/json" \  -d '{    "emoji": "string"  }'
Vacío

Esto es lo que se copia para tu IA

Cargando…