Skip to main content
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.

Parâmetros de Caminho

integer
required
Identificador único do assistente a ser atualizado

Corpo da Requisição

Campos Principais

string
O nome do assistente (máximo de 255 caracteres)
integer
O ID da voz a ser utilizada pelo assistente (deve existir entre as vozes disponíveis)
string
O idioma do assistente (máximo de 100 caracteres)
string
O nome do modelo LLM a ser utilizado (máximo de 100 caracteres)
string
O tipo de direção da chamada. Opções: receive, make
string
O tipo de engine a ser utilizada. Opções: pipeline, multimodal
string
O fuso horário do assistente (ex.: “America/New_York”)
string
A mensagem inicial que o assistente irá falar ao iniciar a chamada
string
O prompt de sistema que define o comportamento e a personalidade do assistente

Configurações Opcionais

integer
O ID de um número de telefone a ser atribuído ao assistente (defina como null para remover a atribuição)
integer[]
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.
string
Tipo de detecção de atividade de voz. Opções: vad, ai
number
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
Define se a avaliação pós-chamada estará habilitada
boolean
Define se os webhooks serão enviados apenas para chamadas concluídas
boolean
Define se a URL da gravação será incluída no payload do webhook

Configuração de Webhook

boolean
Define se as notificações via webhook estão habilitadas
string
A URL do webhook para notificações pós-chamada (pode ser definida como null para remover)

Configurações de Interrupção

boolean
Define se será utilizado o mínimo de palavras para permitir 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
array
Definição do esquema para extração de dados pós-chamada

Ferramenta de Encerramento de Chamada

string
Descrição da funcionalidade de encerramento de chamada (máximo de 500 caracteres)

Configurações de Voz e Fala

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
Define se o chamador pode interromper o assistente
boolean
Define se áudios de preenchimento serão utilizados 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
Define se a chamada será encerrada ao detectar caixa postal
boolean
Define se o cancelamento de ruído estará habilitado
boolean
Define se a chamada será gravada
string
Quem fala primeiro na chamada. Opções: AI assistant, Customer

Resposta

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

Respostas de Erro

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