> 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/autenticacion-usuarios-registrados/editor-1/web/widgets/rostro.md).

# Rosto

**Widget de captura facial v.5.33.0**

### **Introdução** <a href="#introduccion" id="introduccion"></a>

A autenticação facial é um processo que permite verificar a identidade dos usuários por meio de tecnologia biométrica facial.

Para realizar a autenticação do usuário, é necessário um passo único prévio de cadastro biométrico para a verificação da identidade. Depois do cadastro, o processo de autenticação envolve capturar o rosto, que será comparado ao rosto cadastrado anteriormente, permitindo que o usuário acesse o produto e/ou serviço.

### **Requisitos e instalação** <a href="#requisitos-e-instalacion" id="requisitos-e-instalacion"></a>

Para usar o Facephi Authentication, você precisa ter um navegador compatível no seu dispositivo, seja em um computador ou em um dispositivo móvel. Os sistemas operacionais e navegadores compatíveis são:

* Windows, macOS, Android, iOS.
* Mozilla Firefox, Google Chrome, Opera, Safari.

### **Captura de rosto** <a href="#captura-de-rostro" id="captura-de-rostro"></a>

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-56127bca6c529b3a2aa90fcc57afe905eb220a7f%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Ao iniciar, será exibida uma mensagem solicitando as permissões necessárias para realizar o processo.

Para continuar, clique no botão (1). Para cancelar a permissão e não continuar, clique no botão (2).

1. Botão para permitir o acesso
2. Botão para cancelar o acesso
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-8a7f31d5d27858ff81b337dee81e7d7466fe6629%2F2690123307.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Quando o processo começar, será exibido um texto (2) com instruções sobre como se posicionar e o que levar em consideração.

Essa mensagem é atualizada em tempo real e fornecerá detalhes sobre:

* Distância: perto, longe.
* Enquadramento: fora do círculo, girado.
* Movimento
* Iluminação

Se as condições forem adequadas, a captura será feita automaticamente e você será direcionado para a próxima etapa.

Para encerrar o processo, clique no ícone (1).

1. Botão para encerrar o processo
2. Mensagem de ajuda
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-3b511d7d6481db822402330fef9dae6774029742%2F2690123310.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Quando sua posição e as condições estiverem corretas, o círculo (2) mudará de forma e cor. Se você não estiver posicionado corretamente, ele voltará ao estado anterior e exibirá mensagens de ajuda.

Para encerrar o processo, clique no ícone (1).

1. Botão para encerrar o processo
2. Círculo informativo sobre o estado do processo
3. Mensagem de ajuda
   {% endcolumn %}
   {% endcolumns %}

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-91e59c77118acddfdc35e776f7f6eb1da6dd0a04%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Depois que o rosto for capturado, será exibida uma tela de pré-visualização (se essa opção estiver ativada em Configurações). Nela, você deve verificar se o rosto está totalmente visível e bem iluminado.

Se a foto estiver desfocada, cortada ou mal iluminada, recomendamos que você tente novamente esta etapa (3) para tirar outra foto e evitar erros futuros. Uma captura ruim nesta etapa pode causar erros futuros de identificação facial.

Se a foto estiver nítida, clique no botão (4) para continuar para a próxima etapa.

1. Botão para encerrar o processo
2. Botão de informações
3. Botão para tentar novamente
4. Botão para continuar

A pré-visualização serve para confirmar se a captura foi feita corretamente
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-0beecf2af5f5ad4922cddc887084f65c3c5d2528%2FTuto.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Este é o tutorial de captura de rosto. Aqui são apresentados alguns conselhos sobre como posicionar o rosto e o que levar em consideração para que a captura seja feita com sucesso. São 3 conselhos no total.

Para visualizá-los, clique no botão (3) ou (4). Para voltar à Captura de Documento, clique no botão (2).

Para sair do Widget sem fazer a captura, clique no ícone (1).

1. Botão para encerrar o processo
2. Botão de voltar
3. Botão anterior
4. Botão seguinte
   {% endcolumn %}
   {% endcolumns %}

### **Erros** <a href="#errores" id="errores"></a>

#### **Tempo esgotado** <a href="#tiempo-superado" id="tiempo-superado"></a>

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-f359b5986cdd7f2327cfeecb6075633466d876a7%2Ftimeout_face.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
O tempo máximo para que o Widget realize a captura foi excedido.

O mais provável é que as condições necessárias para que o Widget tire uma foto adequada não tenham sido atendidas.

Tente novamente esta etapa seguindo as instruções exibidas na tela e clicando no botão (3) ou, se houver, no ícone de informações (2) para receber dicas.

1. Botão para encerrar o processo
2. Botão de informações
3. Botão para tentar novamente
   {% endcolumn %}
   {% endcolumns %}

#### **Permissões da câmera** <a href="#permisos-de-camara" id="permisos-de-camara"></a>

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-ea692e2e0b28365da8522c558ea9c6b59c9cc3e3%2Fcamera.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
A permissão de acesso à câmera foi negada anteriormente, mas o widget está tentando acessá-la.

Após alguns segundos, a mensagem desaparecerá e a tela anterior será exibida novamente.

1. Botão para encerrar o processo
   {% endcolumn %}
   {% endcolumns %}

#### **Rosto não detectado** <a href="#rostro-no-detectado" id="rostro-no-detectado"></a>

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-96db696e4c66ce5a205d60f7c6640836ac152f63%2Fface.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Se a câmera não detectar nenhum rosto durante a captura, esta mensagem de erro será exibida. Clique no botão (1) para fechar esta tela ou no botão (2) para tentar novamente.

1. Botão para fechar
   {% endcolumn %}
   {% endcolumns %}

#### **Problemas técnicos** <a href="#problemas-tecnicos" id="problemas-tecnicos"></a>

{% columns %}
{% column width="50%" %}

<figure><img src="https://427654043-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FUo71Qbj6jZQDavjc0U5X%2Fuploads%2Fgit-blob-b5b59387220779f799db49cfe2e1deb4f237b9b7%2Fimage.png?alt=media" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Esta mensagem é exibida quando ocorre um problema técnico interno. Em princípio, é um erro temporário. Nesse caso, aguarde um momento até que o erro seja resolvido.

1. Botão Fechar
   {% endcolumn %}
   {% endcolumns %}
