Prerequisites
✅ Checklist to start without blockers
- You must have a verified WhatsApp account.
- You must have the Terms and Conditions PDF (public URL) to configure in the agent. This is mandatory.
- The user must be able to take photos from the chat (camera permissions enabled on the device).
- Location permissions are also requested so data can be collected for better audit and traceability of the biometric process.
How does it work?
In under one minute, the user completes these steps:Access via a unique link
Take a photo
Capture their ID document
Automatic facial comparison
How to connect the integration?
How to connect the Biometrics integration
Open the platform
Select Biometrics
Connect the integration
Configure outputs
- Text input with a custom message.
- Connect, only if you have this module.
Run tests
Configuration
- Outputs
Success
Biometrics approved
Biometrics approved
approvedDescription: Biometrics approvedResponse structure (JSON):document_response: ID document informationliveness_response: Photo used for livenessfacematch_response: Facial comparison resultreporte_de_biometria: Report URLs (web and PDF)device_info: Device and location data (audit and traceability)gov_entity_data: Government entity data (if applicable)
- document_response:
document_check(result, verified_fields, secondary_fields, details, status_fields, image_quality_details, images_extracted, gov_entity_fields),document_image_front_url,document_image_back_url,document_face_image_url - liveness_response:
result,url_selfie_image - facematch_response:
facematch_result(approved/decline),facematch_confidence - reporte_de_biometria:
report,report_pdf - device_info:
userAgent,browser,operatingSystem,platform,language,timezone,screenResolution,colorDepth,timestamp,ipAddress,location(latitude, longitude; only if location permission),deviceId,deviceName - gov_entity_data: government entity data for the country (fields vary by country)
Errors
Process abandoned
Process abandoned
incompleteDescription: Process abandonedBiometrics rejected
Biometrics rejected
rejectDescription: Biometrics rejectedProcess error
Process error
errorDescription: Process errorReport
By default a report is generated with the following fields:How to customize the experience?
When you click the Biometrics node on the canvas, a side panel opens with three configuration tabs.General
General
Variable: Maximum document verification attemptsDescription: Defines how many times the user can retry the document capture.Input: 1, 2, or 3
Experience
Experience
#1E7A4C)Variable: Experience languageDescription: Defines the default UI language the user sees when the process starts.Input: Spanish, English, or Portuguese
Variable: Language toggleDescription: A button is enabled in the user interface that lets the user change the language.Input: Enabled / Disabled.
Validations
Validations
Document verification
Controls how strict the ID document analysis is. Choose from three levels:More about the elements analyzed
More about the elements analyzed
Facial comparison
Variable: Facial comparison (facematch)Description: Defines the minimum similarity percentage accepted between the liveness selfie and the face extracted from the document.Input: Low (65%), Standard (80%), or Strict (90%). The threshold is 100% configurable per company; the default value is 70%.Terms and conditions URL
Variable: Terms and conditions URLDescription: The user must accept the terms on the initial screen before starting the process.Input: Public URL (the link must be publicly accessible)FAQ
What document images are required during the biometric process?
What document images are required during the biometric process?
How is WebView biometrics different from Flows or conversational?
How is WebView biometrics different from Flows or conversational?
Can I customize colors and UI language?
Can I customize colors and UI language?
How many outputs does this agent have?
How many outputs does this agent have?