Agentes
Criar Agente
Criar um novo agente de voz com configuração e ajustes especificados
POST
Criar Agente
Criar um novo agente de voz com configuração, ajustes de voz e parâmetros de comportamento especificados. O agente será criado com status de rascunho e pode ser publicado posteriormente.Endpoint
Parâmetros de caminho
NenhumCabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_herestring
obrigatório
Deve ser definido como
application/jsonCorpo da requisição
string
obrigatório
Rótulo do agente (máximo de 255 caracteres)
string
Descrição do agente
string
obrigatório
Nome do agente (máximo de 255 caracteres)
string
obrigatório
Código de idioma do agente. Valores suportados:
pt-BR, pt-PT, en-US, en-CA, es-ES, fr-FR, de-DE, it-IT, nl-NL, ja-JP, ko-KR, zh-TW.string
Mensagem inicial que o agente irá dizer. Opcional.
string
obrigatório
Quão facilmente o agente permite que o chamador o interrompa. Opções:
low, medium, high.string
obrigatório
Quão agressivamente o agente detecta o fim da fala. Máximo de 255 caracteres.
Comportamento de navegação em URA para chamadas de saída que encontram menus interativos. Máximo de 255 caracteres.
number
obrigatório
Multiplicador de velocidade de reprodução da conversa. Faixa:
0.1–3.0.integer
obrigatório
Atraso em segundos antes do agente dizer a mensagem inicial. Faixa:
0–60.boolean
obrigatório
Quando
true, o agente pergunta “Você ainda está aí?” após o tempo limite de inatividade em vez de encerrar a chamada.integer
obrigatório
Segundos de silêncio do chamador antes de acionar o comportamento de inatividade. Faixa:
1–60.integer
Número máximo de re-prompts de inatividade antes de encerrar a chamada. Faixa:
1–10. Opcional.integer
Limite máximo de duração da chamada em segundos. Faixa:
1–3600. Opcional.boolean
Quando
true, o agente diz uma mensagem de encerramento antes de terminar uma chamada que atinge max_call_duration_seconds. Opcional.integer
Segundos de inatividade total antes do agente desistir completamente. Faixa:
5–120. Opcional.integer
Limite de inatividade a usar antes do agente ter dito sua mensagem inicial (lida com casos em que a linha abre, mas o chamador não fala). Faixa:
1–60. Opcional.integer
Número máximo de prompts iniciais de inatividade antes de terminar. Faixa:
0–10. Opcional.number
obrigatório
Temperatura de amostragem para o modelo de linguagem. Faixa:
0–2. Valores menores tornam as respostas mais determinísticas.boolean
obrigatório
Se as chamadas tratadas por este agente devem ser gravadas.
string
obrigatório
Direção da chamada. Opções:
inbound, outbound.string
obrigatório
Quem fala primeiro. Opções:
agent, user.array
Array de UUIDs de números de telefone a atribuir a este agente na criação. Use Listar Números de Telefone para recuperar os IDs disponíveis. Também pode ser definido posteriormente via Atualizar Chamadas do Agente.