> 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/configuracion-del-sdk.md).

# Configuração do SDK

O SDK Loader foi projetado para ser configurado facilmente por meio dos parâmetros passados para a função `loadSdk`. Esta função cria e configura automaticamente o elemento `<facephi-sdk-provider>`.

## Parâmetros de configuração

{% content-ref url="/pages/cf9bbf7c62e5d12d5335f355586090b0b4e24a9e" %}
[Parâmetros de configuração](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/configuracion-del-sdk/parametros-de-configuracion.md)
{% endcontent-ref %}

## Controle de eventos

{% content-ref url="/pages/8ac6ba1e59b4574aff7a5c32617993c6aa5ebe79" %}
[Controle de eventos](/docs.facephi-pt-br/produtos/idv-suite/flujos-and-integraciones/configuracion-tecnica-del-cliente/solucion-web/sdk-loader-idv/configuracion-del-sdk/control-de-eventos.md)
{% endcontent-ref %}

***

## Exemplo de configuração completa

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

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

if (sdkElement) {
  // Ouvir eventos do SDK
  sdkElement.addEventListener('emitIDVIntegration', (event) => {
    console.log('Integration event:', event);
  });
}
```

***

## Problemas conhecidos com uma Integração incorreta da APIKEY

A seguir, são descritos os problemas mais comuns e como evitá-los.

{% stepper %}
{% step %}

### Erro de configuração web (CORS)

É um requisito obrigatório fornecer à Facephi um domínio web válido onde o SDK será utilizado. Se o SDK for implantado em um domínio web diferente, aparecerá um erro CORS (Cross-Origin Resource Sharing).

#### Como evitar erros CORS?

* Certifique-se de configurar corretamente a URL da sua aplicação na seção "Conectar" ao criar uma Integração em IDV Suite
* Implante o SDK somente no domínio autorizado.
  {% endstep %}

{% step %}

### Erro de configuração do Fluxo de trabalho

A `apiKey` está vinculada aos produtos que o cliente contratou, que estão pré-configurados pela equipe de suporte da Facephi. Se um produto específico não estiver configurado, esses componentes não serão renderizados.

{% hint style="warning" %}
Se os problemas persistirem, entre em contato com a equipe de suporte da Facephi
{% endhint %}
{% endstep %}
{% endstepper %}