logo
enes

Respuestas y reacciones

Last update: 4 days ago by Irais Aguirre

Resumen para integración

  • Endpoint: POST https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging
  • Token: de mensajería, en el encabezado Authorization: Bearer {{wa-msg-api-token}} (cómo generarlo)
  • Campos comunes: from, to (teléfono o BSUID) y type (detalle)
  • Valores de type en esta página: "text", "reaction"
  • Respuesta: la misma para todos los mensajes (ver respuesta)

Mensajes relacionados con un mensaje previo: responderlo o reaccionar a él con un emoji. Todos se envían con POST /v1/messaging; los encabezados, los campos comunes y la respuesta están en Conexión HTTP.

Responder a un mensaje

Responde a un mensaje que el cliente envió, indicando su identificador en context. El campo context puede usarse con mensajes de texto y multimedia (text, image, video, audio, document, sticker). Se ignora en location, contacts e interactive.

Cuerpo

Campos de Responder a un mensaje, además de los campos comunes:

NombreDescripciónTipoRequerimientos
contextObjeto que contiene información relacionada de un mensaje.ObjectObligatorio.

Objeto context

NombreDescripciónTipoRequerimientos
message_idId del mensaje a responder. Se admite el wamid de WhatsApp o el id interno devuelto por POST /v1/messaging. Si el id no se encuentra o se envía vacío, el context se descarta silenciosamente.StringObligatorio.

Ejemplo

Ejemplo completo de Responder a un mensaje (petición HTTP y cuerpo JSON):

Petición HTTP

curl -X POST 'https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging' \
-H 'Authorization: Bearer {{wa-msg-api-token}}' \
-H 'Content-Type: application/json' \
-d '{
    "from": "5215500000001",
    "to": "5215500000002",
    "type": "text",
    "text": "Hola, ¡buenos días! ¿En que le puedo ayudar?",
    "context":    
        {        
            "message_id": "wamid.HBgNNTIxNTUyMDc3NzA1OBUCABIYFDNBRjYyNjE2MUFGQkMxMTkxOTI0AA=="
        }
}'

Body

{
    "from": "5215500000001",
    "to": "5215500000002",
    "type": "text",
    "text": "Hola, ¡buenos días! ¿En que le puedo ayudar?",
    "context":    
        {        
            "message_id": "wamid.HBgNNTIxNTUyMDc3NzA1OBUCABIYFDNBRjYyNjE2MUFGQkMxMTkxOTI0AA=="
        }
}

Reacción

Reacciona con un emoji a un mensaje. El campo type debe ser "reaction".

Cuerpo

Campos de Reacción, además de los campos comunes:

NombreDescripciónTipoRequerimientos
reactionObjeto que contiene información relacionada de un mensaje.ObjectObligatorio.

Objeto reaction

NombreDescripciónTipoRequerimientos
message_idId del mensaje a reaccionar. Se admite el wamid de WhatsApp o el id interno devuelto por POST /v1/messaging. Si el id no se encuentra, la reacción retorna MISSING_PARAMS.StringObligatorio.
emojiEmoticón a enviar.StringObligatorio.

Ejemplo

Ejemplo completo de Reacción (petición HTTP y cuerpo JSON):

Petición HTTP

curl -X POST 'https://{{url}}/whatsapp-bsp-api-endpoint-ws/services/v1/messaging' \
-H 'Authorization: Bearer {{wa-msg-api-token}}' \
-H 'Content-Type: application/json' \
-d '{
    "from": "5215500000001",
    "to": "5215500000002",
    "type": "reaction",
    "reaction":  
        {        
            "message_id": "wamid.HBgNNTIxNTUyMDc3NzA1OBUCABIYFDNBRjYyNjE2MUFGQkMxMTkxOTI0AA==",
            "emoji": "👍🏻"
        }
}'

Body

{
    "from": "5215500000001",
    "to": "5215500000002",
    "type": "reaction",
    "reaction":  
        {        
            "message_id": "wamid.HBgNNTIxNTUyMDc3NzA1OBUCABIYFDNBRjYyNjE2MUFGQkMxMTkxOTI0AA==",
            "emoji": "👍🏻"
        }
}

Anterior
Contactos
Siguiente
Solicitud de permiso de llamada