> 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/click-to-call/primeiros-passos.md).

# Primeiros passos

### Pré-requisitos

1. Servidor DigiCalls acessível (ex.: `https://calls.digitalsac.io`).
2. Uma conexão **WhatsApp (QR) pareada** (`state: open`).

### Criar um link (painel)

1. Vá em **Dispositivos** e abra a conexão desejada (precisa estar **pareada**).
2. Abra a seção **Click to Call**.
3. Preencha:
   * **Número (fixo):** o destino que este link sempre vai ligar (ex.: `5511999998888`). Aceita máscara; só os dígitos são usados.
   * **Rótulo (opcional):** um nome para você se organizar (ex.: "Botão site — João").
4. Clique em **Criar link**. Copie a URL gerada (`https://SEU_HOST/call/l_…`) e cole onde quiser.

Você pode criar **quantos links quiser por conexão** — normalmente um por destino:

| Link               | Liga para       | Onde colar           |
| ------------------ | --------------- | -------------------- |
| `/call/l_ab12cd34` | João (Vendas)   | botão do site        |
| `/call/l_ef56gh78` | Maria (Suporte) | assinatura de e-mail |

### Colocar no seu site

Basta um link ou botão apontando para a URL:

```html
<a href="https://SEU_HOST/call/l_ab12cd34" target="_blank" rel="noopener">
  📞 Ligar para nós
</a>
```

Abrir em **popup** (ideal no CRM):

```javascript
window.open(
  "https://calls.digitalsac.io/call/l_ab12cd34",
  "digicalls",
  "width=380,height=620"
);
```

A página de chamada é **auto-contida** (não carrega o painel nem o SDK) e pede permissão de microfone ao clicar em **Ligar**. Requer **HTTPS** para o navegador liberar o microfone (o `localhost` também funciona em desenvolvimento).

{% hint style="info" %}
**Gestos do usuário:** navegadores exigem interação (clique) antes de capturar o microfone. O fluxo "abriu o link → clicou em Ligar" já atende essa regra.
{% endhint %}

### Revogar / pausar

* **Desativar** um link o revoga na hora: a URL para de funcionar (novas chamadas são recusadas) sem afetar a conexão nem os outros links. Pode reativar depois.
* **Excluir** remove o link definitivamente.

### Criar um link via API

Além do painel, dá para criar links programaticamente (autenticado como o dono da conexão):

```bash
curl -X POST https://calls.digitalsac.io/api/ctc-links \
  -H "Authorization: Bearer <SEU_TOKEN_DE_USUARIO>" \
  -H "Content-Type: application/json" \
  -d '{"sessionId":"<ID_DA_CONEXAO>","phone":"5511999998888","label":"Botão site"}'
# → { "id":"l_ab12cd34", "url":"https://calls.digitalsac.io/call/l_ab12cd34", ... }
```

A referência completa de campos e rotas está em Campos e API.