curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
-H "Authorization: Bearer talq_your_environment_token_here"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility', {
headers: { 'Authorization': 'Bearer talq_your_environment_token_here' }
});
const result = await response.json();
{
"success": true,
"data": {
"eligible": true,
"current_calls": 842,
"required_calls": 700,
"threshold_days": 7
}
}
Agentes
Verificar Elegibilidade para Custos Otimizados
Verificar se um agente se qualifica para precificação com custos otimizados
GET
/
api
/
v1
/
agents
/
{agent_id}
/
optimized-costs-eligibility
curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
-H "Authorization: Bearer talq_your_environment_token_here"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility', {
headers: { 'Authorization': 'Bearer talq_your_environment_token_here' }
});
const result = await response.json();
{
"success": true,
"data": {
"eligible": true,
"current_calls": 842,
"required_calls": 700,
"threshold_days": 7
}
}
Verificar Elegibilidade para Custos Otimizados
Verifica se um agente se qualifica para precificação com custos otimizados. Os custos otimizados aplicam cache em prompts repetidos do agente e reduzem o custo por chamada — a elegibilidade é baseada no volume de chamadas em uma janela recente.Endpoint
GET /api/v1/agents/{agent_id}/optimized-costs-eligibility
Parâmetros de caminho
string
obrigatório
UUID do agente.
Cabeçalhos da requisição
string
obrigatório
Token Bearer para autenticação. Formato:
Bearer talq_your_environment_token_hereExemplos
curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
-H "Authorization: Bearer talq_your_environment_token_here"
const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility', {
headers: { 'Authorization': 'Bearer talq_your_environment_token_here' }
});
const result = await response.json();
Resposta
Elegível
{
"success": true,
"data": {
"eligible": true,
"current_calls": 842,
"required_calls": 700,
"threshold_days": 7
}
}
Não Elegível
{
"success": true,
"data": {
"eligible": false,
"current_calls": 312,
"required_calls": 700,
"threshold_days": 7,
"calls_remaining": 388
}
}
Campos da Resposta
boolean
obrigatório
Se o agente atende atualmente ao limite de volume para custos otimizados.
integer
obrigatório
Número de chamadas realizadas por este agente nos últimos
threshold_days dias.integer
obrigatório
Limite de volume necessário para elegibilidade.
integer
obrigatório
Tamanho da janela em dias usada para contar chamadas.
Observações
- Uma vez elegível, ative os custos otimizados via Atualizar Configurações Avançadas definindo
enable_initial_message_cache: true. - A elegibilidade é verificada em tempo real — continue consultando este endpoint ou verifique periodicamente.
- Agentes que ficam abaixo do limite podem ser revertidos automaticamente para a precificação padrão.
Esta página foi útil?