O que faz
Avisa outro sistema, pela internet, que o cliente passou por este ponto do fluxo. O bloco chama um endereço (a URL) que o outro sistema fornece, espera a resposta por alguns segundos e segue para a próxima etapa. O cliente não recebe nada.
É um recurso técnico, para quem tem um sistema próprio e alguém que cuida dele. Antes de usar, fale com a nossa equipe.
Quando usar
- Para avisar o sistema do restaurante que o cliente confirmou o pedido.
- Para registrar numa ferramenta externa quem respondeu uma campanha.
Como configurar
- Peça os dados ao responsável pelo outro sistema: o endereço, o método e, se houver, a chave de acesso.
- Ponha o bloco no caminho. Na aba Etapas, grupo Integrações, clique em Chamar Webhook. No quadro, ele aparece como Webhook.
- Preencha o painel. Clique no bloco para abrir Configurar Webhook. Escolha o Método HTTP (num bloco novo ele começa em branco), cole a URL e, se o outro sistema pedir, os Headers (JSON).
- Salve e teste com alguém técnico. Clique em Salvar, salve o fluxo e confira do outro lado se o aviso chegou.
| Campo | O que faz |
|---|---|
| Método HTTP | GET, POST, PUT ou DELETE, conforme o outro sistema pedir. Em branco, o bloco usa POST, sem conteúdo. |
| URL | Obrigatória. O endereço chamado. Aceita variáveis, que são trocadas pelos dados do cliente no momento da chamada. |
| Headers (JSON) | Informações extras que o outro sistema pode exigir, como uma chave de acesso, no formato que ele indicar. O painel só salva se o formato estiver certo. |
| Body (JSON) | Só aparece com POST e PUT. O conteúdo da chamada. Veja Cuidados antes de usar. |
| Variável de Saída (opcional) | Um nome para guardar a resposta do outro sistema. É para uso técnico: a resposta não serve para pôr numa mensagem ao cliente. |
| Timeout (segundos) | Quanto tempo esperar a resposta, de 1 a 30 segundos. Padrão: 10. |
Exemplos
Avisar o sistema do restaurante que o cliente confirmou
- Classificar com IACaminho “confirmou”.
- Chamar WebhookGET em https://exemplo.com/forno-aceso/confirmado?pedido={id_pedido}
- Responder WhatsAppAgradece a cliente.
Cuidados
- Só códigos no endereço. Variáveis como
{id_pedido}funcionam bem na URL. Nomes com espaço ou acento, e textos livres, podem quebrar o endereço. - Sem resposta, o fluxo para. Se o outro sistema não responder no tempo, ou se o endereço não puder ser alcançado, o bloco tenta mais duas vezes, depois de 30 segundos e de 2 minutos. Na última falha, o fluxo para para aquele cliente, e as etapas seguintes não acontecem. Por isso, deixe o webhook depois das mensagens importantes.
- Resposta de erro não para o fluxo. Se o outro sistema responder com erro (recusou a chamada, por exemplo), o fluxo segue como se tivesse dado certo. Confira do outro lado se o aviso chegou.
- Cuidado com chaves de acesso. O que estiver nos headers fica visível para quem abre o fluxo na sua conta.
- Dados do cliente saem da plataforma. Mande para o outro sistema só o que ele precisa.
Dúvidas comuns
O webhook do bloco é o mesmo da tela Integração?
Não. A Integração é o caminho contrário: o endereço por onde o sistema do restaurante manda os pedidos para o Segundo Pedido. Este bloco é o Segundo Pedido chamando outro sistema.
Dá para testar sem chamar o outro sistema?
No Testar Workflow, o bloco aparece como uma chamada simulada, com o endereço já com as variáveis trocadas, e nada é chamado. Para ver a chamada chegar, só com o fluxo ativo.