Coleta de Dados de Monitoramento

Implementação opcional

A Coleta de Dados de Monitoramento é opcional. Se você a adotar, apenas a chamada prepareSelfieCamera é afetada — todas as outras etapas do fluxo de captura (inicialização, callbacks, tratamento do resultado) permanecem inalteradas.

Não precisa da câmera?

Esta página cobre setSilentInfo, que só tem efeito junto com uma chamada prepareSelfieCamera/prepareDocumentCamera. Se você quer validação silenciosa sem nunca abrir uma sessão de câmera (ex.: uma tela de login), use initializeSDK + startSilentValidation em vez disso — veja Revalidação Silenciosa. Os dois podem ser usados na mesma página.

Anexe metadados de usuário e fluxo a uma sessão de captura para que ela possa ser correlacionada em ferramentas de monitoramento e observabilidade do lado da Unico, e para que o backend possa considerá-los no resultado da Revalidação Silenciosa dessa transação. Quando fornecidos, os dados são encaminhados junto com a captura e não alteram o comportamento de captura do SDK — mas afetam sim a resposta de Criar Processo: veja silentAuth.result em Revalidação Silenciosa.

setSilentInfo parameters

Parâmetro	Tipo	Obrigatório	Descrição
`externalUserId`	`String`	✅	Identificador do usuário no seu sistema. Automaticamente hasheado com SHA-256 antes da transmissão — nunca enviado em texto simples.
`useCase`	`String`	—	Identificador do fluxo ou contexto em execução (ex.: `"account_opening"`, `"password_recovery"`). Transmitido em texto simples.

Implementation

Chame setSilentInfo na instância da câmera construída antes de chamar prepareSelfieCamera. Todo o restante do fluxo de captura permanece igual.

import { UnicoCheckBuilder, UnicoConfig, SelfieCameraTypes, SDKEnvironmentTypes } from "@acesso-io/unico-webframe";

const config = new UnicoConfig()
  .setHostname("<YOUR_HOSTNAME>")
  .setHostKey("<YOUR_HOST_KEY>");

const unicoCamera = new UnicoCheckBuilder()
  .setEnvironment(SDKEnvironmentTypes.UAT)
  .build();

unicoCamera.setSilentInfo("external_user_id", "flow_id");

await unicoCamera.prepareSelfieCamera(config, SelfieCameraTypes.SMART);