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

id
integer
required
Identificador único do assistente a ser atualizado

Corpo da Requisição

Campos Principais

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

Configurações Opcionais

phone_number_id
integer
O ID de um número de telefone a ser atribuído ao assistente (defina como null para remover a atribuição)
tool_ids
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.
endpoint_type
string
Tipo de detecção de atividade de voz. Opções: vad, ai
endpoint_sensitivity
number
Nível de sensibilidade do endpoint (0-5)
interrupt_sensitivity
number
Nível de sensibilidade de interrupção (0-5)
ambient_sound_volume
number
Nível de volume do som ambiente (0-1)
post_call_evaluation
boolean
Define se a avaliação pós-chamada estará habilitada
send_webhook_only_on_completed
boolean
Define se os webhooks serão enviados apenas para chamadas concluídas
include_recording_in_webhook
boolean
Define se a URL da gravação será incluída no payload do webhook

Configuração de Webhook

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

Configurações de Interrupção

use_min_interrupt_words
boolean
Define se será utilizado o mínimo de palavras para permitir interrupção
min_interrupt_words
integer
Número mínimo de palavras antes que a interrupção seja permitida (0-10)

Variáveis e Esquema

variables
object
Pares chave-valor de variáveis personalizadas para o assistente
post_call_schema
array
Definição do esquema para extração de dados pós-chamada

Ferramenta de Encerramento de Chamada

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

Configurações de Voz e Fala

llm_temperature
number
Configuração de temperatura do LLM (0-1)
voice_stability
number
Configuração de estabilidade da voz (0-1)
voice_similarity
number
Configuração de similaridade da voz (0-1)
speech_speed
number
Multiplicador de velocidade da fala (0.7-1.2)

Configurações de Comportamento da Chamada

allow_interruptions
boolean
Define se o chamador pode interromper o assistente
filler_audios
boolean
Define se áudios de preenchimento serão utilizados durante o processamento
re_engagement_interval
integer
Intervalo de reengajamento em segundos (7-600)
max_call_duration
integer
Duração máxima da chamada em segundos (20-1200)
max_silence_duration
integer
Duração máxima de silêncio em segundos (1-120)
end_call_on_voicemail
boolean
Define se a chamada será encerrada ao detectar caixa postal
noise_cancellation
boolean
Define se o cancelamento de ruído estará habilitado
record_call
boolean
Define se a chamada será gravada
who_speaks_first
string
Quem fala primeiro na chamada. Opções: AI assistant, Customer

Resposta

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

Respostas de Erro

404 Not Found
422 Validation Error
500 Internal Server Error
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