Saltar para o conteúdo principal
Escolha o recurso que gerou o evento. Cada guia explica quando o evento ocorre, sua carga útil e como confirmá-lo. O Meta Business Agent usa whatsapp.echo_message.* para seus ecos de mensagem. O WhatsApp Business App usa whatsapp.smb.* para sincronização de coexistência. Use o type exato do evento para selecionar o guia correspondente. Antes de tratar eventos, configure seu endpoint de webhook, valide a assinatura e torne o processamento idempotente.

Mensagens

Processe mensagens recebidas do WhatsApp e SMS, preferências de marketing do WhatsApp e atualizações de entrega para WhatsApp, e-mail, SMS e voz.

Status da mensagem

Processe status de mensagens do WhatsApp e atualizações de entrega de e-mail, SMS e voz.

Mensagens recebidas

Analise tipos de mensagens do WhatsApp, respostas de SMS e preferências de marketing do WhatsApp.

Messenger

Use estes eventos para mensagens de texto individuais comuns, edições de texto e reações a mensagens na sua página conectada do Facebook.

Texto recebido do Messenger

Receba mensagens de texto de clientes e correlacione notificações repetidas pelo ID da mensagem.

Edições de texto recebidas do Messenger

Atualize a mesma mensagem recebida com o texto corrigido e dados cumulativos de edição.

Atualizações de mensagens do Messenger

Processe snapshots salvos de envio e recebimento, incluindo resultados desconhecidos.

Reações a mensagens do Messenger

Processe reações e cancelamentos de reações de clientes sem alterar o status de entrega da mensagem.

Meta Business Agent

Estes eventos pertencem ao Meta Business Agent integrados por meio da API REST pública. Os agentes criados pelo console usam um fluxo separado de sincronização de caixa de entrada. Consulte o guia do Meta Business Agent para obter detalhes de configuração e ciclo de vida.

Mensagem de eco criada

whatsapp.echo_message.created: armazene textos e mídias de saída de um Meta Business Agent.

Mensagem de eco atualizada

whatsapp.echo_message.updated: rastreie status de entrega, leitura e falha para mensagens do Meta Business Agent.

Transferência de controle

whatsapp.meta_business_agent.handover.updated: processe transferências de controle do Meta Business Agent.

WhatsApp Business App

Use estes exemplos para a coexistência do WhatsApp Business App: sincronize o histórico do app e as mensagens enviadas a partir do aplicativo ou de um dispositivo complementar compatível.

Histórico do Business App

whatsapp.smb.history: sincronize mensagens históricas de entrada e de saída do Business App.

Ecos de mensagens do Business App

whatsapp.smb.message.created e whatsapp.smb.message.echoes: sincronize mensagens enviadas a partir do WhatsApp Business App ou de um dispositivo complementar compatível.

Modelos e contas

Eventos de modelo

Processe análises de modelos, alterações de categoria, detecção de categoria de Envio Direto e atualizações de qualidade.

Contas e números de telefone

Processe análises, atualizações e exclusões de contas, além de exclusão de números de telefone, nomes de exibição, qualidade e nomes de usuário comerciais.

Chamadas

Conexão de chamada

Processe ofertas e respostas SDP para chamadas do WhatsApp.

Status da chamada

Processe estados de chamada chamando, atendida e rejeitada.

Encerramento e captura de chamada

Processe o encerramento de chamadas e resultados assíncronos de gravação ou transcrição.

Grupos

Ciclo de vida do grupo

Processe a criação e exclusão de grupos.

Participantes do grupo

Processe alterações de participantes e solicitações de entrada.

Configurações do grupo

Processe alterações de assunto e descrição do grupo.

Status do grupo

Processe a suspensão e o restabelecimento do grupo.

Fluxos

Status do Fluxo

Processe alterações de status do ciclo de vida do Fluxo.

Pagamentos

Atualizações de pagamento

Processe alterações em transações de pagamento do WhatsApp.

Contatos e opt-outs

Contato criado

Processe contatos e notas recém-criados.

Contato excluído

Reconcilie contatos excluídos e notas excluídas de forma independente.

Atributos do contato alterados

Processe alterações de perfil, atributos personalizados, tags e notas.

Contato cancelou a inscrição

Processe registros de cancelamento de inscrição recém-criados.

Contato reinscrito

Processe registros excluídos de cancelamento de inscrição.

Índice de eventos

Use o type exato do evento para abrir seu passo a passo. Todo tipo de evento no esquema de webhook atual possui um exemplo em uma página de recurso existente.

Catálogo completo de payloads

Todos os payloads de webhook

Encontre um evento pelo seu tipo exato e inspecione seu exemplo completo de payload.