Skip to main content
PUT
Atualizar assistente
Este endpoint permite que você atualize 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

integer
required
O identificador único do assistente a ser atualizado

Corpo da Requisição

Campos Principais

string
O nome do assistente (máx. 255 caracteres)
integer
O ID da voz a ser usada para o assistente. Use o endpoint Obter Vozes com o parâmetro mode para obter vozes compatíveis com o seu modo de motor.
integer
O ID do idioma para o assistente. Use o endpoint Obter Idiomas para obter idiomas disponíveis.
string
O tipo de assistente. Opções: inbound, outbound
string
O modo do motor. Opções: pipeline, multimodal, dualplex
Alterar o modo redefinirá as configurações específicas do modo para os padrões do novo modo.
string
O fuso horário para o assistente (ex: “Europe/Bucharest”, “America/New_York”)
string
A mensagem inicial que o assistente falará quando a chamada começar (máx. 200 caracteres)
string
O prompt do sistema que define o comportamento e a personalidade do assistente

Campos Específicos do Modo

integer
O ID do modelo LLM a ser usado. Aplica-se apenas ao modo pipeline.Use o endpoint Obter Modelos para obter modelos disponíveis.
integer
O ID do modelo multimodal. Aplica-se apenas aos modos multimodal e dualplex.Use o endpoint Obter Modelos para obter modelos multimodais disponíveis.
integer
ID do modelo LLM de fallback para chamadas de ferramentas nos modos multimodal/dualplex. Defina como null para remover.
number
Sensibilidade de detecção de turnos para modos multimodal/dualplex (0-1). Defina como null para auto.

Idiomas Secundários

integer[]
Array de IDs de idiomas adicionais que o assistente pode falar. Substitui os idiomas secundários existentes. Passe um array vazio [] para remover todos os idiomas secundários.

Configurações da Base de Conhecimento

integer
O ID da base de conhecimento a ser anexada. Defina como null para remover a base de conhecimento.
string
Como usar a base de conhecimento. Opções:
  • function_call - A IA chama uma função para pesquisar (obrigatório para multimodal/dualplex)
  • prompt - O conhecimento é injetado no prompt (apenas pipeline)

Organização

integer
ID de uma pasta para mover este assistente. Deve pertencer à sua conta. Defina como null para torná-lo não categorizado. Omitir para deixar a pasta inalterada.
integer[]
Array de IDs de rótulos para este assistente. Cada rótulo deve pertencer à sua conta. Quando fornecido, isso substitui os rótulos atuais do assistente. Omitir para deixar os rótulos inalterados; envie [] para remover todos os rótulos.

Número de Telefone

integer
O ID de um número de telefone a ser atribuído. Defina como null para desatribuir. Deve pertencer à sua conta.
Para assistentes inbound, o número de telefone não pode ser do tipo Caller ID e não pode já estar atribuído a outro assistente inbound.

Ferramentas Personalizadas de Chamada

integer[]
Array de IDs de ferramentas personalizadas de chamada para sincronizar. Substitui todas as atribuições de ferramentas existentes. Passe um array vazio [] para remover todas as ferramentas. Cada ferramenta deve pertencer à sua conta.

Ferramentas Integradas

array
Array de ferramentas integradas. Substitui todas as ferramentas integradas existentes. Passe um array vazio [] para remover todas as ferramentas.

Configurações de Voz e TTS

boolean
Se deve habilitar a síntese de texto para fala emocional
number
Configuração de estabilidade da voz (0-1). Maior = voz mais consistente
number
Configuração de similaridade da voz (0-1). Maior = mais próximo da voz original
number
Multiplicador de velocidade da fala (0.7-1.2)
number
Configuração de temperatura do LLM (0-1). Menor = mais determinístico
integer
ID do provedor de TTS personalizado. Defina como null para usar o padrão do idioma. Use o endpoint Obter Provedores de Sintetizador para descobrir provedores disponíveis.
integer
ID do provedor de STT personalizado. Apenas modo pipeline. Defina como null para usar o padrão do idioma. Use o endpoint Obter Provedores de Transcrição para descobrir provedores disponíveis.

Configurações de Comportamento da Chamada

boolean
Se deve permitir interrupções do chamador.
Não pode ser desabilitado para modos multimodal e dualplex.
boolean
Se deve usar áudio de preenchimento durante o processamento.
Disponível apenas para o modo pipeline.
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/afirmativas
  • negative: Palavras de preenchimento para respostas negativas/neutras
  • question: Palavras de preenchimento ao processar uma pergunta
  • neutral: Palavras de preenchimento para reconhecimentos neutros
boolean
Se deve gravar a chamada
boolean
Se deve habilitar a cancelamento de ruído
boolean
Se verdadeiro, o assistente espera que o cliente fale 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
Duração máxima de silêncio no início da chamada antes de encerrar (1-120 segundos). Defina como null para desabilitar.
integer
Duração máxima 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áx. 1000 caracteres). Defina como null para usar o padrão.

Configurações de Correio de Voz

boolean
Se deve encerrar a chamada quando o correio de voz for detectado
string
Mensagem a ser deixada no correio de voz antes de desligar (máx. 1000 caracteres). Defina como null para desabilitar.

Detecção de Endpoint

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)
integer
Mínimo de palavras 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, nature
number
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 falhadas/sem resposta)
boolean
Se deve incluir a URL da gravação na carga útil do webhook

Avaliação Pós-Chamada

boolean
Se deve habilitar a avaliação pós-chamada da IA
array
Definição do esquema para extração de dados pós-chamada. Substitui o esquema existente.

Variáveis

object
Pares chave-valor de variáveis personalizadas. Substitui todas as variáveis existentes.

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: 30
boolean
Se deve permitir reativar a conversa após ela terminar devido à inatividade
string
URL do webhook chamada quando uma conversa de chat termina devido à inatividade. Defina como null para remover. Separado do webhook principal da chamada.

Exemplos de Requisições

Atualizar Configurações Básicas

Mudar para Modo Multimodal

Atualizar Ferramentas e Base de Conhecimento

Atualizar Reengajamento e Correio de Voz

Adicionar Integração de Calendário (Cal.com)

Adicionar Integração de Calendário (Calendly)

Remover Configurações Opcionais


Resposta

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

Notas

  • Apenas os campos que você fornecer no corpo da requisição serão atualizados
  • Para remover campos opcionais, defina-os explicitamente como null
  • Para limpar arrays (ferramentas, idiomas secundários), passe um array vazio []
  • O assistente deve pertencer ao usuário autenticado
  • Use o endpoint Obter Vozes com o parâmetro mode para obter vozes compatíveis
  • Para modos multimodal/dualplex, knowledgebase_mode deve ser function_call
  • Para modos multimodal/dualplex, allow_interruptions não pode ser desabilitado
  • Alterar o modo redefine as configurações específicas do modo (modelo LLM, modelo multimodal, provedores)