> ## Documentation Index
> Fetch the complete documentation index at: https://docs.liderhub.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Exemplo: enviar lead para N8N

> Passo a passo completo de uma Custom Tool que envia dados do lead para o N8N via webhook, incluindo prompt, configuração, JSON Schema e resposta do agente.

<Frame>
  <img src="https://mintcdn.com/liderhub/PQgbcJqhd25mZT8V/images/exemplo-custom-tool-n8n-fluxo.png?fit=max&auto=format&n=PQgbcJqhd25mZT8V&q=85&s=8a3cc34d90e2bcd2983914723ca065ad" alt="Fluxo N8N: Webhook recebe infos da LíderHub → Set Info → Sua Integração → Enviar resposta ao Chat da LíderHub" width="1024" height="341" data-path="images/exemplo-custom-tool-n8n-fluxo.png" />
</Frame>

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` <Badge color="blue">@Nome do escritório</Badge> `! Será um prazer te atender.`
>
> Insira o status: <Badge color="blue">@Recepção</Badge> ; departamento: <Badge color="blue">@Comercial</Badge> ; tag: <Badge color="blue">@Tráfego</Badge> e pergunte pelo nome do lead:
>
> `Qual é o seu nome?`
>
> Depois, utilize <Badge color="blue">@Salvar Nome</Badge> , execute a Tool <Badge color="blue">@LEAD CHEGOU → ENVIA PARA N8N</Badge> , e prossiga para a etapa de qualificação.

<Frame caption="Trecho do prompt com a menção à Custom Tool.">
  <img src="https://mintcdn.com/liderhub/PQgbcJqhd25mZT8V/images/exemplo-custom-tool-prompt.png?fit=max&auto=format&n=PQgbcJqhd25mZT8V&q=85&s=25d15e78d6f4a22670c4adcb3637ddb9" alt="Prompt do agente com menção @LEAD CHEGOU → ENVIA PARA N8N" width="1024" height="304" data-path="images/exemplo-custom-tool-prompt.png" />
</Frame>

## Configuração da Custom Tool

A chamada personalizada foi configurada com:

* **Nome:** LEAD CHEGOU → ENVIA PARA N8N — este é o nome do <Badge color="blue">@ação</Badge> que vai entrar no prompt.
* **URL:** endpoint webhook do N8N
* **Método:** POST
* **Body da Requisição:** ativo, com o JSON Schema abaixo

<Frame caption="Configuração da Custom Tool com JSON Schema definido.">
  <img src="https://mintcdn.com/liderhub/PQgbcJqhd25mZT8V/images/exemplo-custom-tool-config.png?fit=max&auto=format&n=PQgbcJqhd25mZT8V&q=85&s=f8d3fe681458b6692a384c87c4e2e781" alt="Tela de edição da Custom Tool: nome, URL, método POST e JSON Schema" width="818" height="1024" data-path="images/exemplo-custom-tool-config.png" />
</Frame>

<Accordion title="JSON Schema">
  ```json theme={null}
  {
    "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.

  <Warning>
    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.
  </Warning>
</Accordion>

## A conversa

Na prática, o agente pergunta o nome, coleta os dados e aciona a Custom Tool automaticamente:

<Frame caption="O agente coleta o nome, registra as propriedades e aciona a Custom Tool durante a conversa.">
  <img src="https://mintcdn.com/liderhub/PQgbcJqhd25mZT8V/images/exemplo-custom-tool-conversa.png?fit=max&auto=format&n=PQgbcJqhd25mZT8V&q=85&s=72b4edd1ec3e0ebbba8e108d2d3d805c" alt="Conversa na LíderHub: agente coleta nome, registra propriedades e dispara Custom Tool" width="1024" height="665" data-path="images/exemplo-custom-tool-conversa.png" />
</Frame>

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`:

```json theme={null}
{
  "name": "Jonascleison",
  "whatsapp": null,
  "metadata": {
    "title": "Escritório Exemplo - Advocacia",
    "ctwaClid": "AfjXJL_exemplo_clid_ofuscado_para_documentacao_abc123xyz",
    "mediaURL": "https://www.facebook.com/reel/0000000000000000/",
    "sourceID": "120000000000000000",
    "sourceApp": "instagram",
    "sourceURL": "https://www.instagram.com/p/ExemploPostId/",
    "sourceType": "ad",
    "clickToWhatsappCall": false
  },
  "chat": {
    "id": "7b4ced41-2d93-43f1-b24d-badf1f189e3a",
    "name": "Lead Exemplo",
    "whatsapp": "5511999999999",
    "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.
* 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 <Tooltip headline="CTWA Clid" tip="O que é o ctwa_clid e como usá-lo para otimizar campanhas na Meta." cta="Ver mais" href="/integracoes/ctwa-clid">CTWA Clid</Tooltip> para detalhes de cada propriedade.
* Os campos dentro do objeto `chat` também são enviados **sempre**, e contêm as <Tooltip headline="Propriedades da conversa" tip="Status, departamento, tags, variáveis e responsável de cada conversa." cta="Ver mais" href="/atendimento/propriedades">propriedades da conversa</Tooltip> - status, departamento, tags, variáveis e o agente responsável. Seu webhook no N8N recebe tudo isso para processar como quiser.

<Note>
  Quando o lead **não** veio de anúncio, o objeto `metadata` pode vir vazio ou sem o campo `ctwaClid`.
</Note>

## Deixe uma sugestão

<Accordion title="Feedback de Melhorias sobre Exemplo de Custom Tool">
  Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse [Obtenha suporte](/suporte/obtenha-suporte).

  <iframe src="https://tally.so/embed/682q2k?feature=Exemplo%20Custom%20Tool%20N8N&alignLeft=1&hideTitle=1&transparentBackground=1" width="100%" height="350" frameBorder="0" title="Enviar feedback de melhorias" />
</Accordion>