Mensagem de eco do Meta Business Agent criada

​

O que é

​

Antes de começar

1. Faça a integração do agente por meio da Public REST API.
2. Inscreva um endpoint de webhook ativo na mesma conta em whatsapp.echo_message.created.
3. Verifique o YCloud-Signature em relação ao corpo bruto da requisição, aceite cada evento de forma duradoura e processe-o de maneira idempotente.

​

Como funciona

• Use id ou wamid para correlacionar eventos de status posteriores.
• Leia o texto de text.body. Para mídia, inspecione type e o objeto de conteúdo correspondente. Os IDs de mídia não são URLs públicas de download.
• O telefone do cliente e o BSUID são independentes. Quando o callback de origem fornece ambos, o evento inclui to junto com recipientUserId ou parentRecipientUserId. Identidades ausentes são omitidas e não são inferidas umas das outras.
• from é o número de telefone de exibição da empresa quando o callback de origem fornece um número de telefone válido. Ele não é derivado de phoneNumberId.
• O contexto de resposta é normalizado para o contrato padrão de mensagem. Por exemplo, a origem context.id é exposta como context.message_id.
• Campos de agente, handover, roteamento, preços e conversa não são incluídos.
• status é o status armazenado quando o eco é processado; não há garantia de que seja sent.
• Mensagens de entrada de clientes usam whatsapp.inbound_message.received. Ecos do aplicativo comercial usam whatsapp.smb.message.echoes.

​

Requisição

​

Resposta

​

Eco de texto de saída

​

Requisição

{
  "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"
  }
}

​

Resposta

HTTP/1.1 200 OK

​

Explicação

​

Eco de imagem de saída

​

Requisição

{
  "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"
  }
}

​

Resposta

HTTP/1.1 200 OK

​

Explicação

​

Exemplos relacionados

• Mensagem de eco do WhatsApp atualizada
• Handover de agente do WhatsApp atualizado
• Exemplos de eco e handover de agente
• Catálogo completo de payloads