Atualizar assistente
Assistants
Atualizar assistente
Atualiza a configuração de um assistente de IA existente — prompt, voz, modelo, ferramentas e parâmetros — sem recriar o assistente do zero.
PUT
Atualizar assistente
Este endpoint permite atualizar a configuração de um assistente de IA existente. Todos os campos são opcionais — informe apenas os campos que deseja atualizar.
Observações
Apenas os campos informados no corpo da requisição serão atualizados
Todas as regras de validação se aplicam da mesma forma que na criação de um assistente
Para remover a atribuição de 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
Parâmetros de Caminho
Identificador único do assistente a ser atualizado
Corpo da Requisição
Campos 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/New_York”)
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 (defina como null para remover a atribuição)
Lista de IDs de ferramentas de uso durante a chamada a serem sincronizadas com o assistente. Substitui todas as atribuições de ferramentas existentes. Envie um array vazio para remover todas as ferramentas. 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 (pode ser definida como null para remover)
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 atualização do assistente
Respostas de Erro
404 Not Found
422 Validation Error
500 Internal Server Error