> 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/digicalls-sdk/primeiros-passos/instalacao.md).

# Instalação

### npm / pnpm / yarn

```bash
npm install @digitalsac/digicalls-sdk
# ou
pnpm add @digitalsac/digicalls-sdk
```

### CDN (UMD)

```html
<script src="https://cdn.jsdelivr.net/npm/@digitalsac/digicalls-sdk/dist/index.umd.js"></script>
<script>
  const dc = new DigiCalls.DigiCalls({ baseUrl: "https://calls.digitalsac.io", tokens: ["dev_..."] });
</script>
```

### Obter device tokens

Tokens são criados no **backend** com a API key do tenant:

```bash
curl -X POST "https://calls.digitalsac.io/api/devices" \
  -H "X-Api-Key: dgu_SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{"name":"Linha 1"}'
```

Resposta: `{ "device": { "token": "dev_...", "id": "..." } }`.

Pareie escaneando o QR:

```bash
curl "https://calls.digitalsac.io/api/devices/dev_.../qr" -H "X-Api-Key: dgu_..."
```

### TypeScript

O pacote inclui declarações `.d.ts`. Não é necessário `@types/*`.

### Frameworks

Independente de framework — use com React, Vue, Svelte ou JS puro. Bundlers (Vite, webpack) funcionam sem configuração extra.

Próximo: Inicialização.