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
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.talkover.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.