Aprenda como criar e configurar integrações personalizadas de API que seu assistente de IA pode usar durante as chamadas #

As Ferramentas Personalizadas Durante a Chamada permitem que seu assistente de IA interaja com sistemas externos durante as chamadas. Seja para verificar o estoque, confirmar dados do cliente ou buscar informações em tempo real, essas ferramentas tornam seu assistente mais poderoso e conectado.

​Visão Geral #

As Ferramentas Personalizadas Durante a Chamada permitem que seu assistente de IA:

• Faça chamadas de API em tempo real durante as conversas
• Busque ou inveja dados para seus sistemas
• Tome decisões informadas com base em dados ao vivo
• Forneça informações precisas e atualizadas aos clientes

Principais benefícios #

• Não é necessário programar — basta configurar o endpoint da API e os parâmetros.
  O assistente de IA sabe automaticamente quando é como usar as ferramentas.
  • Acesso a dados em tempo real durante as chamadas
  • Integração perfeita com seus sistemas existentesConfigurando sua ferramenta

​1. Configuração Básica #

Acessar Criação de Ferramenta

Navegue até Ferramentas Durante a Chamada e clique em Criar Ferramenta Durante a ChamadaPreencha os detalhes essenciais:2

Configurar Configurações Principais

• Nome: Use letras minúsculas e sublinhados (ex.: check_order_status)
• Descrição: Explique quando e como a IA deve usar esta ferramenta
• Endpoint: URL da sua API (ex.: https://api.suaempresa.com/pedidos)
• Timeout: Tempo de espera pela resposta (em segundos)
• Método: Escolha entre GET, POST, PUT, PATCHouDELETE

3

Adicionar cabeçalhos

Cabeçalhos comuns que você pode precisar:

Content-Type: application/json
Authorization: Bearer your_token

​2. Configurações Variáveis #

efina Parâmetros

Estas são as informações que seu assistente de IA irá coletar durante a chamada:

Name: order_number
Type: string
Description: "10-digit order number from the customer"

2

Definir Regras de Validação

Adicione os formatos necessários na descrição

"Date in dd/mm/yyyy format"
"Phone number without spaces"
"Email address for confirmation"

​Entendendo os Tipos de Parâmetros #

Texto #

Valores de texto, como nomes, endereços ou números de referência

Type: string
Examples: "John Doe", "123 Main St"

Número #

Valores numéricos, como quantidades, quantidades ou IDs

Type: number
Examples: 42, 99.99

Verdadeiro_Falso #

Valores booleanos para situações de sim/não

Type: true_false
Examples: true, false

Ajuda de formatação #

Adicione instruções de formatação nas específicas

"Date in dd/mm/yyyy"
"Phone without spaces"

​Endpoints Dinâmicos #

Ao usar variáveis ​​na URL do endpoint, certifique-se de colocar as chaves entre as chaves {}e usar exatamente o nome do parâmetro.Você pode tornar seus endpoints dinâmicos usando variáveis:

Basic URL:
https://api.example.com/orders/status

With Variables:
https://api.example.com/orders/{order_id}/status

A IA substituirá automaticamente {order_id}pelo valor real coletado durante uma conversa.

​Testar ficou fácil #

Teste Facilitado #

Clique em “Testar Ferramenta” para executar um teste com dados fictícios:

• Parâmetros do tipo texto: "teste"
• Parâmetros numéricos: 1
• Parâmetros booleanos: true

Você verá o código de resposta e o corpo da resposta , ajudando a verificar se tudo está funcionando corretamente.

​Recurso Avançado: Integração com Plataforma de Automação #

Precisa de lógica mais complexa? Conecte sua ferramenta à plataforma de automação para fluxos de trabalho avançados.Para integrações avançadas e fluxos complexos, você pode combinar ferramentas personalizadas com nossa Plataforma de Automação.Como criar integrações poderosas:

​1. Na plataforma de automação: #

• Crie um novo fluxo
• Adicione um gatilho de webhook
• Construa sua lógica (chamadas de API, transformação de dados, etc.)
• Finalizar com “Retorno de Resposta”

​2. Na sua ferramenta personalizada: #

• Use uma URL para o webhook como endpoint.
• gia /syncao final
• Exemplo:https://automation.gloena.com/webhook/abc123/sync

​3. Isso permite que você: #

• Transformar dados antes/depois das chamadas de API
• Faça várias chamadas de API em sequência
• Aplique lógica de negócios complexos
• Trate erros de forma

​Exemplos no Mundo #

Sistema de Consulta de Pedidos

Name: check_order
Endpoint: https://api.yourshop.com/orders/{order_number}
Parameters:
  - Name: order_number
    Type: string
    Description: "Order reference (format: ORD-XXXXX)"

A IA irá:

• Solicitar o número do pedido
• Buscar o status
• Explicar as datas de entrega e o status para o cliente

Disponibilidade de Compromissos

Name: check_slots
Endpoint: https://api.calendar.com/availability
Parameters:
  - Name: service
    Type: string
    Description: "Service type (haircut, massage, consultation)"
  - Name: date
    Type: string
    Description: "Preferred date (dd/mm/yyyy)"

A IA irá:

• Pergunte sobre o serviço desejado
• Obter dados preferidos
• Ver os horários disponíveis

Verificação de Cliente

Name: verify_customer
Endpoint: https://api.crm.com/verify
Parameters:
  - Name: phone
    Type: string
    Description: "10-digit phone number"
  - Name: email
    Type: string
    Description: "Email address for verification"

A IA irá:

• Coletar os dados de contato
• Verificar no seu CRM
• Prosseguir com base sem status de verificação

​Configurando sua IA #

A IA precisa de instruções claras em seu sistema para usar suas ferramentas personalizadas de forma eficaz.Exemplo de seção de prompt:

**Quando usar a ferramenta `check_order`:**

1. O cliente pergunta sobre o status do pedido
2. Menciona rastreamento ou entrega
3. Quer saber onde está a encomenda

**Como usá-la:**

1. Solicite o número do pedido se não for fornecido
2. Verifique o formato (ORD-XXXXX)
3. Use a ferramenta para buscar o status
4. Explique os resultados de forma simples

Teste suas ferramentas com diferentes fluxos de conversa para garantir que a IA lide com todos os cenários de forma fluida. Comece com chamadas de teste simples antes de ir ao vivo.