Pular para o conteúdo principal
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

​
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
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "whatsapp"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Nome completo do contato"
    },
    "whatsapp": {
      "type": "string",
      "description": "Número de Whatsapp completo do contato DDI DDD Número"
    }
  }
}
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
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 e o contexto do chat: 
{
  "name": "Jonascleison",
  "whatsapp": null,
  "chat": {
    "id": "7b4ced41-2d93-43f1-b24d-badf1f189e3a",
    "name": "Caio Kaspary",
    "whatsapp": "556796764313",
    "properties": [
      { "id": "36084a47-...", "name": "Análise", "type": "status" },
      { "id": "3d0d378c-...", "name": "Comercial", "type": "department" },
      { "id": "742de2d2-...", "name": "Tráfego", "type": "tag" }
    ],
    "variables": null,
    "assign": {
      "id": "30d99c79-...",
      "name": "WPB | Triagem",
      "type": "agent"
    }
  }
}
  • 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.
  • Os campos dentro do objeto chat são enviados sempre, e contêm as propriedades da conversa — status, departamento, tags, variáveis e o agente responsável. Seu webhook no N8N recebe tudo isso para processar como quiser.

​
Deixe uma sugestão

Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse Obtenha suporte.
Last modified on March 2, 2026