Skip to main content
As Ferramentas Personalizadas Durante a Chamada permitem que seu assistente de IA interaja com sistemas externos durante as chamadas. Seja verificando estoque, verificando dados de clientes ou buscando informações em tempo real, essas ferramentas tornam sua IA mais poderosa e conectada.

​
Visão Geral

As Ferramentas Personalizadas Durante a Chamada permitem que seu assistente de IA:
  • Faça chamadas de API em tempo real durante 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 chamadores

Principais Benefícios

  • Nenhuma codificação necessária - basta configurar o endpoint de API e parâmetros - A IA automaticamente sabe quando e como usar as ferramentas - Acesso a dados em tempo real durante chamadas - Integração perfeita com seus sistemas existentes

​
Configurando Sua Ferramenta

​
1. Configuração Básica

Configuração Principal da Ferramenta
1

Acessar Criação de Ferramenta

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

Configurar Ajustes Principais

Preencha os detalhes essenciais:
  • Nome: Use letras minúsculas e sublinhados (ex: verificar_status_pedido)
  • Descrição: Explique quando e como a IA deve usar esta ferramenta
  • Endpoint: Sua URL de API (ex: https://api.suaempresa.com/pedidos)
  • Tempo Limite: Quanto tempo aguardar por respostas (em segundos)
  • Método: Escolha GET, POST, PUT, PATCH ou DELETE
3

Adicionar Cabeçalhos

Cabeçalhos comuns que você pode precisar:

​
2. Configuração de Variáveis

Configuração de Variáveis
1

Definir Parâmetros

Estas são as informações que sua IA coletará durante a chamada:
2

Definir Regras de Validação

Adicione requisitos de formato na descrição:

​
Entendendo os Tipos de Parâmetros

String

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

Number

Valores numéricos como valores, quantidades ou IDs

true_false

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

Ajuda de Formatação

Adicione instruções de formato nas descrições

​
Endpoints Dinâmicos

Ao usar variáveis na URL do seu endpoint, certifique-se de colocá-las entre chaves e use o nome exato do parâmetro.
Você pode tornar seus endpoints dinâmicos usando variáveis:
A IA substituirá automaticamente {id_pedido} pelo valor real coletado durante a conversa.

​
Testes Facilitados

Testes Automáticos

Clique em “Testar Ferramenta” para executar um teste com dados fictícios:
  • Parâmetros string: “test”
  • Parâmetros number: 1
  • Parâmetros booleanos: true
Você verá o código de resposta e o corpo, ajudando a verificar se tudo funciona.

​
Recurso de Usuário 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 de trabalho complexos, você pode combinar ferramentas personalizadas com nossa Plataforma de Automação. Veja 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.)
    • Termine com “Retornar Resposta”
  2. Na sua ferramenta personalizada:
    • Use a URL do webhook como seu endpoint
    • Adicione /sync no final
    • Exemplo: https://automation.suasofia.online/webhook/abc123/sync
Isso permite que você:
  • Transforme dados antes/depois de chamadas de API
  • Faça múltiplas chamadas de API em sequência
  • Aplique lógica de negócios complexa
  • Trate erros graciosamente

​
Exemplos do Mundo Real

A IA irá:
  1. Perguntar o número do pedido
  2. Buscar o status
  3. Explicar datas de entrega e status ao cliente
A IA irá:
  1. Perguntar sobre o serviço desejado
  2. Obter data preferida
  3. Mostrar horários disponíveis
A IA irá:
  1. Coletar detalhes de contato
  2. Verificar contra seu CRM
  3. Prosseguir com base no status de verificação

​
Configurando Sua IA

A IA precisa de instruções claras no prompt do sistema para usar efetivamente suas ferramentas personalizadas.
Exemplo de seção de prompt:
Teste suas ferramentas com vários fluxos de conversa para garantir que a IA lide com todos os cenários suavemente. Comece com chamadas de teste simples antes de entrar em produção.