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

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

Configurações Opcionais

phone_number_id
integer
O ID de um número de telefone a ser atribuído ao assistente (deve existir entre os números do usuário)
tool_ids
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.
endpoint_type
string
Tipo de detecção de atividade de voz. Opções: vad, ai
endpoint_sensitivity
number
Nível de sensibilidade do endpoint (0-5)
interrupt_sensitivity
number
Nível de sensibilidade de interrupção (0-5)
ambient_sound_volume
number
Nível de volume do som ambiente (0-1)
post_call_evaluation
boolean
Define se a avaliação pós-chamada estará habilitada
send_webhook_only_on_completed
boolean
Define se os webhooks serão enviados apenas para chamadas concluídas
include_recording_in_webhook
boolean
Define se a URL da gravação será incluída no payload do webhook

Configuração de Webhook

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

Configurações de Interrupção

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

Variáveis e Esquema

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

Ferramenta de Encerramento de Chamada

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

Configurações de Voz e Fala

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

Configurações de Comportamento da Chamada

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

Resposta

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

Respostas de Erro

422 Validation Error
500 Internal Server Error
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