> For the complete documentation index, see [llms.txt](https://docs.facephi.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.facephi.com/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/inicio-rapido.md).

# Início rápido

## Pré-requisitos

Antes de começar, certifique-se de ter:

{% stepper %}
{% step %}

### Token de autenticação

Você precisará de um **TOKEN** de autenticação, fornecido pela equipe da Facephi, para acessar o SDK.
{% endstep %}

{% step %}

### Node.js e gerenciador de pacotes

Certifique-se de ter **Node.js** e **NPM** (ou seu gerenciador de pacotes preferido) instalados em seu sistema.

* [Site oficial do Node.js](https://nodejs.org/es/) (recomendado v20+)
* [Documentação do NPM](https://docs.npmjs.com/try-the-latest-stable-version-of-npm)
  {% endstep %}

{% step %}

### API Key

Gere sua [primeira Integração](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/integraciones-no-code-low-code/integraciones-low-code.md) no painel do IDV Suite, assim que a Integração for criada e publicada, será gerado um API Key associado.\
**Este API Key será fornecido pela equipe de Suporte da Facephi.**
{% endstep %}
{% endstepper %}

## Conceitos básicos

### SDK Loader

O SDK Loader é um pacote leve que carrega dinamicamente o pacote `@facephi/sdk-web-wc` da CDN em tempo de execução. Cria e configura automaticamente o elemento `<facephi-sdk-provider>` em sua aplicação.

**Uso básico:**

{% code title="example.ts" %}

```typescript
import { loadSdk } from '@facephi/sdk-loader';

const sdkElement = await loadSdk({
  apiKey: 'YOUR_APIKEY',
  containerId: 'sdk-container',
});
```

{% endcode %}

### Como funciona

Quando você chama `loadSdk()`:

{% stepper %}
{% step %}
O pacote de Web Components do SDK é carregado da CDN.
{% endstep %}

{% step %}
Os elementos personalizados são registrados no navegador.
{% endstep %}

{% step %}
É criado um elemento `<facephi-sdk-provider>` com sua configuração.
{% endstep %}

{% step %}
O provider é inserido no elemento contêiner que você tiver especificado.
{% endstep %}
{% endstepper %}

## Próximos passos

Agora que você conhece os conceitos básicos, já pode começar a integrar o SDK:

* [**Guia de Integração**](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/integracion.md): Instruções passo a passo de instalação e Integração
* [**Configuração do SDK**](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/configuracion-del-sdk.md): Opções de configuração da função `loadSdk`
* [**Integração com Next.js**](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/integrations/nextjs.md): Guia para aplicações Next.js
* [**Exemplos de programação**](https://github.com/facephi/sdk-web-examples): Coleção de implementações de exemplo

Para uma visão completa da estrutura da documentação, consulte o [índice principal](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv.md).
