> 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/sdks/sdk-web/componentes/sdk-provider/propiedades.md).

# Propriedades

O componente SDK Provider da Facephi é configurável por meio das seguintes propriedades, oferecendo comportamentos diferentes para os possíveis casos de uso que possam ser necessários.

## Constantes

Algumas constantes ou enums podem ser importadas de `@facephi/sdk-web-wc` para facilitar as implementações.

```javascript
import { Language, TypeFamily, TrackingSteps } from '@facephi/sdk-web-wc'
```

## Exemplo de configuração

```jsx
import { Language, TypeFamily, TrackingSteps } from '@facephi/sdk-web-wc';

<facephi-sdk-provider
    apikey={process.env.FACEPHI_SDK_APIKEY}
    steps={`${TrackingSteps.start},${TrackingSteps.selphidWidget},${TrackingSteps.selphiWidget},${TrackingSteps.finish}`}`
    type={TypeFamily.onboarding}
    customerId={'user-7f3a9c21'}
    language={Language.en}
/>
```

***

> **Recomendação:** Configure as propriedades por meio de JavaScript, JSX ou dos bindings do seu framework (React, Vue, Angular, etc.). Evite a configuração HTML nativa com atributos (`nombre-atributo="valor"`), pois pode perder a tipagem e o formato esperado pelo componente.

## Propriedades de configuração do SDK Provider

Com o uso das propriedades do SDK Provider, é possível configurar o comportamento e Fluxo de seus componentes.

### Obrigatórias

* [apikey](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/apikey.md): Licença obrigatória do SDK Web fornecida pela Facephi.

### Tracking

* [steps](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/steps.md): Ordem das etapas do Fluxo registrado na plataforma.
* [type](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/type.md): Tipo de operação registrada na plataforma (Onboarding ou autenticação).
* [customerId](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/customerid.md): Identificador do usuário ou cliente da operação.
* [operationId](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/operationid.md): Identificador da operação na plataforma.
* [tenantId](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/tenantid.md): Identificador de tenant para o Tracking na plataforma.

### Configuração

* [autoInitTracking](https://github.com/facephi/facephi-gitbook-docs/tree/master/docs/sdks/sdk-web/componentes/sdk-provider/propiedades/autoinittracking.md): Inicia o Tracking automaticamente ao carregar o SDK.
* [autoInitWorkflow](https://github.com/facephi/facephi-gitbook-docs/tree/master/docs/sdks/sdk-web/componentes/sdk-provider/propiedades/autoinitworkflow.md): Inicia o fluxo de trabalho automaticamente ao carregar o SDK.
* [landingApiKey](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/landingapikey.md): Chave API para o serviço Landing.
* [proxy](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/proxy.md): URL do servidor proxy para as requisições do SDK.
* [resourcesPath](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/resourcespath.md): Caminho personalizado para carregar recursos do SDK.
* [qr](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/qr.md): Habilita a captura no celular por meio de Código QR no desktop.
* [qrExtraParams](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/qrextraparams.md): Parâmetros extras na URL do Fluxo QR móvel.
* [settingsStrictness](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/settingsstrictness.md): Controla se um valor de configuração inválido bloqueia o SDK ou é substituído pelo seu valor padrão.
* [waitRequest](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/waitrequest.md): Aguarda a finalização das requisições de envio de dados antes de avançar no Fluxo.

### Personalização

* [desktopView](https://github.com/facephi/facephi-gitbook-docs/tree/master/docs/sdks/sdk-web/componentes/sdk-provider/propiedades/desktopview.md): Ativa a visualização de desktop do SDK.
* [language](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/language.md): Idioma dos textos do SDK e de seus componentes.
* [theme](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/theme.md): Tema visual do SDK (cores, logo e tipografia).
* [customAnimations](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/customanimations.md): Animações personalizadas centralizadas para os componentes do SDK.
* [loadingAnimation](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/loadinganimation.md): Caminho para uma animação de carregamento personalizada do provider.

### Desenvolvimento

* [debug](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/debug.md): Ativa logs e opções de desenvolvedor.
* [disabled](/docs.facephi-pt-br/sdks/sdk-web/componentes/sdk-provider/propiedades/disabled.md): Desativa o Tracking e o serviço de Fluxo.
