Pular para o conteúdo principal
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"

{
  "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

​
agent_id
string
obrigatório
UUID do agente.

​
Cabeçalhos da requisição

​
Authorization
string
obrigatório
Token Bearer para autenticação. Formato: Bearer talq_your_environment_token_here

​
Exemplos

curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
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

​
data.eligible
boolean
obrigatório
Se o agente atende atualmente ao limite de volume para custos otimizados.
​
data.current_calls
integer
obrigatório
Número de chamadas realizadas por este agente nos últimos threshold_days dias.
​
data.required_calls
integer
obrigatório
Limite de volume necessário para elegibilidade.
​
data.threshold_days
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.