> 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/vincule-um-whatsapp-qr.md).

# Vincule um WhatsApp (QR)

Conexão **não oficial** via pareamento WhatsApp Web (whatsmeow).

### Como funciona

Igual ao WhatsApp Web: escaneie QR ou use **passkey** (quando disponível) para vincular o número ao DigiCalls.

### Pelo painel

1. **Dispositivos → Nova sessão**
2. Escolha **WhatsApp (QR)**
3. Escaneie o QR no celular (Aparelhos conectados)

### Pela API (integração)

```bash
# Criar
curl -X POST "https://calls.digitalsac.io/api/devices" \
  -H "X-Api-Key: dgu_..." \
  -d '{"name":"Loja"}'

# QR
curl "https://calls.digitalsac.io/api/devices/dev_.../qr" \
  -H "X-Api-Key: dgu_..."

# Status
curl "https://calls.digitalsac.io/api/devices/dev_.../status" \
  -H "X-Api-Key: dgu_..."
```

Resposta status: `{ "state": "open", "paired": true, "jid": "5511...@s.whatsapp.net" }`.

### Enviar só o QR ao cliente

Exponha o QR no seu CRM:

1. Backend busca `GET /api/devices/{token}/qr` com API key
2. Renderize string QR na tela do cliente

Ou use página de pareamento do Izing apontando para o DigiCalls.

### Passkey (extensão Chrome)

Alternativa ao QR: pareamento nativo via **passkey** do WhatsApp Web.

1. Instale a extensão **DigiCalls Linker**: <https://digicalls.dev/digicalls-linker.zip>
2. No painel, use **Conectar via extensão (passkey)**.

Guia completo: Passkey — extensão Chrome.

Endpoints da API (usados pela extensão):

```
GET  /api/devices/{token}/passkey
POST /api/devices/{token}/passkey/response
POST /api/devices/{token}/passkey/confirm
```

### Desconectar

* Painel: **Logout** na sessão
* API: `POST /api/devices/{token}/restart` (novo QR) ou delete device

### Limites

Cada usuário tem `maxDevices` (QR). Devices **oficiais WABA** não contam nesse limite.

### Boas práticas

Veja Manual de boas práticas.

### Próximo passo

Configure Tronco SIP ou integre SDK / Webphone.