Custom Tools

Visão geral

Além das integrações nativas (ZapSign, Google Calendar, ADVBox), a LíderHub permite criar integrações personalizadas usando Custom Tools. Com elas, seus agentes de IA podem se conectar a qualquer serviço externo — enviando informações ou recebendo informações.

Toda Custom Tool adicionada é um novo @ação personalizado que você pode usar no meio do prompt. É assim que os agentes de IA da LíderHub podem enviar informações (disparar webhooks) ou receber informações a qualquer momento da conversa.

As Custom Tools permitem criar menções personalizadas no prompt que acionam APIs externas. Para configurá-las:

Acesse Integrações e Custom Tool

Acesse Configurações > Integrações e clique em Custom Tool.

Tela Integrações na LíderHub: Configurações, Integrações e card Custom Tool — Configurações (1) > Integrações (2) > Custom Tool (3)

Clique em Nova chamada personalizada

Clique em Nova Chamada Personalizada para criar sua primeira Custom Tool.

Tela Custom Tools: nenhuma chamada criada, botão Nova Chamada Personalizada — Nova Chamada Personalizada (4)

Configure sua chamada personalizada

Preencha o formulário e use Criar Chamada ao final.

Formulário Nova Chamada: nome, URL, método, headers, body e JSON Schema

(5) Nome da chamada: Este é o nome do @ação — o identificador que você usará no prompt.
(6) URL do endpoint: URL da API que será chamada.
(7) Tipo de requisição: GET, POST, PUT ou DELETE.
(8) Body da requisição: Marque o toggle como ativo se quiser enviar um body na requisição.
(9) JSON Schema: Defina o body da requisição. Use variáveis entre chaves duplas (ex: {{cpf}}, {{nome}}) para preencher com dados da conversa:

Utilize outras IAs (inclusive a IA desta documentação, chat à direita) para gerar um JSON Schema para você. O campo description de cada property é utilizado pela IA para extrair o conteúdo da conversa na LíderHub — defina bem esse valor.

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Nome completo"
    },
    "email": {
      "type": "string",
      "format": "CPF",
      "description": "CPF do Lead"
    }
  }
}

(10) Criar Chamada: Clique em Criar Chamada para salvar. A nova menção ficará disponível no prompt dos agentes.

Aplicações interessantes

Alguns exemplos de Custom Tools que você pode criar: cada accordion mostra o input (JSON Schema enviado à API) e o output (resposta que o agente devolve na conversa).

Caso 1: Cálculo de juros complexos

Input (JSON Schema) — valor inicial, taxa de juros e período em meses:

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": ["valorInicial", "taxaJuros", "periodoMeses"],
  "properties": {
    "valorInicial": { "type": "number", "description": "Valor inicial em reais" },
    "taxaJuros": { "type": "number", "description": "Taxa de juros mensal (ex: 0,01 para 1%)" },
    "periodoMeses": { "type": "integer", "description": "Período em meses" }
  }
}

Output (resposta do agente):

{ "valorFuturo": 1261.36 }

Exemplo na conversa: “Com R 1.261,36.”

Caso 2: Criar novo contato em plataforma externa

Input (JSON Schema) — nome, e-mail e CPF:

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": ["nome", "email", "cpf"],
  "properties": {
    "nome": { "type": "string", "description": "Nome completo do contato" },
    "email": { "type": "string", "format": "email", "description": "E-mail" },
    "cpf": { "type": "string", "description": "CPF do lead" }
  }
}

Output (resposta do agente):

{ "linkAcesso": "https://plataforma.exemplo.com/acesso/abc123" }

Exemplo na conversa: “Contato criado. Link para acesso: https://plataforma.exemplo.com/acesso/abc123”

Caso 3: Consultar endereço pelo CEP

Input (JSON Schema) — CEP:

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": ["cep"],
  "properties": {
    "cep": { "type": "string", "description": "CEP (apenas números ou com hífen)" }
  }
}

Output (resposta do agente):

{
  "logradouro": "Rua das Flores",
  "bairro": "Centro",
  "cidade": "São Paulo",
  "uf": "SP",
  "cep": "01234-567"
}

Exemplo na conversa: “O CEP 01234-567 corresponde a Rua das Flores, Centro, São Paulo - SP.”

Exemplo prático

Fluxo N8N: Webhook recebe infos da LíderHub → Set Info → Sua Integração → Enviar resposta ao Chat da LíderHub

Exemplo: enviar lead para N8N

Veja um caso real completo — prompt, configuração, JSON Schema, conversa e resposta do agente.

CTWA Clid

Capture a atribuição de anúncios Click-to-WhatsApp via metadata nas Custom Tools.

Usar no prompt

Depois de criar sua chamada personalizada, use-a no prompt dos agentes via menções: o nome configurado vira um @ação que a IA pode acionar durante a conversa.

Formulário Nova Chamada: usar a menção no prompt dos agentes

Menções (@)

Lista completa de menções: status, template, responsável, Custom Tools e mais para usar no prompt.

Deixe uma sugestão

Feedback de Melhorias sobre Integrações personalizadas

Agradecemos muito pelo seu tempo! Se você precisa de suporte, acesse Obtenha suporte.

Dúvidas Frequentes

Preciso saber programar para criar Custom Tools?

É necessário conhecimento básico de APIs (URL, método, headers). Se não tiver, peça ajuda ao suporte.

Posso integrar com Zapier ou n8n?

Sim. Use webhooks para conectar a LíderHub com Zapier, n8n, Make ou qualquer ferramenta que aceite webhooks.

Introdução

WhatsApp

Acessos

Dados

Agentes de IA

Atendimento

Templates (Mensagem rápida)

Integrações

Planos e Preços

Geral

Custom Tools

Visão geral

Custom Tools

Aplicações interessantes

Exemplo prático

Usar no prompt

Deixe uma sugestão

Dúvidas Frequentes

​Visão geral

​Custom Tools

​Aplicações interessantes

​Exemplo prático

​Usar no prompt

​Deixe uma sugestão

​Dúvidas Frequentes

Visão geral

Custom Tools

Aplicações interessantes

Exemplo prático

Usar no prompt

Deixe uma sugestão

Dúvidas Frequentes