> 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/configuracoes-gerais-do-dispositivo.md).

# Configurações gerais do dispositivo

Opções por sessão WhatsApp (QR) no painel DigiCalls. O modal do dispositivo é organizado em abas: **Discador**, **Geral**, **Click to Call** e **Webhook** (o dispositivo oficial WABA tem ainda a aba **Configuração**).

### Geral — comportamento de chamada

A aba **Geral** controla, **por dispositivo**, dois comportamentos:

| Opção                | Padrão        | O que faz                                                                                                                                                                                                             |
| -------------------- | ------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Receber chamadas** | Ligado        | Permite que este número receba chamadas do WhatsApp. Desligado, o número fica **só para saída**: as chamadas de entrada são recusadas na hora.                                                                        |
| **Gravar chamadas**  | **Desligado** | Grava as chamadas deste número. É **opt-in**: você liga explicitamente. A gravação só acontece se **também** houver uma política de gravação ativa na conta (Local pelo admin ou S3/R2 pelo usuário) — veja Gravação. |

Os toggles salvam na hora (sem botão Salvar).

#### API

```
GET /api/sessions/{sid}/settings
PUT /api/sessions/{sid}/settings
```

Body do `PUT`:

```json
{ "receiveCalls": true, "recordCalls": false }
```

`GET` retorna o estado atual (`{ receiveCalls, recordCalls }`). Autenticação por token de sessão (login) — o mesmo escopo dos demais endpoints `/api/sessions/*`.

### Conexão

| Ação                   | Descrição                                         |
| ---------------------- | ------------------------------------------------- |
| **Parear / Re-parear** | Gera novo QR (`POST .../pair` ou restart via API) |
| **Logout WhatsApp**    | Desvincula número (`POST .../logout`)             |
| **Renomear**           | Nome amigável na lista                            |
| **Excluir**            | Remove sessão e credenciais                       |

### Tronco SIP

Habilitar SIP, username, password e codec — veja SIP.

### Device token (webphone)

`GET /api/sessions/{sid}/token` retorna token `dev_…` para SDK/widget.

Rotacionar: exclua e recrie device via API, ou admin gera novo.

### Limites

* **maxDevices:** quantidade máxima de linhas QR por usuário
* **Chamadas simultâneas:** por device (config global/admin)

### Oficial (WABA)

Devices oficiais têm painel próprio:

* Editar credenciais Meta
* Webhook (URL + verify token)
* Solicitar permissão de ligação

Veja WABA oficial.

### Monitoramento

Admin vê estatísticas agregadas (devices conectados, chamadas ativas, gravações).

### API key do tenant

Cada usuário possui API key (`dgu_…`) para provisionamento — menu **Minha API key** (admin rotaciona).

Usada em `X-Api-Key` nos endpoints `/api/devices/*`.