> 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/introduccion/instalacion.md).

# Instalação

O SDK Web é uma biblioteca de componentes *elementos personalizados* compatíveis com qualquer framework atual.

Existem duas versões da biblioteca SDK Web:

* **SDK Web WebComponents**: Biblioteca web-components, compatível com a maioria dos frameworks e ambientes.
* **SDK Web React**: Versão de componentes nativos React. Esta biblioteca conta com todas as funcionalidades da versão WebComponents, mas com a sintaxe aplicável ao React.

***

## Credenciais de download

Crie um arquivo chamado `.npmrc` na raiz do seu projeto com o seguinte conteúdo:

```bash
@facephi:registry=https://facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:_password=[TU_TOKEN]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:username=[TU_USUARIO]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:email=[TU_EMAIL]
//facephicorp.jfrog.io/artifactory/api/npm/sdk-web-fphi/:always-auth=true
```

Substitua `[TU_TOKEN]`, `[TU_USUARIO]` e `[TU_EMAIL]` pelas credenciais fornecidas.

***

## Instalação da biblioteca

Existem duas formas principais de integrar o SDK Web da Facephi em seu aplicativo. Por meio de um gerenciador de pacotes ou por CDN. Em ambos os casos, são oferecidas as mesmas funcionalidades.

### Instalação por meio de um gerenciador de pacotes

Recomendada para projetos que utilizam frameworks modernos como React, Angular ou Vue.

O pacote do SDK Web está hospedado em um repositório privado de NPM. Siga estas etapas para instalá-lo:

#### SDK Web Components

Execute o seguinte comando no terminal do seu projeto:

```bash
npm install @facephi/sdk-web-wc
```

Também existem versões para **React** e **Angular** com uma versão nativa para esses ambientes. Consulte a seção de [integração em frameworks](/docs.facephi-pt-br/sdks/sdk-web/frameworks-y-samples.md#wrappers-espec-c3-adficos-de-framework) para mais informações.

Certifique-se de que a instalação seja concluída sem erros antes de continuar.

***

### Instalação via CDN

Para projetos que não utilizam um gerenciador de pacotes, você pode integrar o SDK usando um link CDN:

```javascript
import 'https://cdn.facephi.pro/@facephi/sdk-web-wc@latest/bundle?bundle=false';
import { defineCustomElements as defineCustomFacephiSDKElements } from 'https://cdn.facephi.pro/@facephi/sdk-web-wc@latest/bundle?bundle=false';

defineCustomFacephiSDKElements(window);
```

Isso carregará a versão mais recente do SDK diretamente dos servidores da Facephi.

O restante da integração é o mesmo para ambos os casos.

***

## Próximos passos

* Continue com a [Configuração inicial](/docs.facephi-pt-br/sdks/sdk-web/introduccion/primeros-pasos.md).
* Revise os [Exemplos de integração](/docs.facephi-pt-br/sdks/sdk-web/ejemplos-de-integracion.md).