Skip to main content
POST
Criar assistente
Este endpoint permite criar um novo assistente de IA com opções completas de configuração.

Corpo da Requisição

Campos Obrigatórios Principais

string
required
O nome do assistente (máximo de 255 caracteres)
integer
required
O ID da voz a ser utilizada pelo assistente (deve existir entre as vozes disponíveis)
string
required
O idioma do assistente (máximo de 100 caracteres)
string
required
O nome do modelo LLM a ser utilizado (máximo de 100 caracteres)
string
required
O tipo de direção da chamada. Opções: receive, make
string
required
O tipo de engine a ser utilizada. Opções: pipeline, multimodal
string
required
O fuso horário do assistente (ex.: “America/Sao_Paulo”)
string
required
A mensagem inicial que o assistente irá falar ao iniciar a chamada
string
required
O prompt de sistema que define o comportamento e a personalidade do assistente

Configurações Opcionais

integer
O ID de um número de telefone a ser atribuído ao assistente (deve existir entre os números do usuário)
integer[]
Lista de IDs de ferramentas de uso durante a chamada a serem associadas ao assistente. Cada item deve ser um ID válido pertencente à sua conta.
string
Tipo de detecção de atividade de voz. Opções: vad, ai
number
Nível de sensibilidade do endpoint (0-5)
number
Nível de sensibilidade de interrupção (0-5)
number
Nível de volume do som ambiente (0-1)
boolean
Define se a avaliação pós-chamada estará habilitada
boolean
Define se os webhooks serão enviados apenas para chamadas concluídas
boolean
Define se a URL da gravação será incluída no payload do webhook

Configuração de Webhook

boolean
Define se as notificações via webhook estão habilitadas
string
A URL do webhook para notificações pós-chamada (obrigatório se is_webhook_active for true)

Configurações de Interrupção

boolean
Define se será utilizado o mínimo de palavras para permitir interrupção
integer
Número mínimo de palavras antes que a interrupção seja permitida (0-10)

Variáveis e Esquema

object
Pares chave-valor de variáveis personalizadas para o assistente
array
Definição do esquema para extração de dados pós-chamada

Ferramenta de Encerramento de Chamada

string
Descrição da funcionalidade de encerramento de chamada (máximo de 500 caracteres)

Configurações de Voz e Fala

number
Configuração de temperatura do LLM (0-1)
number
Configuração de estabilidade da voz (0-1)
number
Configuração de similaridade da voz (0-1)
number
Multiplicador de velocidade da fala (0.7-1.2)

Configurações de Comportamento da Chamada

boolean
Define se o chamador pode interromper o assistente
boolean
Define se áudios de preenchimento serão utilizados durante o processamento
integer
Intervalo de reengajamento em segundos (7-600)
integer
Duração máxima da chamada em segundos (20-1200)
integer
Duração máxima de silêncio em segundos (1-120)
boolean
Define se a chamada será encerrada ao detectar caixa postal
boolean
Define se o cancelamento de ruído estará habilitado
boolean
Define se a chamada será gravada
string
Quem fala primeiro na chamada. Opções: AI assistant, Customer

Resposta

string
Mensagem de sucesso confirmando a criação do assistente
object

Respostas de Erro

Observações Todos os campos obrigatórios devem ser informados para que o assistente seja criado com sucesso O assistente será criado com configurações padrão para quaisquer campos opcionais não informados A atribuição de número de telefone é opcional, mas o número deve pertencer ao usuário autenticado A URL do webhook é obrigatória apenas quando is_webhook_active estiver definido como true Os identificadores de voz e idioma devem corresponder às opções disponíveis no sistema OmniTech