Skip to main content
POST
Criar assistente
Este endpoint permite que você crie um novo assistente de IA com opções de configuração abrangentes.

Modos de Motor

A API suporta três modos de motor, cada um com diferentes capacidades:

Corpo da Solicitação

Campos Obrigatórios Principais

string
required
O nome do assistente (máx. 255 caracteres)
integer
required
O ID da voz a ser usada para o assistente. Use o endpoint Obter Vozes com o parâmetro mode para obter vozes compatíveis com seu modo de motor.
integer
required
O ID do idioma para o assistente. Use o endpoint Obter Idiomas para obter idiomas disponíveis.
string
required
O tipo de assistente. Opções: inbound, outbound
string
required
O modo do motor. Opções: pipeline, multimodal, dualplex
string
required
O fuso horário para o assistente (ex: “Europe/Bucharest”, “America/New_York”)
string
required
A mensagem inicial que o assistente falará quando a chamada começar (máx. 200 caracteres)
string
required
O prompt do sistema que define o comportamento e a personalidade do assistente

Campos Específicos do Modo

integer
O ID do modelo LLM a ser usado. Obrigatório para o modo pipeline.Use o endpoint Obter Modelos para obter modelos disponíveis.
integer
O ID do modelo multimodal. Obrigatório para os modos multimodal e dualplex.Use o endpoint Obter Modelos para obter modelos multimodais disponíveis.
integer
ID do modelo LLM de fallback para chamadas de ferramentas nos modos multimodal/dualplex. Opcional.
number
Sensibilidade de detecção de turnos para modos multimodal/dualplex (0-1). Padrão: automático

Idiomas Secundários

integer[]
Array de IDs de idiomas adicionais que o assistente pode falar. O assistente detectará e mudará de idioma automaticamente.

Configurações de Base de Conhecimento

integer
O ID da base de conhecimento a ser anexada a este assistente
string
Como usar a base de conhecimento. Opções:
  • function_call - A IA chama uma função para pesquisar (obrigatório para multimodal/dualplex)
  • prompt - O conhecimento é injetado no prompt (apenas pipeline)

Organização

integer
ID de uma pasta para colocar este assistente. Deve pertencer à sua conta. Envie null para deixar o assistente sem categorização.
integer[]
Array de IDs de rótulos a serem aplicados a este assistente. Cada rótulo deve pertencer à sua conta.

Número de Telefone

integer
O ID de um número de telefone a ser atribuído ao assistente. Deve pertencer à sua conta.
Para assistentes inbound, o número de telefone não pode ser do tipo Caller ID e não pode já estar atribuído a outro assistente inbound.

Ferramentas Personalizadas de Chamada

integer[]
Array de IDs de ferramentas personalizadas de chamada a serem anexadas. Cada ferramenta deve pertencer à sua conta.

Ferramentas Integradas

array
Array de ferramentas integradas a serem habilitadas. Cada ferramenta tem um type e campos específicos da ferramenta.

Configurações de Voz e TTS

boolean
default:"true"
Se deve habilitar a síntese de texto para fala emocional
number
default:"0.70"
Configuração de estabilidade da voz (0-1). Maior = voz mais consistente
number
default:"0.50"
Configuração de similaridade da voz (0-1). Maior = mais próximo da voz original
number
default:"1.00"
Multiplicador de velocidade da fala (0.7-1.2)
number
default:"0.10"
Configuração de temperatura do LLM (0-1). Menor = mais determinístico
integer
ID do provedor de TTS personalizado. Selecionado automaticamente com base no idioma se não fornecido. Use o endpoint Obter Provedores de Sintetizador para descobrir provedores disponíveis.
integer
ID do provedor de STT personalizado. Selecionado automaticamente com base no idioma se não fornecido. Apenas modo pipeline. Use o endpoint Obter Provedores de Transcrição para descobrir provedores disponíveis.

Configurações de Comportamento da Chamada

boolean
default:"true"
Se deve permitir interrupções do chamador.
Não pode ser desabilitado para modos multimodal e dualplex.
boolean
default:"false"
Se deve usar áudio de preenchimento durante o processamento (ex: “hum”, “deixe-me verificar”).
Disponível apenas para o modo pipeline.
object
Perfis de palavras de preenchimento personalizados por categoria. Se não fornecido, os padrões são definidos com base no idioma do assistente. Cada categoria é um array de frases curtas.
  • positive: Palavras de preenchimento para respostas positivas/afirmativas (ex: “Ótimo!”, “Perfeito!”)
  • negative: Palavras de preenchimento para respostas negativas/neutras (ex: “Hmm.”, “Entendi.”)
  • question: Palavras de preenchimento ao processar uma pergunta (ex: “Hmm.”, “Deixe-me pensar.”)
  • neutral: Palavras de preenchimento para reconhecimentos neutros (ex: “Ok.”, “Entendi.”)
boolean
default:"false"
Se deve gravar a chamada
boolean
default:"true"
Se deve habilitar a cancelamento de ruído
boolean
default:"false"
Se verdadeiro, o assistente espera que o cliente fale primeiro

Configurações de Tempo

integer
default:"600"
Duração máxima da chamada em segundos (20-1200)
integer
default:"40"
Duração máxima de silêncio antes do reengajamento em segundos (1-360)
integer
Duração máxima de silêncio no início da chamada antes de encerrar (1-120 segundos). Opcional.
integer
default:"30"
Duração máxima de toque antes de desistir (1-60 segundos)

Configurações de Reengajamento

integer
default:"30"
Intervalo de reengajamento em segundos (7-600)
string
Prompt personalizado para mensagens de reengajamento (máx. 1000 caracteres)Exemplo: "Você ainda está aí? Tem mais alguma pergunta?"

Configurações de Correio de Voz

boolean
default:"true"
Se deve encerrar a chamada quando o correio de voz for detectado
string
Mensagem a ser deixada no correio de voz antes de desligar (máx. 1000 caracteres)

Detecção de Endpoint

string
default:"vad"
Tipo de detecção de atividade de voz. Opções: vad, ai
number
default:"0.5"
Nível de sensibilidade do endpoint (0-5)
number
default:"0.5"
Nível de sensibilidade de interrupção (0-5)
integer
Mínimo de palavras antes que a interrupção seja permitida (0-10). Defina para habilitar.

Som Ambiente

string
Som ambiente de fundo. Opções: off, office, city, forest, crowded_room, cafe, nature
number
default:"0.5"
Nível de volume do som ambiente (0-1)

Configuração de Webhook

boolean
default:"false"
Se as notificações de webhook estão habilitadas
string
A URL do webhook para notificações pós-chamada. Obrigatório se is_webhook_active for verdadeiro.
boolean
default:"true"
Se deve enviar webhooks apenas em chamadas concluídas (não falhadas/sem resposta)
boolean
default:"true"
Se deve incluir a URL da gravação na carga útil do webhook

Avaliação Pós-Chamada

boolean
default:"true"
Se deve habilitar a avaliação pós-chamada da IA
array
Definição do esquema para extração de dados pós-chamada

Variáveis

object
Pares chave-valor de variáveis personalizadas acessíveis em prompts via {{variable_name}}

Configurações de Conversa Encerrada

integer
default:"30"
Minutos de inatividade do chat antes que a conversa seja considerada encerrada (1-1440)
boolean
default:"false"
Se deve permitir reativar a conversa após ela terminar devido à inatividade
string
URL do webhook chamada quando uma conversa de chat termina devido à inatividade. Separada do webhook principal da chamada.

Exemplos de Solicitações

Assistente em Modo Pipeline

Assistente em Modo Multimodal

Assistente em Modo Dualplex


Resposta

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

Notas

  • Todos os campos obrigatórios devem ser fornecidos para a criação bem-sucedida do assistente
  • Use o endpoint Obter Vozes com o parâmetro mode para obter vozes compatíveis
  • Para modos multimodal/dualplex, knowledgebase_mode deve ser function_call
  • Para modos multimodal/dualplex, allow_interruptions está sempre habilitado
  • Preenchimentos estão disponíveis apenas no modo pipeline
  • O assistente é criado com status inactive por padrão