🔗 Como criar fluxos para campanhas com Webhooks passo a passo
Neste artigo te explicamos como configurar fluxos no Atom que se disparem mediante Webhooks. Isso te permite automatizar a execução de campanhas de WhatsApp diretamente desde sistemas externos, como seu CRM ou ERP.
🏗️ Montagem do Fluxo com Webhooks
1. Localização no Flowbuilder
Dirija-se ao menu lateral esquerdo: Campanhas > Fluxos > Criar Fluxo.
Selecione Criar Fluxo do Zero.
Escolha o número de WhatsApp a partir do qual a campanha será enviada.
Defina como disparador (Trigger) o componente Webhook.
2. Configuração do Webhook
Para que o Webhook funcione, você deve considerar o seguinte:
Campo obrigatório: O parâmetro padrão sempre será "phone".
Formato do telefone: Deve incluir o sinal
+e o código de área (ex.+573001234567) sem espaços nem hífens.Campos requeridos: São os dados indispensáveis para processar o envio com sucesso. Seu conteúdo varia conforme os campos de informação vinculados ao modelo de comunicação selecionado para o cliente.
3. Conexão com Modelos
Para enviar uma campanha, é indispensável conectar o componente Webhook com o componente Modelo.
Vá a Configurações > Mensageria > Modelos para criar um, ou use a função Criar Modelo dentro do Flowbuilder.
Se o modelo tem variáveis (campos personalizados), estas se converterão automaticamente em parâmetros obrigatórios para o Webhook.
🔗 Obtenção de Parâmetros e URL
Uma vez projetado o fluxo, você precisa dos dados para integrá-los em seu CRM ou sistema externo. Você tem duas formas de obtê-los:
Do editor (Antes de publicar): Faça duplo clique no componente Webhook e selecione "Mostrar solicitação POST". Você verá o JSON com os campos entre chaves
{}.
Do visualizador (Fluxo ativo): No módulo de Campanhas, selecione o fluxo e use a ação "Ver fluxo". Dentro do componente você encontrará:
Botão 1: Copie a URL do Webhook.
Botão 2: Copie os campos em formato JSON.
Exemplo de estrutura JSON:
JSON
{
"empresa": "Dado a enviar",
"first_name": "Dado a enviar",
"nome_agente": "Dado a enviar",
"phone": "Dado a enviar"
}
🧪 Testes com Postman
Antes de colocar a campanha em produção, simule a execução seguindo estes passos:
URL: Copie a URL do submódulo de Webhooks em Campanhas.
Headers:
Content-Type: application/json
Authorization: Bearer [Seu_Token_API] (Obtenha o token em Minha Empresa > Configuração de segurança).
Body: Selecione formato raw e insira o JSON com os dados de teste. Todos os valores devem estar entre aspas duplas.
📊 Códigos de Resposta comuns
Cenário | Código | Corpo da Resposta |
Envio satisfatório | 200 |
|
Token inexistente | 401 |
|
Token incorreto | 404 |
|
Falta parâmetro | 500 |
|
Simulação ativa | 500 |
|
🔄 Devolver dados mediante Solicitação HTTP
Se além de receber dados você deseja que o fluxo envie informações de volta para seu sistema ao finalizar:
Insira o componente Solicitação HTTP com método POST.
Insira a URL do seu sistema.
Ative o interruptor de Corpo e redija o JSON.
Use a tecla "/" (barra) para inserir dinamicamente os campos de informação capturados durante a conversa (ex. a identificação que o cliente escreveu no chat).
Se deseja mais informações revise o seguinte artigo: Componente solicitação HTTP
⚠️ Considerações Importantes
Autenticação: O uso de Webhooks requer obrigatoriamente o Token API. Se você gerar um novo, lembre-se de atualizá-lo em todas as suas integrações ativas.
Prioridade de atendimento: Se o Webhook tenta se disparar mas o cliente já tem uma conversa ativa com um consultor, a execução será suspensa automaticamente para não interferir com o atendimento humano.
¡Conecte seus sistemas e deixe que a automatização faça o resto! 🚀
Os Webhooks são a chave mestra para disparar campanhas do seu CRM de forma inteligente. Certifique-se de sempre testar suas conexões no Postman, valide que o número telefônico tenha o formato internacional correto (+ código) e mantenha em segurança seu Token API. ¡Prontos para enviar! ✅