Skip to main content
POST
Criar ferramenta de uso durante a chamada
Este endpoint permite criar uma nova ferramenta de uso durante a chamada que pode ser utilizada pelos seus assistentes de IA para interagir com APIs externas durante as ligações.

Parâmetros do Corpo

name
string
required
Nome da ferramenta - deve conter apenas letras minúsculas e underscores, e começar com uma letra (ex.: get_weather, book_appointment)
description
string
required
Explicação detalhada de quando e como a IA deve utilizar esta ferramenta (máximo de 255 caracteres)
endpoint
string
required
URL válida do endpoint de API a ser chamado
method
string
required
Método HTTP: GET, POST, PUT, PATCH ou DELETE
timeout
integer
Timeout da requisição em segundos (1-30, padrão: 10)
headers
array
Headers HTTP a serem enviados na requisição
schema
array
Parâmetros que a IA irá extrair da conversa e enviar para o endpoint

Campos da Resposta

message
string
Mensagem de sucesso
data
object
Objeto da ferramenta criada
Anexando Ferramentas aos Assistentes Após criar uma ferramenta, você precisa anexá-la a um assistente para utilizá-la durante as chamadas. As ferramentas são gerenciadas pela API de Assistentes: Criar Assistente - Use o parâmetro tool_ids para anexar ferramentas ao criar um assistente Atualizar Assistente - Use o parâmetro tool_ids para adicionar, remover ou substituir ferramentas em um assistente existente