Mensaje de eco de Meta Business Agent creado

​

Qué es

​

Antes de comenzar

1. Integra el Agent a través de la Public REST API.
2. Suscribe un endpoint de webhook activo en la misma cuenta a whatsapp.echo_message.created.
3. Verifica YCloud-Signature con el cuerpo sin procesar de la solicitud, acepta cada evento de forma duradera y procésalo de manera idempotente.

​

Cómo funciona

• Usa id o wamid para correlacionar eventos de estado posteriores.
• Lee el texto de text.body. Para archivos multimedia, inspecciona type y el objeto de contenido correspondiente. Los ID de multimedia no son URL públicas de descarga.
• El teléfono del cliente y el BSUID son independientes. Cuando la devolución de llamada de origen proporciona ambos, el evento incluye to junto con recipientUserId o parentRecipientUserId. Las identidades faltantes se omiten y no se deducen entre sí.
• from es el número de teléfono visible de la empresa cuando la devolución de llamada de origen proporciona un número de teléfono válido. No se deriva de phoneNumberId.
• El contexto de respuesta se normaliza según el contrato de mensaje estándar. Por ejemplo, el context.id de origen se expone como context.message_id.
• No se incluyen campos de Agent, transferencia (handover), enrutamiento, precios ni conversaciones.
• status es el estado almacenado cuando se procesa el eco; no se garantiza que sea sent.
• Los mensajes entrantes de clientes utilizan whatsapp.inbound_message.received. Los ecos de Business App utilizan whatsapp.smb.message.echoes.

​

Solicitud

​

Respuesta

​

Eco de texto saliente

​

Solicitud

{
  "id": "evt_example_echo_text",
  "type": "whatsapp.echo_message.created",
  "apiVersion": "v2",
  "createTime": "2026-09-09T02:00:00.000Z",
  "whatsappMessage": {
    "id": "MESSAGE_ID",
    "wamid": "wamid.EXAMPLE",
    "wabaId": "WABA_ID",
    "from": "+12025550123",
    "to": "+12025550124",
    "recipientUserId": "GB.898232076600896",
    "type": "text",
    "text": {
      "body": "Hello! How can I help you?"
    },
    "status": "sent",
    "createTime": "2026-09-09T02:00:00.000Z",
    "sendTime": "2026-09-09T02:00:00.000Z"
  }
}

​

Respuesta

HTTP/1.1 200 OK

​

Explicación

​

Eco de imagen saliente

​

Solicitud

{
  "id": "evt_example_echo_image",
  "type": "whatsapp.echo_message.created",
  "apiVersion": "v2",
  "createTime": "2026-09-09T02:00:00.000Z",
  "whatsappMessage": {
    "id": "IMAGE_MESSAGE_ID",
    "wamid": "wamid.IMAGE_EXAMPLE",
    "wabaId": "WABA_ID",
    "from": "+12025550123",
    "to": "+12025550124",
    "recipientUserId": "GB.898232076600896",
    "type": "image",
    "image": {
      "id": "MEDIA_ID",
      "mime_type": "image/jpeg"
    },
    "status": "sent",
    "createTime": "2026-09-09T02:00:00.000Z",
    "sendTime": "2026-09-09T02:00:00.000Z"
  }
}

​

Respuesta

HTTP/1.1 200 OK

​

Explicación

​

Ejemplos relacionados

• Mensaje de eco de WhatsApp actualizado
• Transferencia de WhatsApp Agent actualizada
• Ejemplos de eco y transferencia de Agent
• Catálogo completo de cargas útiles