Exemplos de Webhook do WhatsApp Flow

​

O que é

​

Antes de começar

• Crie um endpoint HTTPS público na sua aplicação.
• Configure um endpoint de webhook da YCloud para os tipos de eventos necessários.
• Armazene o segredo de assinatura do endpoint com segurança.
• Torne o processamento de eventos idempotente.

​

Como funciona

​

Requisição

​

Resposta

HTTP/1.1 200 OK

​

Alteração de Status do Flow

​

Requisição

{
  "type": "whatsapp.flow.status_change",
  "id": "evt_1234567890abcdef",
  "apiVersion": "v2",
  "createTime": "2025-09-11T07:24:52.000Z",
  "flowChanges": {
    "flowId": "1097420589034000",
    "wabaId": "123456789012345",
    "message": "Flow Webhook 3 changed status from DRAFT to PUBLISHED",
    "oldStatus": "DRAFT",
    "newStatus": "PUBLISHED"
  }
}

​

Resposta

HTTP/1.1 200 OK

​

Explicação

• type: Sempre whatsapp.flow.status_change para eventos de alteração de status de flow
• flowChanges: Contém os detalhes da alteração de status do flow
  • flowId: O ID exclusivo do Flow cujo status foi alterado
  • wabaId: ID da conta do WhatsApp Business associada ao flow
  • message: Descrição legível por humanos da alteração de status
  • oldStatus: O status anterior do flow
  • newStatus: O status atual do flow

​

Valores Comuns de Status do Flow

• DRAFT
• PUBLISHED
• DEPRECATED
• BLOCKED
• THROTTLED