> 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 captura de rosto v.5.33.0**

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

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

Para realizar a autenticação do usuário, é necessário uma etapa prévia única de cadastro biométrico para a verificação da identidade. Uma vez cadastrado, o processo de autenticação implica capturar o rosto que, comparado com o registro anterior, permitirá ao usuário acessar os produtos e/ou serviços.

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

Para poder usar Facephi Authentication, você precisa ter no seu dispositivo um navegador compatível, 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="/files/da136031a08fa4b63bdd49d3cc111dcc5c4c4d8b" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

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

Para continuar, pressione o botão (1). Para cancelar a permissão e não continuar, pressione o 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="/files/7d8a091652d241f93a53de013ff1236f80d3df58" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Assim que o processo começa, aparece um texto (2) que traz orientações sobre como se posicionar ou o que você deve levar em conta.

Esta 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 adequadas forem atendidas, a captura será feita automaticamente e você será direcionado para a próxima etapa.

Se quiser encerrar o processo, pressione o ícone (1).

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

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

<figure><img src="/files/f624d7e22b680253a6779464a47bbaa68ceff247" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

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

Se quiser encerrar o processo, pressione o ícone (1).

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

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

<figure><img src="/files/9614d07f34ce66eecbc6268df2e2e42247520b5e" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Depois de realizada a captura do rosto, aparecerá uma tela de pré-visualização (se tiver sido ativada em Configuração). Aqui você deve verificar se o rosto aparece completamente e bem iluminado.

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

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

1. Botão para fechar 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 que foi capturada corretamente
{% endcolumn %}
{% endcolumns %}

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

<figure><img src="/files/b94972a9062cf614f0c9ee6237daacf9916abd11" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Este é o tutorial de captura de rosto. Aqui são mostradas algumas dicas de como posicionar o rosto e o que deve ser levado em conta para que a captura seja realizada com sucesso. Há um total de 3 dicas.

Para vê-las, pressione o botão (3) ou (4). Para voltar à Captura de Documento, pressione o botão (2).

Para sair do Widget sem fazer a captura, pressione o ícone (1).

1. Botão para fechar o processo
2. Botão 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="/files/878e3aad8194113a920b243e1437375279c4ee8f" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

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

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

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

1. Botão para fechar o processo
2. Botão de informações
3. Botão de 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="/files/710cb55a18c521710013c68ecd0a132fbe90aaea" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Anteriormente, a permissão da câmera foi negada, mas o widget está tentando acessar.

Depois de alguns segundos, a mensagem desaparecerá e voltará à tela anterior.

1. Botão para fechar 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="/files/669da65475fdf7617bd645c95a6c01d9ef1cdb95" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Se, durante a captura de rosto, a câmera não detectar nenhum rosto, esta mensagem de erro será exibida. Pressione o botão (1) para fechar esta tela ou o 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="/files/190ebc5b024e502cf1bf3f83068ba05dd3cbd799" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="50%" %}
Esta mensagem aparece quando há um problema técnico interno. A princípio, é um erro temporário. Aqui devemos aguardar um momento até que o erro seja resolvido.

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