Skip to main content
GET
/
calls
/
permissions
Verificar Permissões de Chamada
curl --request GET \
  --url https://apis.vectalk.com.br/api/calls/permissions \
  --header 'Authorization: Bearer <token>'

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.

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.

​
Parâmetros

​
Query

​
user_wa_id
string
required
WhatsApp ID do usuário cujas permissões serão verificadas. Formato: código do país + número, sem +. Exemplo: 5511999999999.

​
Exemplo de Requisição

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

​
Resposta

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

CampoTipoDescrição
permission.statusstringStatus da permissão: granted, pending, denied ou expired
permission.expiration_timeintegerTimestamp Unix de expiração da permissão (quando aplicável)
actions[].action_namestringNome da ação: start_call ou send_call_permission_request
actions[].can_perform_actionbooleanSe o negócio pode executar esta ação
actions[].limitsarrayLimites de uso da ação (rate limits)

​
Status de Permissão

StatusDescrição
grantedPermissão ativa para ligar para este usuário
pendingSolicitação de permissão enviada, aguardando aprovação
deniedO usuário negou a permissão de chamada
expiredPermissão anterior expirou