Skip to main content
Fluxo N8N: Webhook recebe infos da LíderHub → Set Info → Sua Integração → Enviar resposta ao Chat da LíderHub
Neste exemplo, criamos uma Custom Tool chamada LEAD CHEGOU → ENVIA PARA N8N. O agente coleta o nome e o número de WhatsApp do contato durante a conversa e dispara um webhook para o N8N com esses dados.

Prompt do agente

O trecho do prompt que aciona a Custom Tool:
Recepção: Se apresente com Olá! Sou Ana Clara, do @Nome do escritório ! Será um prazer te atender. Insira o status: @Recepção ; departamento: @Comercial ; tag: @Tráfego e pergunte pelo nome do lead: Qual é o seu nome? Depois, utilize @Salvar Nome , execute a Tool @LEAD CHEGOU → ENVIA PARA N8N , e prossiga para a etapa de qualificação.
Prompt do agente com menção @LEAD CHEGOU → ENVIA PARA N8N

Trecho do prompt com a menção à Custom Tool.

Configuração da Custom Tool

A chamada personalizada foi configurada com:
  • Nome: LEAD CHEGOU → ENVIA PARA N8N — este é o nome do @ação que vai entrar no prompt.
  • URL: endpoint webhook do N8N
  • Método: POST
  • Body da Requisição: ativo, com o JSON Schema abaixo
Tela de edição da Custom Tool: nome, URL, método POST e JSON Schema

Configuração da Custom Tool com JSON Schema definido.

O campo description de cada property é o que a IA usa para extrair o dado correto da conversa. Quanto mais claro, melhor o preenchimento.
O JSON Schema da Custom Tool é exclusivamente para descrever campos que a IA vai extrair do histórico da conversa. No exemplo acima, a IA só enviaria o WhatsApp se no prompt fosse instruída a perguntar o WhatsApp ao contato.

A conversa

Na prática, o agente pergunta o nome, coleta os dados e aciona a Custom Tool automaticamente:
Conversa na LíderHub: agente coleta nome, registra propriedades e dispara Custom Tool

O agente coleta o nome, registra as propriedades e aciona a Custom Tool durante a conversa.

Note o log de atividade na conversa: “WPB | Triagem executou a custom tool LEAD CHEGOU → ENVIA PARA N8N”.

Resposta do agente

Após a execução, o agente recebe de volta um objeto com os dados enviados, o contexto do chat e o parâmetro metadata:
  • Os campos name e whatsapp foram definidos pela IA, com base no JSON Schema. O campo whatsapp retornou null porque o prompt não mencionava a lógica para preencher o campo whatsapp - a IA só extrai dados que o prompt instrui a coletar.
  • O objeto metadata é enviado sempre em toda execução de Custom Tool. Quando o lead veio de anúncio Click-to-WhatsApp, ele inclui o ctwaClid e demais dados de atribuição da campanha. É por esse campo que você acessa o identificador do anúncio - veja para detalhes de cada propriedade.
  • Os campos dentro do objeto chat também são enviados sempre, e contêm as - status, departamento, tags, variáveis e o agente responsável. Seu webhook no N8N recebe tudo isso para processar como quiser.
Quando o lead não veio de anúncio, o objeto metadata pode vir vazio ou sem o campo ctwaClid.

Deixe uma sugestão

Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse Obtenha suporte.
Última modificação em 15 de junho de 2026