Segundo Pedido Central de ajudaAjuda

EtapaAutomações · Integrações

Chamar Webhook

Avisa outro sistema pela internet quando o cliente passa por este ponto do fluxo. Recurso técnico: fale com a equipe antes.

Nesta página
  1. O que faz
  2. Quando usar
  3. Como configurar
  4. Exemplos
  5. Avisar o sistema do restaurante que o cliente confirmou
  6. Cuidados
  7. Dúvidas comuns

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

  1. Peça os dados ao responsável pelo outro sistema: o endereço, o método e, se houver, a chave de acesso.
  2. Ponha o bloco no caminho. Na aba Etapas, grupo Integrações, clique em Chamar Webhook. No quadro, ele aparece como Webhook.
  3. 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).
  4. Salve e teste com alguém técnico. Clique em Salvar, salve o fluxo e confira do outro lado se o aviso chegou.
CampoO que faz
Método HTTPGET, POST, PUT ou DELETE, conforme o outro sistema pedir. Em branco, o bloco usa POST, sem conteúdo.
URLObrigató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

  1. Classificar com IA
    Caminho “confirmou”.
  2. Chamar Webhook
    GET em https://exemplo.com/forno-aceso/confirmado?pedido={id_pedido}
  3. Responder WhatsApp
    Agradece 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.