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

Nenhum

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
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.
string
obrigatório
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.13.0.
integer
obrigatório
Atraso em segundos antes do agente dizer a mensagem inicial. Faixa: 060.
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: 160.
integer
Número máximo de re-prompts de inatividade antes de encerrar a chamada. Faixa: 110. Opcional.
integer
Limite máximo de duração da chamada em segundos. Faixa: 13600. 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: 5120. 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: 160. Opcional.
integer
Número máximo de prompts iniciais de inatividade antes de terminar. Faixa: 010. Opcional.
number
obrigatório
Temperatura de amostragem para o modelo de linguagem. Faixa: 02. 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.

Exemplos de Requisição

Resposta

Resposta de Sucesso (201 Created)

Respostas de erro

Erro de Validação (422)

Erro Não Autorizado (401)

Muitas Requisições (429)