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.
1https://cloudwhats.app.br/api/webhooks/metaO 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.
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.
1VERIFY_TOKEN=token_exibido_na_credencialLembre-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.
Testar o webhook
Salvar configuração
O Meta valida a URL automaticamente
Envie uma mensagem de teste
Valide o recebimento no inbox
Envie uma mensagem para o número conectado e confirme se ela entra no inbox, 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