> For the complete documentation index, see [llms.txt](https://portal-integracao.intelbras.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://portal-integracao.intelbras.com.br/linha-de-faciais/modo-online/modo-online-2.0/deteccao-facial.md). # Detecção Facial A partir da versão de firmware 20260416, os produtos listados abaixo permitem a função de Detecção Facial, em que, com esse recurso ativo, o controlador de acesso facial Intelbras não executa o reconhecimento facial com base nas imagens cadastradas no produto, e sim efetua a detecção de face e encaminha a captura para reconhecimento por algoritmo de terceiros. {% hint style="warning" %} **Ao habilitar essa opção, o reconhecimento facial será feito por terceiros. A Intelbras isenta-se da responsabilidade e controle quanto ao uso de terceiro para realizar o procedimento de reconhecimento facial, conforme descrito no Termo de Uso aceito na inicialização do produto.** {% endhint %} | Dispositivos | Firmware | | --------------- | -------------------- | | SS 3531 MF Lite | 20260416 ou superior | | SS 3542 MF LITE | 20260416 ou superior | | SS 3532 MF | 20260416 ou superior | | SS 3532 MF | 20260416 ou superior | | SS 3532 MF W | 20260416 ou superior | | SS 3542 MF W | 20260416 ou superior | | SS 5531 MF W | 20260416 ou superior | | SS 5531 MF EX | 20260416 ou superior | | SS 5541 MF W | 20260416 ou superior | | SS 5532 MF W | 20260416 ou superior | | SS 5542 MF W | 20260416 ou superior | {% hint style="info" %} **Importante:** O uso do recurso só é permitido através do Modo Online 2.0 e as regras de liberação de acesso permanecem conforme a lógica corrente e descritas no tópico ["Modo Online 2.0"](/linha-de-faciais/modo-online/modo-online-2.0/configurar-via-api.md). No caso de falta de comunicação com o servidor, somente será liberado o acesso para os usuários cadastrados no dispositivo. {% endhint %} ### Envio da face capturada ao servidor O fluxo de envio da face capturada pelo controlador de acesso facial Intelbras é feito conforme a imagem a seguir:
A imagem da captura da face é encaminhada em formato Base64, através do objeto "ImageEncode" no corpo do evento de requisição de acesso: {% code overflow="wrap" %} ```json // Corpo do evento de requisição de acesso { "Channel": 0, "Events": [{ "Action": "Pulse", "Code": "AccessControl", "Data": { "CardName": "", "CardNo": "", "CardStatus": 0, "CitizenIDNo": "", "DoorAction": false, "DoorIndex": 0, "ErrorCode": 96, "HatColor": "Black", "HatType": 0, "ImageEncode": "/9j/4AAQSkZJRgABAQIAdgB2AAD/7wAPAAAAAAAAAAAAAAAAAP/bAEMACgcHCQcGCgkICQsLCgwPGRAPDg4PHhYXEhkkICYlIyAjIigtOTAoKjYrIiMyRDI2Oz1AQEAmMEZLRT5KOT9APf/bAEMBCwsLDw0PHRAQHT0pIyk9<---------QuebradoPropositalmente---------------->cmxHk4yKQgkmns6ZAHakDhmOwFh607jsCg5+vWlVck5HNPVXc4CED1qVLF5GBLYxyfp6Urj5SuxWNdzn5c9qmiDTKGUYB9anEMKjDDd7Gn+Z2jX6VLZaiJFZpGS8zZPapftBaN47dcEfdb0pBA0g/eE49qnRVRQFXAHf1qGylEbFAeDK25jzj0qyCEwBwKj3baQyDv1qdyrE5f07d6UuFHNVTMMVWmmeXKhsKRzVKINottOHYhe3WpTMI0UkYrOE6xHaOWIzURee5IaTgggbR26VSRDZNNcmXlRgk/pmnQARkMq9cUyKERfMx3E8/SrKxjf+++UDqB/Km2TYa7tJ8/CnB47E+tWMou1YSSmOCepqILk5I+UDgUm7jA4wakZY3eWMJy/Qe1RRQi3meWRi8r8/QelNDFQQvX19KFzvUscnoTTRLNmykLoCetWccmqGnMDHuHRjWlgcVM0ShmO1Jtx0qXbSbc1AEeM0hFSFeaCvrQFyLGBzTHOOKn281XnO0Z9KqKApXt8luh8w4B4Pt2z+talp4ht7WxzJAdoPLeg7VgXUlkku+cmRyMFB6Z/+vVLVNQnu4BbiMRxcDC8E9P6it0hOx//2Q==", "ImageInfo": [{ "Height": 640, "Length": 9998, "Offset": 0, "Type": 1, "Width": 368 }, { "Height": 576, "Length": 23548, "Offset": 9998, "Type": 2, "Width": 448 } ], "Method": 43, "OfflineState": 0, "OpenDoorStatus": 1, "OpenDoorType": "Face", "ReaderID": "1", "RealUTC": 1778778916, "RecNo": 0, "Result": 0, "SN": "SAZM5000908Z8", "ShortNumber": "", "Similarity": 0, "SnapPath": "/var/tmp/white_part11.jpg", "Status": 0, "Type": "Entry", "UTC": 1778778916, "UserID": "", "UserType": 0 }, "Index": 0, "PhysicalAddress": "54:6c:ac:4a:07:ce" } ], "FilePath": "/SnapShotFilePath/2026-05-14/14/15/0_20260514141518441.jpg", "Time": "14-05-2026 14:15:18" } ``` {% endcode %} ### Ativação por API #### Requisição - GET `http://192.168.1.201/cgi-bin/configManager.cgi?action=setConfig&Intelbras_ModeCfgII.OnlineAuthServer.FaceDetection=true` | param | type | description | | ------------------ | ------ | ---------------------------------------------------------------------- | | `setConfig` \* | Number | Comando de Definir Configuração | | `FaceDetection` \* | Bolean |

true: habilitar
false: desabilitar

| #### Exemplo de Retorno - *text/plain* ```sh OK ``` {% hint style="warning" %} Ao ativar a função de Detecção Facial, o administrador estará concordando com os Termos de Uso, conforme apresentados na inicialização do equipamento. {% endhint %} ### Ativação pela interface web Para ativar a função via interface web, acesse o menu Rede>Config. Plataforma>Modo Online 2.0:
{% hint style="warning" %} Ao ativar a função de Detecção Facial, o administrador estará concordando com os Termos de Uso, conforme apresentados na inicialização do equipamento. {% endhint %} --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://portal-integracao.intelbras.com.br/linha-de-faciais/modo-online/modo-online-2.0/deteccao-facial.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.