Skip to main content
PUT

Atualizar Voz do Agente

Atualiza a configuração de voz de um agente, incluindo modelo de voz, idioma, velocidade da conversa e outras configurações relacionadas à voz.

Endpoint

Parâmetros de caminho

string
obrigatório
O identificador único do agente de voz a ser atualizado.

Cabeçalhos da requisição

string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here
string
obrigatório
Deve ser definido como application/json

Corpo da requisição

string
obrigatório
ID do modelo de voz. Use Listar Modelos de Voz para recuperar os IDs disponíveis.
number
obrigatório
Multiplicador de velocidade de reprodução da conversa. Faixa: maior que 1, menor que 2.
string
obrigatório
Quem fala primeiro. Opções: agent, user.
string
Som de fundo ambiente para a conversa (ex: office, cafe, quiet). Opcional.
number
Volume do som de fundo ambiente. Faixa: 0 (mudo) a 2 (alto). Padrão: 1.
string
Código de idioma do agente (ex: en-US, pt-BR). Opcional — enviado apenas ao alterar o idioma falado pelo agente. O modelo de voz deve suportar o idioma escolhido.
number
Reforço de similaridade da voz. Faixa: 0.5 a 1.0. Obrigatório apenas para modelos de voz de alta fidelidade (o quality_tier do modelo de voz determina se este campo é aceito). Valores mais altos reforçam as características da voz.
number
Estabilidade da voz. Faixa: 0.5 a 1.0. Obrigatório apenas para modelos de voz de alta fidelidade. Valores mais altos produzem saída mais consistente; valores mais baixos produzem saída mais expressiva.

Exemplos de Requisição

Resposta

Resposta de Sucesso (200 OK)

Campos da Resposta

boolean
obrigatório
Indica se a operação foi bem-sucedida.
string
obrigatório
Mensagem de sucesso confirmando que a voz do agente foi atualizada.
object
obrigatório
O objeto do agente atualizado com as novas configurações de voz.

Respostas de erro

Erro de Validação (422)

404 Não Encontrado

401 Não Autorizado

403 Proibido

Códigos de erro

Observações importantes

O status do agente será definido como rascunho. Após atualizar a voz do agente, ele será automaticamente definido como status “draft” e precisará ser publicado novamente para se tornar ativo.
As configurações de voz afetam a qualidade da chamada. Valores mais altos de estabilidade (próximos de 1.0) fornecem saída de voz mais consistente, enquanto valores mais altos de similaridade (próximos de 1.0) realçam as características da voz.

Melhores Práticas

  1. Teste as alterações de voz - Sempre teste atualizações de voz antes de publicar
  2. Equilibre estabilidade e similaridade - Maior estabilidade para chamadas profissionais, maior similaridade para um toque pessoal
  3. Considere a velocidade da conversa - Velocidades mais rápidas para interações breves, mais lentas para tópicos complexos
  4. Combine o idioma com a voz - Garanta que o modelo de voz suporta o idioma especificado
  5. Defina o fundo ambiente apropriado - Use “office” para chamadas comerciais, “quiet” para chamadas pessoais

Endpoints relacionados

  • Obter Agente: GET /api/v1/agents/{agent_id}
  • Atualizar Conhecimento do Agente: PUT /api/v1/agents/{agent_id}/knowledge
  • Atualizar Configurações de Chamada do Agente: PUT /api/v1/agents/{agent_id}/calling
  • Publicar Agente: POST /api/v1/agents/{agent_id}/publish
  • Listar Agentes: GET /api/v1/agents