Atualizar assistente
Assistentes
Atualizar assistente
Atualizar a configuração de um assistente de IA existente
PUT
Atualizar assistente
Este endpoint permite atualizar as configurações de um assistente de IA existente. Todos os campos são opcionais - forneça apenas os campos que deseja atualizar.
Parâmetros de Caminho
integer
required
O identificador único do assistente a ser atualizado
Corpo da Requisição
Campos Principais
string
O nome do assistente (máximo 255 caracteres)
integer
O ID da voz a ser usada para o assistente (deve existir nas vozes disponíveis)
string
O nome do idioma para o assistente (máximo 100 caracteres)
string
O nome do modelo LLM a ser usado (máximo 100 caracteres)
string
O tipo de direção da chamada. Opções:
receive, makestring
O tipo de engine a ser usado. Opções:
pipeline, multimodalstring
O fuso horário para o assistente (ex: “America/New_York”)
string
A mensagem inicial que o assistente falará quando a chamada iniciar
string
O prompt do sistema que define o comportamento e personalidade do assistente
Configuração Opcional
integer
O ID de um número de telefone para atribuir ao assistente (defina como null para desatribuir)
integer[]
Array de IDs de ferramentas de meio de chamada para sincronizar com o assistente. Substitui todas as atribuições de ferramentas existentes. Passe um array vazio para remover todas as ferramentas. Cada elemento deve ser um ID de ferramenta válido que pertença à sua conta.
string
Tipo de detecção de atividade de voz. Opções:
vad, ainumber
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
Se deve ativar a avaliação pós-chamada
boolean
Se deve enviar webhooks apenas em chamadas concluídas
Ferramentas Integradas
array
Array de ferramentas integradas. Substitui todas as ferramentas integradas existentes. Passe um array vazio
[] para remover todas as ferramentas.Configuração de Webhook
boolean
Se as notificações de webhook estão ativadas
string
A URL do webhook para notificações pós-chamada (pode ser definida como null para remover)
Configurações de Interrupção
boolean
Se deve usar a configuração de palavras mínimas de 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
integer
ID do provedor TTS personalizado. Defina como
null para usar o padrão do idioma. Use o endpoint Get Synthesizer Providers para descobrir provedores disponíveis.integer
ID do provedor STT personalizado. Apenas no modo pipeline. Defina como
null para usar o padrão do idioma. Use o endpoint Get Transcriber Providers para descobrir provedores disponíveis.Configurações de Comportamento da Chamada
boolean
Se deve permitir interrupções do chamador.
boolean
Se deve usar áudio de preenchimento durante o processamento.
object
Perfis de palavras de preenchimento personalizadas por categoria. Substitui a configuração de preenchimento existente. Cada categoria é um array de frases curtas.
positive: Palavras de preenchimento para respostas positivas/afirmativasnegative: Palavras de preenchimento para respostas negativas/neutrasquestion: Palavras de preenchimento ao processar uma perguntaneutral: Palavras de preenchimento para reconhecimentos neutros
boolean
Se deve gravar a chamada
boolean
Se deve ativar o cancelamento de ruído
boolean
Se verdadeiro, o assistente aguarda o cliente falar primeiro
Configurações de Tempo
integer
Duração máxima da chamada em segundos (20-1200)
integer
Duração máxima de silêncio antes do reengajamento em segundos (1-360)
integer
Silêncio máximo no início da chamada antes de encerrar (1-120 segundos). Defina como
null para desabilitar.integer
Tempo máximo de toque antes de desistir (1-60 segundos)
Configurações de Reengajamento
integer
Intervalo de reengajamento em segundos (7-600)
string
Prompt personalizado para mensagens de reengajamento (máximo 1000 caracteres). Defina como
null para usar o padrão.Configurações de Caixa Postal
boolean
Se deve encerrar a chamada quando caixa postal for detectada
string
Mensagem para deixar na caixa postal antes de desligar (máximo 1000 caracteres). Defina como
null para desabilitar.Detecção de Endpoint
string
Tipo de detecção de atividade de voz. Opções:
vad, ainumber
Nível de sensibilidade do endpoint (0-5)
number
Nível de sensibilidade de interrupção (0-5)
integer
Palavras mínimas antes que a interrupção seja permitida (0-10). Defina como
null para desabilitar.Som Ambiente
string
Som ambiente de fundo. Opções:
off, office, city, forest, crowded_room, cafe, naturenumber
Nível de volume do som ambiente (0-1)
Configuração de Webhook
boolean
Se as notificações de webhook estão habilitadas
string
A URL do webhook para notificações pós-chamada. Defina como
null para remover.boolean
Se deve enviar webhooks apenas em chamadas concluídas (não falharam/não atenderam)
boolean
Se deve incluir URL de gravação no payload do webhook
Avaliação Pós-Chamada
boolean
Se deve ativar a avaliação pós-chamada da IA
array
Schema definition for post-call data extraction. Replaces existing schema.
Ferramenta de Encerrar Chamada
string
Descrição para a funcionalidade da ferramenta de encerrar chamada (máximo 500 caracteres)
Configurações de Conversa Encerrada
integer
Minutos de inatividade do chat antes que a conversa seja considerada encerrada (1-1440). Defina como
null para desabilitar. Padrão: 30boolean
Se deve permitir redisparo da conversa após encerrar devido à inatividade
string
URL do webhook chamada quando uma conversa de chat termina devido à inatividade. Defina como
null para remover. Separado do webhook principal de chamada.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
Se deve permitir interrupções do chamador
boolean
Se deve usar áudio de preenchimento 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
Se deve encerrar a chamada quando uma caixa postal for detectada
boolean
Se deve ativar o cancelamento de ruído
boolean
Se deve gravar a chamada
string
Quem fala primeiro na chamada. Opções:
AI assistant, CustomerResposta
string
Mensagem de sucesso confirmando a atualização do assistente
object
Respostas de Erro
Observações
- Apenas os campos que você fornecer no corpo da requisição serão atualizados
- Todas as regras de validação se aplicam da mesma forma que ao criar um assistente
- Para remover a atribuição de um número de telefone, defina
phone_number_idcomonull - Para desativar o webhook, defina
webhook_urlcomonullouis_webhook_activecomofalse - O assistente deve pertencer ao usuário autenticado para ser atualizado “mode”:

