> For the complete documentation index, see [llms.txt](https://digitalsac.gitbook.io/digicalls/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://digitalsac.gitbook.io/digicalls/api-rest/permissao-de-ligacao-waba.md).

# Permissão de ligação WABA

Envia ao destinatário a **solicitação de permissão** para receber ligações WhatsApp Business (obrigatório antes de outbound em WABA).

### Painel

Device oficial → seção **Permissão de ligação** → informe telefone → **Solicitar permissão**.

### API — integração (API key)

Documentado no Swagger: <https://calls.digitalsac.io/docs/>

```http
POST /api/official/permission
Content-Type: application/json
X-Api-Key: dgu_SUA_CHAVE

{
  "device_id": "uuid-do-device-oficial",
  "phone": "5511999998888",
  "text": "Podemos ligar para concluir seu atendimento?"
}
```

Alternativa: use `phone_number_id` em vez de `device_id`:

```json
{
  "phone_number_id": "106418242303940",
  "phone": "5511999998888"
}
```

### Respostas

| HTTP | Significado                                 |
| ---- | ------------------------------------------- |
| 200  | Enviado (corpo = resposta Meta)             |
| 400  | `phone` ou identificador do device faltando |
| 401  | API key inválida                            |
| 403  | Device não pertence ao tenant               |
| 404  | Device não encontrado                       |
| 502  | Erro Graph API                              |

### API — sessão (painel)

Operador logado:

```http
POST /api/official/devices/{id}/call-permission
Authorization: Bearer <jwt>

{ "phone": "5511999998888", "text": "..." }
```

### Erro 138006

Se ligar sem permissão aceita, a Meta rejeita. Fluxo:

1. `POST /api/official/permission`
2. Usuário aceita no WhatsApp
3. Originar chamada pelo painel/SDK

### Webhook

Assine campo **`messages`** no App Meta para receber respostas de permissão (quando aplicável).

Veja WABA oficial.