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

> Verificar se um agente se qualifica para precificação com custos otimizados

# 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

<ParamField path="agent_id" type="string" required>
  UUID do agente.
</ParamField>

## Cabeçalhos da requisição

<ParamField header="Authorization" type="string" required>
  Token Bearer para autenticação. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```

  ```javascript theme={null}
  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();
  ```
</RequestExample>

## Resposta

### Elegível

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "eligible": true,
      "current_calls": 842,
      "required_calls": 700,
      "threshold_days": 7
    }
  }
  ```
</ResponseExample>

### Não Elegível

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "eligible": false,
      "current_calls": 312,
      "required_calls": 700,
      "threshold_days": 7,
      "calls_remaining": 388
    }
  }
  ```
</ResponseExample>

### Campos da Resposta

<ResponseField name="data.eligible" type="boolean" required>
  Se o agente atende atualmente ao limite de volume para custos otimizados.
</ResponseField>

<ResponseField name="data.current_calls" type="integer" required>
  Número de chamadas realizadas por este agente nos últimos `threshold_days` dias.
</ResponseField>

<ResponseField name="data.required_calls" type="integer" required>
  Limite de volume necessário para elegibilidade.
</ResponseField>

<ResponseField name="data.threshold_days" type="integer" required>
  Tamanho da janela em dias usada para contar chamadas.
</ResponseField>

## Observações

* Uma vez elegível, ative os custos otimizados via [Atualizar Configurações Avançadas](/api-reference/endpoints/update-advanced-settings) 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.