> 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/dispositivo/conexao-oficial-waba.md).

# Conexão oficial (WABA)

Integração via **WhatsApp Business Calling API** (Meta Cloud API) — sem QR, sem risco de sessão whatsmeow.

### O que você precisa

| Credencial          | Onde obter                             |
| ------------------- | -------------------------------------- |
| **Phone Number ID** | Meta Business → WhatsApp → Números     |
| **WABA ID**         | WhatsApp Business Account              |
| **Access Token**    | System user / token long-lived         |
| **App Secret**      | App Dashboard → Configurações → Básico |
| **Verify Token**    | Você define (painel DigiCalls gera)    |

### Cadastro no painel

1. **Dispositivos → Nova sessão → Oficial (WABA)**
2. Preencha credenciais
3. Seção **Webhook** — copie URL e Verify Token para o App Meta

#### Webhook Meta

| Campo           | Valor                                               |
| --------------- | --------------------------------------------------- |
| URL de callback | `https://SEU_HOST/api/official/webhook`             |
| Verify token    | token da conexão (ex.: gerado no painel)            |
| Campos          | `calls` (+ `messages` se usar permissão de ligação) |

App Secret valida assinatura `X-Hub-Signature-256` **por conexão** (multi-tenant).

### Editar credenciais

Dispositivos oficiais permitem editar nome, IDs, token, App Secret e Verify Token na modal do device (seções recolhíveis).

### Permissão de ligação

Antes de ligar para um contato (outbound business-initiated), envie solicitação:

* Painel: seção **Permissão de ligação**
* API: POST /api/official/permission

Sem permissão a Meta retorna erro **138006**.

### Chamadas

Operador usa **mesma UI** de chamadas do painel (`/api/sessions/{sid}/calls/...`). Device aparece com badge **Oficial**.

### Diferenças vs. QR

|            | QR       | WABA                       |
| ---------- | -------- | -------------------------- |
| Pareamento | QR       | Credenciais Meta           |
| Custo Meta | —        | Conforme política Business |
| Ban sessão | Possível | Não aplicável              |
| Gravação   | Sim      | Em evolução                |
| SIP        | Sim      | Browser (SIP em roadmap)   |
| Campanhas  | Sim      | Regras Meta                |

### Documentação técnica interna

Detalhes de arquitetura: `cmd/server/docs/official-connector.md`.