Expanda as capacidades dos seus agentes com ferramentas personalizadas
As Tools (Ferramentas) expandem as capacidades dos seus agentes durante as conversas. Com elas, seu agente pode consultar APIs, transferir para humanos ou encerrar chamadas de forma controlada.
Se o endpoint exige autenticação, configure o tipo adequado na seção Autenticação do formulário:
Tipo
Campos
Descrição
Nenhuma
—
Endpoint público, sem autenticação
Bearer Token
Token
Envia o header Authorization: Bearer <token>
Basic Auth
Usuário, Senha
Envia o header Authorization: Basic <base64>
API Key
Nome do Header, Chave
Envia a chave em um header customizado (padrão: X-API-Key)
As credenciais são armazenadas de forma segura e nunca são expostas na URL. Use sempre a seção de Autenticação em vez de colocar tokens diretamente nos Headers.
Os campos Query Params Schema e Body Schema definem quais dados o agente deve coletar do cliente para enviar na requisição. Para cada parâmetro, você configura:
Nome: identificador do parâmetro (ex: cep, pedido_id)
Tipo: string, number, integer, boolean, object ou array
Descrição: explica ao agente o que é este campo
Obrigatório: se o agente deve obrigatoriamente coletar este dado
Você pode usar o editor visual para adicionar campos um a um, ou alternar para o modo JSON para colar o esquema diretamente.
Antes de vincular a Tool a um agente, use o botão Testar Endpoint para validar a configuração. Se o endpoint possui parâmetros, um modal pedirá que você preencha valores de teste. O resultado mostra o status HTTP, tempo de resposta, corpo da resposta e headers retornados.
Transfere a chamada para um atendente humano via SIP. Quando o agente aciona essa Tool, o cliente é redirecionado para o número ou ramal de destino configurado.Exemplos de uso:
O campo Número de Destino aceita diferentes formatos dependendo do seu cenário:
Formato
Exemplo
Quando usar
E.164
+5511999999999
Números de telefone convencionais (PSTN)
SIP URI (Twilio)
sip:+5511999999999@seu-trunk.pstn.twilio.com
Transferência via trunk Twilio
SIP URI (outro provedor)
sip:+5511999999999@sip.seuprovedor.com
Conforme documentação do seu trunk SIP
SIP URI (Ramal)
sip:ramal100@pbx.empresa.com
Transferência para ramal interno
A transferência usará automaticamente o mesmo SIP trunk da chamada em andamento.
A transferência via Handoff funciona apenas em chamadas telefônicas reais (recebidas ou feitas via SIP). Ela não funciona no Playground, que utiliza WebRTC. Para testar o Handoff, faça uma ligação telefônica real para o número vinculado ao agente.Além disso, o SIP REFER deve estar habilitado no seu provedor SIP para que a transferência funcione. Consulte a documentação de SIP Trunks.
Permite encerrar chamadas de forma controlada. Essa Tool funciona de duas maneiras complementares:
Encerramento pela IA — O agente decide encerrar a chamada com base nos contextos que você definir (ex: quando o assunto está resolvido, quando o usuário foge do escopo).
Encerramento por inatividade — A chamada é encerrada automaticamente se o usuário ficar em silêncio por um tempo configurado.
Em ambos os casos, o agente fala a mensagem de despedida antes de desligar.Exemplos de uso:
Encerrar quando o atendimento está concluído
Desligar se o usuário ficar em silêncio (ex: esqueceu de desligar)
Encerrar quando o usuário foge completamente do escopo
Quando habilitado, um timer conta o tempo de silêncio do usuário. O timer:
Reseta cada vez que o usuário fala
Pausa enquanto o agente está falando ou pensando
Conta apenas quando o agente está aguardando resposta do usuário
Se o timer atingir o limite configurado, o agente fala a mensagem de despedida e encerra a chamada.
O timeout por inatividade é diferente da duração máxima da chamada (configurada no agente). A duração máxima limita o tempo total da ligação. O timeout por inatividade encerra apenas quando há silêncio prolongado.
Mensagem de Despedida: “Obrigado pelo contato. Se precisar de algo mais, ligue novamente. Até logo!”
Timeout por Inatividade: 30 segundos
Quando Usar: “Quando o usuário pedir para encerrar a chamada, quando fugir completamente do escopo do atendimento, ou quando o assunto estiver resolvido e não houver mais perguntas”
