Criar assistente
Assistants
Criar assistente
Cria um novo assistente de IA na OmniTech com voz, modelo LLM, prompt, ferramentas e demais configurações via uma requisição POST autenticada.
POST
Criar assistente
Este endpoint permite criar um novo assistente de IA com opções completas de configuração.
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
Corpo da Requisição
Campos Obrigatórios Principais
O nome do assistente (máximo de 255 caracteres)
O ID da voz a ser utilizada pelo assistente (deve existir entre as vozes disponíveis)
O idioma do assistente (máximo de 100 caracteres)
O nome do modelo LLM a ser utilizado (máximo de 100 caracteres)
O tipo de direção da chamada. Opções:
receive, makeO tipo de engine a ser utilizada. Opções:
pipeline, multimodalO fuso horário do assistente (ex.: “America/Sao_Paulo”)
A mensagem inicial que o assistente irá falar ao iniciar a chamada
O prompt de sistema que define o comportamento e a personalidade do assistente
Configurações Opcionais
O ID de um número de telefone a ser atribuído ao assistente (deve existir entre os números do usuário)
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.
Tipo de detecção de atividade de voz. Opções:
vad, aiNível de sensibilidade do endpoint (0-5)
Nível de sensibilidade de interrupção (0-5)
Nível de volume do som ambiente (0-1)
Define se a avaliação pós-chamada estará habilitada
Define se os webhooks serão enviados apenas para chamadas concluídas
Define se a URL da gravação será incluída no payload do webhook
Configuração de Webhook
Define se as notificações via webhook estão habilitadas
A URL do webhook para notificações pós-chamada (obrigatório se is_webhook_active for true)
Configurações de Interrupção
Define se será utilizado o mínimo de palavras para permitir interrupção
Número mínimo de palavras antes que a interrupção seja permitida (0-10)
Variáveis e Esquema
Pares chave-valor de variáveis personalizadas para o assistente
Definição do esquema para extração de dados pós-chamada
Ferramenta de Encerramento de Chamada
Descrição da funcionalidade de encerramento de chamada (máximo de 500 caracteres)
Configurações de Voz e Fala
Configuração de temperatura do LLM (0-1)
Configuração de estabilidade da voz (0-1)
Configuração de similaridade da voz (0-1)
Multiplicador de velocidade da fala (0.7-1.2)
Configurações de Comportamento da Chamada
Define se o chamador pode interromper o assistente
Define se áudios de preenchimento serão utilizados durante o processamento
Intervalo de reengajamento em segundos (7-600)
Duração máxima da chamada em segundos (20-1200)
Duração máxima de silêncio em segundos (1-120)
Define se a chamada será encerrada ao detectar caixa postal
Define se o cancelamento de ruído estará habilitado
Define se a chamada será gravada
Quem fala primeiro na chamada. Opções:
AI assistant, CustomerResposta
Mensagem de sucesso confirmando a criação do assistente
Respostas de Erro
422 Validation Error
500 Internal Server Error