Configurar Webhook

O webhook é o canal que permite ao CloudWhats receber mensagens, status de entrega e eventos do WhatsApp em tempo real. No CloudWhats, a URL do webhook é sempre da própria plataforma. O que muda é apenas a forma de vincular a sua conta Meta a esse endpoint: pelo Embedded Signup, com configuração automática, ou pela configuração manual da credencial. Em ambos os casos, a operação continua no modelo BYOC — a conta e os ativos da Meta continuam sendo seus.

Requisitos

Pelo menos uma credencial WhatsApp válida no CloudWhats
Conta Meta conectada via modal ou credencial manual com dados da API Cloud
Acesso ao Meta for Developers apenas se for concluir a configuração manualmente

Na maioria dos casos, o usuário não configura isso manualmente

Quando você conecta a conta pelo modal da Meta (Embedded Signup), o CloudWhats configura automaticamente o webhook, o número e os vínculos principais da integração.

URL e token usados pelo CloudWhats

Se você estiver no fluxo manual, use a URL pública da aplicação configurada no CloudWhats junto com o Verify Token exibido na página de credenciais. São esses dados que devem ser informados no app da Meta.

URL do Webhook

1https://cloudwhats.app.br/api/webhooks/meta

O endpoint é do próprio CloudWhats. Você não precisa publicar um endpoint seu para receber mensagens do WhatsApp, a menos que esteja construindo integrações complementares com webhooks de saída da plataforma.

Como funciona na prática

Conexão via modal da Meta (recomendado)

Fluxo automático no CloudWhats

Ao conectar sua conta em Configurações → Credenciaispelo modal da Meta, o CloudWhats recebe a autorização, vincula o número, configura o webhook e conclui a maior parte do setup automaticamente. Esse fluxo continua sendo BYOC: a diferença é que o onboarding é guiado e com menos etapas manuais.

Nesse fluxo, você normalmente não precisa abrir a configuração de Webhooks no Meta manualmente.

Configuração manual (quando aplicável)

Use a URL e o token exibidos pelo CloudWhats

Se você criou a credencial manualmente, acesse o app no Meta for Developers, vá em WhatsApp → Configuration → Webhooks e informe a URL do webhook do CloudWhats junto com o Verify Token mostrado na credencial.

Verify Token

1VERIFY_TOKEN=token_exibido_na_credencial

Lembre-se de que o webhook é configurado por App na Meta. Se mais de um número usar o mesmo app, eles compartilham a mesma configuração de callback.

Conclua a assinatura dos eventos

Mensagens e status da Cloud API

Após validar a URL, assine os eventos de mensagens e status para que o CloudWhats receba atualizações em tempo real da sua conta WhatsApp.

Abrir Meta for Developers

Testar o webhook

Salvar configuração

O Meta valida a URL automaticamente

Webhook validado com sucesso.

Envie uma mensagem de teste

Valide o recebimento na caixa de entrada

Envie uma mensagem para o número conectado e confirme se ela entra na caixa de entrada, se atualiza o status corretamente e se a conversa aparece no canal esperado.

Sem retorno?

Se a conexão foi feita pelo modal e mesmo assim você não recebe eventos, revise a credencial, a conexão com a Meta e os logs da integração. No fluxo manual, confirme URL, Verify Token e assinatura dos eventos.

Boas práticas

Prefira o Embedded Signup quando disponível para reduzir erro humano, mesmo em operação BYOC
Use a configuração manual quando precisar controlar cada etapa diretamente no seu app da Meta
Se alterar credenciais manualmente, revise URL, token e eventos assinados

Próximos passos

Automações

Reaja aos eventos recebidos

Visão geral de credenciais

Entenda o fluxo BYOC, modal da Meta e gestão das conexões