Ferramentas Personalizadas Durante a Chamada

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 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 envie 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 e como usar as ferramentas.
  • Acesso a dados em tempo real durante as chamadas
  • Integração perfeita com seus sistemas existentesSetting Up Your Tool

1. Configuraçao Básica

1. Acessar Criação de Ferramenta

   Navegue até Ferramentas Durante a Chamada e clique em Criar Ferramenta Durante a Chamada

   Preencha os detalhes essenciais:

2. Configurar Configurações Principais

   • Nome: Use letras minúsculas e underscores (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, PATCH ou DELETE
3. Add Headers

   Headers comuns que você pode precisar:

   Content-Type: application/json
   Authorization: Bearer your_token
   

2. Configurações Variáveis

1. Defina 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 formatos requeridos 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 quantias, 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 descrições

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

Endpoints Dinâmicos

Ao usar variáveis na URL do endpoint, certifique-se de colocá‑las entre 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 a conversa.

Testing Made Easy

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.)
• Finalize com “Return Response”

---

2. Na sua ferramenta personalizada:

• Use a URL do webhook como endpoint
• Adicione /sync ao final
• Exemplo: https://automation.mayahub.ai/webhook/abc123/sync

---

3. Isso permite que você:

• Transforme dados antes/depois das chamadas de API
• Faça múltiplas chamadas de API em sequência
• Aplique lógica de negócios complexa
• Trate erros de forma adequada

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

• Perguntar sobre o serviço desejado
• Obter a data preferida
• Mostrar 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 no status da verificação

Configurando sua IA

A IA precisa de instruções claras em seu system prompt 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.