Este endpoint permite atualizar a configuração de um assistente de IA existente. Todos os campos são opcionais - forneça apenas os campos que deseja atualizar.
Parâmetros de Caminho
O identificador único do assistente a ser atualizado
Corpo da Requisição
Campos Principais
O nome do assistente (máximo 255 caracteres)
O ID da voz a ser usada para o assistente (deve existir nas vozes disponíveis)
O nome do idioma para o assistente (máximo 100 caracteres)
O nome do modelo LLM a ser usado (máximo 100 caracteres)
O tipo de direção da chamada. Opções: receive, make
O tipo de engine a ser usado. Opções: pipeline, multimodal
O fuso horário para o assistente (ex: “America/New_York”)
A mensagem inicial que o assistente falará quando a chamada iniciar
O prompt do sistema que define o comportamento e personalidade do assistente
Configuração Opcional
O ID de um número de telefone para atribuir ao assistente (defina como null para desatribuir)
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.
Tipo de detecção de atividade de voz. Opções: vad, ai
Ní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)
Se deve ativar a avaliação pós-chamada
send_webhook_only_on_completed
Se deve enviar webhooks apenas em chamadas concluídas
include_recording_in_webhook
Se deve incluir a URL de gravação no payload do webhook
Configuração de Webhook
Se as notificações de webhook estão ativadas
A URL do webhook para notificações pós-chamada (pode ser definida como null para remover)
Configurações de Interrupção
Se deve usar a configuração de palavras mínimas de 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 de esquema para extração de dados pós-chamada Show post_call_schema properties
O nome do campo do esquema (apenas alfanumérico e underscores)
O tipo de dados. Opções: string, number, bool
post_call_schema[].description
Descrição do que este campo representa
Ferramenta de Encerrar Chamada
end_call_tool.description
Descrição para a funcionalidade da ferramenta de encerrar chamada (máximo 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
Se deve permitir interrupções do chamador
Se deve usar áudio de preenchimento 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)
Se deve encerrar a chamada quando uma caixa postal for detectada
Se deve ativar o cancelamento de ruído
Quem fala primeiro na chamada. Opções: AI assistant, Customer
Resposta
Mensagem de sucesso confirmando a atualização do assistente
O identificador único do assistente atualizado
O status atual do assistente
O tipo de assistente (inbound ou outbound)
O modo da engine (pipeline ou multimodal)
Respostas de Erro
Mensagem de erro quando o assistente não é encontrado ou não pertence ao usuário autenticado
Mensagem de erro indicando falha de validação
Erros de validação detalhados para cada campo
500 Internal Server Error
Mensagem de erro indicando falha na atualização do assistente
200 Success Response
404 Not Found
422 Validation Error
500 Internal Server Error
{
"message" : "Assistant updated successfully" ,
"data" : {
"id" : 789 ,
"name" : "Updated Sales Assistant" ,
"status" : "active" ,
"type" : "outbound" ,
"pipeline"
}
}
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_id como null
Para desativar o webhook, defina webhook_url como null ou is_webhook_active como false
O assistente deve pertencer ao usuário autenticado para ser atualizado
“mode”: