📥 Webhooks de Entrada¶
📤 Procurando o contrário?
Pra o Atende Ágil avisar o seu sistema quando algo acontece, veja Webhooks de Saída.
Webhooks de Entrada deixam outro sistema seu (site, formulário, planilha, e-commerce) avisar o Atende Ágil automaticamente quando algo acontece, sem precisar de ninguém copiando e colando dados manualmente. 🔄
🧠 Como funciona¶
- Crie um webhook na aba Integrações → Webhooks de Entrada e copie a URL única gerada.
- Mapeie os campos: no mínimo o campo telefone é obrigatório (ele diz ao sistema qual campo do JSON recebido traz o número do contato), sem esse campo preenchido no payload recebido, o evento é ignorado silenciosamente (a chamada responde OK mesmo assim, só não gera nenhuma ação). Dá pra mapear campos extras (nome, e outros que você nomear) pra usar como variável na mensagem.
- Escolha a ação que esse webhook dispara ao receber um evento, só uma das três:
- Enviar Mensagem (padrão): coloca um texto na fila de envio pro contato, com variáveis do payload recebido.
- Acionar um Fluxo: dispara um Fluxo do Flow Builder já criado, começando do bloco inicial (zera qualquer estado de fluxo anterior desse contato antes de começar).
- Enviar Template: manda um template aprovado da API Oficial, só funciona se o workspace estiver conectado pela API Oficial, senão o evento é ignorado.
- Configure a URL única no sistema externo (ex: "quando alguém preencher esse formulário, chame essa URL").
🎯 Casos de uso comuns¶
- Formulário do site dispara uma mensagem ou Fluxo de boas-vindas pro número informado.
- Pedido de e-commerce dispara um Fluxo de confirmação/acompanhamento.
- Planilha ou CRM externo dispara mensagens automáticas sem precisar copiar/colar manualmente.
📇 O contato precisa já existir?
O webhook resolve o telefone recebido pro contato correspondente quando ele já existe na sua base (inclusive testando a variação com/sem o 9º dígito). Pra números totalmente novos, o comportamento pode variar conforme a ação escolhida, se seu caso é justamente cadastrar leads novos vindos de um formulário, teste o cenário real antes de confiar 100% nisso, ou fale com o suporte técnico pra confirmar.
🔒 URL é sensível
Qualquer sistema que souber a URL do webhook consegue mandar dados pra dentro do seu workspace. Trate a URL como uma senha, não publique ela em lugar aberto.
🛠️ Pra desenvolvedores¶
Tecnicamente, cada webhook é um endpoint POST /api/hook/:token, onde o token identifica o webhook e o workspace de destino. O corpo da requisição aceita um JSON com os dados do contato (nome, telefone, e demais campos configuráveis). Fale com o suporte técnico se precisar do formato exato do payload pro seu caso.