> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vectalk.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Verificar Permissões de Chamada

> Verifica se você tem permissão para ligar para um usuário específico do WhatsApp e quais ações estão disponíveis.

<Note>
  Requer token de instância associado ao número de telefone. O número é resolvido automaticamente pelo token — não é necessário informar o `phone-number-id`.
</Note>

## Parâmetros

### Query

<ParamField query="user_wa_id" type="string" required>
  WhatsApp ID do usuário cujas permissões serão verificadas. Formato: código do país + número, sem `+`. Exemplo: `5511999999999`.
</ParamField>

## Exemplo de Requisição

```bash theme={null}
curl --request GET \
  --url 'https://apis.vectalk.com.br/api/calls/permissions?user_wa_id=5511999999999' \
  --header 'Authorization: Bearer {seu_token}'
```

## Resposta

```json theme={null}
{
  "messaging_product": "whatsapp",
  "permission": {
    "status": "granted",
    "expiration_time": 1735689600
  },
  "actions": [
    {
      "action_name": "start_call",
      "can_perform_action": true,
      "limits": [
        {
          "time_period": "24h",
          "current_usage": 5,
          "max_allowed": 100,
          "limit_expiration_time": 1735689600
        }
      ]
    },
    {
      "action_name": "send_call_permission_request",
      "can_perform_action": false,
      "limits": null
    }
  ]
}
```

### Campos da Resposta

| Campo                          | Tipo    | Descrição                                                        |
| ------------------------------ | ------- | ---------------------------------------------------------------- |
| `permission.status`            | string  | Status da permissão: `granted`, `pending`, `denied` ou `expired` |
| `permission.expiration_time`   | integer | Timestamp Unix de expiração da permissão (quando aplicável)      |
| `actions[].action_name`        | string  | Nome da ação: `start_call` ou `send_call_permission_request`     |
| `actions[].can_perform_action` | boolean | Se o negócio pode executar esta ação                             |
| `actions[].limits`             | array   | Limites de uso da ação (rate limits)                             |

### Status de Permissão

| Status    | Descrição                                              |
| --------- | ------------------------------------------------------ |
| `granted` | Permissão ativa para ligar para este usuário           |
| `pending` | Solicitação de permissão enviada, aguardando aprovação |
| `denied`  | O usuário negou a permissão de chamada                 |
| `expired` | Permissão anterior expirou                             |