> 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/webphone-widget/primeiros-passos/instalacao.md).

# Instalação

### npm

```bash
npm install @digitalsac/digicalls-widget
```

```typescript
import { render } from "@digitalsac/digicalls-widget";
await render({ baseUrl, tokens: ["dev_..."] });
```

Tipos incluídos em `dist/index.d.ts`.

### CDN (jsDelivr)

```html
<script src="https://cdn.jsdelivr.net/npm/@digitalsac/digicalls-widget/dist/index.umd.js"></script>
<script>
  DigiCallsWebphone.render({
    baseUrl: "https://calls.digitalsac.io",
    tokens: ["dev_..."],
    lang: "pt",
  });
</script>
```

#### Fixar versão (produção)

```html
<script src="https://cdn.jsdelivr.net/npm/@digitalsac/digicalls-widget@0.3.0/dist/index.umd.js"></script>
```

Substitua `@0.3.0` pela versão publicada no npm.

### Dependência implícita

O widget embute o SDK — **não** é necessário instalar `@digitalsac/digicalls-sdk` separadamente para uso básico.

### Página de exemplo

O DigiCalls serve `/exemplo/` com formulário para colar tokens e montar o discador (útil para QA).

Próximo: Inicialização.