Pular para o conteúdo principal
Com os webhooks do agente, o agente de IA envia uma notificação para uma URL sua quando uma condição acontece na conversa, por exemplo quando o cliente confirma um pedido ou pede um orçamento. Use para registrar o lead no seu CRM, criar uma linha em uma planilha ou disparar uma automação no Zapier, Make ou n8n. Você descreve em texto quando o webhook deve ser chamado, e o agente decide o momento durante a conversa.
Webhooks e as demais integrações são exclusivos de agentes de nível Enterprise. Se a sua assinatura tem um agente Enterprise, mude o nível do agente. Se não, fale com a equipe do blü para contratar um.

​
Configure um webhook

1

Abra as integrações do agente

Em Agentes I.A., abra o agente e clique na aba Integrações.
2

Ative a integração

No card Webhook, ative a chave e clique em Configurar.
3

Adicione o webhook

Clique em Adicionar webhook e preencha:
  • Nome: identifica o webhook para você, por exemplo “Encaminhar para CRM”.
  • URL (https://): o endereço que vai receber a notificação. Precisa começar com https://.
  • Instruções (quando chamar): quando o agente deve chamar o webhook, por exemplo “Chame quando o cliente confirmar um pedido”.
  • Cabeçalhos HTTP (opcional): clique em Adicionar cabeçalho para enviar, por exemplo, uma chave de acesso exigida pelo seu sistema.
4

Salve

Clique em Salvar. A chave ao lado do nome liga e desliga cada webhook sem apagá-lo.
Cada agente pode ter até 10 webhooks ativos.

​
Escreva boas instruções

O agente decide quando chamar o webhook a partir do texto em Instruções (quando chamar). Descreva uma situação concreta e o que precisa ter acontecido antes:
  • “Chame quando o cliente confirmar o pedido e informar o endereço de entrega.”
  • “Chame quando o cliente pedir para falar com um vendedor.”
  • “Chame depois que o cliente informar nome, e-mail e o produto de interesse.”
Evite instruções vagas, como “chame quando for importante”. Se precisar de dados específicos no seu sistema, peça nas instruções do agente que ele colete essas informações antes.

​
O que o seu sistema recebe

O blü faz um POST para a URL com um corpo JSON:
Os cabeçalhos que você cadastrou são enviados junto, além de Content-Type: application/json. Seu sistema deve responder em até 8 segundos. O agente só vê se a chamada deu certo ou não; o conteúdo da resposta não chega a ele nem ao cliente.

​
Limites e cuidados

  • A URL precisa usar https:// e ser acessível pela internet. Endereços locais ou de rede interna, como localhost ou 192.168.x.x, são ignorados.
  • O agente pode chamar o mesmo webhook mais de uma vez na mesma conversa se a situação se repetir. Trate duplicidades no seu sistema, por exemplo pelo chatNumber.
  • A simulação não chama webhooks. Para testar, use um número conectado e uma URL de teste, como a de um serviço de inspeção de requisições.
  • Não coloque senhas ou chaves nas instruções; use os Cabeçalhos HTTP.
Para enviar mensagens pelo WhatsApp a partir do seu sistema, o caminho é o inverso: veja enviar mensagens por webhook.