DOMOCAM Integration (HQVT Monitoring)
The DOMOCAM integration connects ACCELERO to DOMOCAM cameras with facial recognition. The devices identify people, and ACCELERO receives these events in real time, records them, generates access logs, and triggers notifications (pop-up, e-mail, Telegram, and MQTT) according to the event type and the camera's alert level.
This integration is provided as a plugin (hqvt, internally identified as HQVT) and must be installed and enabled by the IONGRADE technical team. Contact support to check compatibility with your ACCELERO version.
Current plugin version: 2.1.0 — compatible with ACCELERO 2.17.0 or higher.
What the integration does
With the plugin active, the DOMOCAM cameras begin to communicate with ACCELERO. The system synchronizes people's facial templates to the devices and receives back the recognition events, transforming them into access records and logs.
| Feature | What happens in ACCELERO |
|---|---|
| Device registration | Each DOMOCAM camera is registered as a device with IP, port, credentials, communication gateway, and associated area |
| Facial template synchronization | People's photos (according to the configured categories) are sent to the cameras for recognition |
| Event reception | Known person, blocked person, and unknown person are received and stored as DOMOCAM events |
| Access log generation | Each recognition event generates an access log in ACCELERO, passing through the access verification rule |
| Real-time monitoring | A monitor screen that displays events as they arrive, with the captured image |
| Notifications | Pop-up to the operator, e-mail, Telegram, and MQTT, filtered by event type and alert level |
| Last seen | Records in the person's registration the time and the device of the last identification |
It turns DOMOCAM facial recognition cameras into access control points integrated with ACCELERO, with centralized logs, monitoring, and alerts.
Configuration
Navigation path: Settings > Integrations - DOMOCAM
The screen is organized into tabs: Facial devices, Gateways, Settings, Synchronize templates, and Clear storage.
Integrations - DOMOCAM screen showing the Facial devices, Gateways, Settings, Synchronize templates, and Clear storage tabs.
Settings tab
Defines the notification and storage behavior.
Settings tab of the DOMOCAM screen, with the pop-up event fields, notification switches (Telegram, e-mail, MQTT), categories, and disk space size.
| Field | Description |
|---|---|
| Which event should generate an alert Pop-up? | Multi-selection of the event types that generate an alert pop-up to the operator: Access allowed, Access blocked, and Access denied |
| Do you want to receive notifications on Telegram? | Enables sending notifications via Telegram |
| Do you want to receive notifications by e-mail? | Enables sending notifications by e-mail |
| Do you want to receive notifications by MQTT? | Enables publishing notifications via MQTT on the topic `{FACILITY}/io/domocam/{DEVICEID}/{known,unknown,blocked}` |
| Categories | Categories of people whose facial templates are synchronized with the devices |
| Categories for automatic removal | Categories whose templates are automatically removed from the devices |
| Automatic removal exception | Categories that are left out of automatic removal |
| Size of the space reserved for DOMOCAM images (MB) | Disk space reserved for the images captured by the events |
When the storage limit is reached, the system automatically removes the oldest image when saving a new one, keeping disk usage under control.
Synchronize templates tab
Allows manually sending the facial templates to the selected devices.
Synchronize templates tab with the device selection and the buttons for test send, template send, and registration removal.
| Button | Function |
|---|---|
| Test send | Runs a simulated send (dry-run) to validate the communication before the actual send |
| Send templates | Synchronizes the facial templates of the eligible people to the selected devices |
| Remove all registrations | Deletes all facial registrations from the selected devices |
Clear storage tab
Deletes all images stored by the DOMOCAM events.
The storage cleanup cannot be undone. The button requires captcha confirmation before executing.
Registering DOMOCAM devices
Navigation path: Settings > Integrations - DOMOCAM > Facial devices
Each DOMOCAM camera is registered as a device. The list allows creating, editing, searching, and deleting devices.
List of DOMOCAM devices (columns Description, IP address, Port, Active, and Actions) and the inline registration form.
Device fields
| Field | Description |
|---|---|
| Description | Identification name of the device |
| Active | Defines whether the device is active (only active devices synchronize templates) |
| IP address | IP of the DOMOCAM camera |
| Port | Communication port |
| Gateway | Communication gateway responsible for mediating the message exchange with the camera |
| User | Access user for the camera |
| Password | Access password (leave blank to not change existing data) |
| Device ID | Identifier of the device on the DOMOCAM camera |
| What is the location of the DOMOCAM? | Area associated with the device — used for the access log and updating the person's location |
| What is the desired alert level? | Alert level of the camera: light, medium, or high — used to filter which operators receive notifications |
| Update area | When active, the recognition updates the person's current area to the camera's area |
| Synchronize only categories | Restricts template synchronization to specific categories on this device |
The DOMOCAM camera communicates with ACCELERO through a gateway (configured on the Gateways tab). Register the gateway before associating it with the device.
Fields added to the entities
The plugin extends the Person registration and the Operator registration with DOMOCAM-specific data.
Person
In the person registration, the plugin adds the field:
| Field | Description |
|---|---|
| DOMOCAM - Person status | Status of the person used by the DOMOCAM recognition (defines whether the person is treated as blocked in the recognition) |
Person registration showing the DOMOCAM - Person status field.
Operator
In the operator registration, the plugin adds the Domocam section:
| Field | Description |
|---|---|
| Telegram | Telegram user (@) that receives the notifications |
| What is the desired alert level? | Multi-selection of the alert levels (light, medium, high) that the operator wants to receive by e-mail/Telegram |
Domocam section in the operator edit screen, with the Telegram and alert level fields.
An operator only receives the notification of a camera if the alert level configured on the camera is among the levels that the operator selected in their registration.
DOMOCAM Monitor
Path: side menu > DOMOCAM Monitor
Monitoring screen that displays the recognition events as they arrive, in real time.
Monitor DOMOCAM events screen, with the start/stop monitoring button, the filters, and the event list with the captured image.
How it works
- Click Monitor to start receiving events in real time. The button changes to Stop monitoring.
- Each new event appears at the top of the list with the data and the captured image. The list keeps the last events received.
- Blocked person events are highlighted in red; unknown person events, in yellow.
Filters
| Filter | Description |
|---|---|
| Devices | Filters by one or more DOMOCAM cameras |
| Event Type | Filters by recognition event type |
The Save filters button stores the filter preference in the browser, so that it is reapplied on the next visit.
Data displayed per event
Event type, time, similarity, name, device name, and the captured image.
DOMOCAM Log
Path: side menu > DOMOCAM Log
Complete history of all DOMOCAM events received, with filters and detailing.
DOMOCAM Log screen, with the event list (Date/time, Type, Metadata) and the filters.
Filters
| Filter | Description |
|---|---|
| Group | Recognition event type |
| Devices | One or more DOMOCAM cameras |
| Person name | Search by the person's name |
| Start date/time and End date/time | Selection by period |
Columns
Date and time, type, metadata (serialized event data), and actions.
Event detailing
When opening an event, ACCELERO displays: event type, time, similarity, name, device name, person ID, and the captured image.
Event types
DOMOCAM cameras send different event types. ACCELERO classifies them as follows:
| Type (label on the screen) | Meaning |
|---|---|
| Known person | Person recognized and with access allowed |
| Blocked person | Person recognized, but marked as blocked |
| Unknown person | Capture of a face not identified in the registration |
The cameras also send keep-alive (heartbeat) messages to signal that they are online. These signals are recorded as events of the HeartBeat type, but they do not generate an access log or a notification.
How events become access logs
When a DOMOCAM camera recognizes a person, ACCELERO automatically generates an access log:
- The system identifies the person from the data sent by the camera.
- If the person is not found in the registration, the Access denied - Unknown DOMOCAM person log is generated.
- If the person is found, ACCELERO applies the access verification rule to the device's area:
- Access authorized → generates the Access authorized - DOMOCAM log and, if the device has Update area active, updates the person's current area.
- Access not authorized → generates the log with the corresponding denial code.
The DOMOCAM device is treated as a virtual control channel: the area associated with the camera is used as the access destination, and the verification follows the same ACCELERO access rules.
Notifications
For each eligible event, the plugin can trigger notifications through different channels. The sending depends on the options enabled on the Settings tab and on the filter by event type and alert level.
| Channel | When it triggers |
|---|---|
| Pop-up | For the event types marked in "Which event should generate an alert Pop-up?" |
| When enabled; sent to the operators whose alert level matches that of the camera | |
| Telegram | When enabled; sent to the operators with Telegram configured |
| MQTT | When enabled; published on the topic `{FACILITY}/io/domocam/{DEVICEID}/{known,unknown,blocked}` |
Example of the notification e-mail "Security event detected DOMOCAM!" received by an operator.
Configure critical cameras with a high alert level and, in the operators' registration, select which levels each one should receive. This way, an event from a high-risk camera only notifies those who need to be alerted.
Use cases
Enable a DOMOCAM camera
- Request the installation of the
hqvtplugin from IONGRADE. - In
Settings > Integrations - DOMOCAM, register the communication gateway. - On the Facial devices tab, register the camera (IP, port, credentials, Device ID, area, and alert level).
- On the Settings tab, select the categories whose people should be recognized and adjust the notifications.
- On the Synchronize templates tab, use Test send and then Send templates.
- Track the DOMOCAM Monitor to validate the arrival of the events.
Investigate a denied access
- Access DOMOCAM Log and filter by the person and the period.
- Open the event to see the type, similarity, device, and the captured image.
- Check whether the person is in the registration, linked to a synchronized category, and whether the area's access rule allows entry.
Track the entrance in real time
- Open DOMOCAM Monitor and click Monitor.
- Optionally, filter by devices and event types and save the preference.
- Track the recognitions: blocked (red) and unknown (yellow) get highlighted.
Best practices
- Specific categories: synchronize only the categories of people who should be recognized by the cameras, avoiding sending unnecessary templates to the devices.
- Gateway before the device: register and validate the communication gateway before associating the camera.
- Test before the actual send: use Test send (dry-run) before synchronizing the templates for real.
- Consistent alert levels: standardize the use of levels (light/medium/high) between cameras and operators so that the notifications reach those who need them.
- Storage control: adjust the size of the space reserved for images according to the event volume, remembering that the oldest images are removed when the limit is reached.
Troubleshooting
Events do not appear in the Monitor
Possible causes:
- Communication gateway offline or misconfigured
- Device inactive or with incorrect IP/port/credentials
- Browser incompatible with real-time monitoring
Solution:
- Check the gateway status on the Gateways tab.
- Confirm the IP, port, user, password, and Device ID in the device edit screen.
- Confirm that the device is Active.
Recognitions do not generate an access log
Possible causes:
- The person is not in the ACCELERO registration (generates "Access denied - Unknown DOMOCAM person")
- The person is not linked to a synchronized category
- The area's access rule denies entry
Solution:
- Confirm the person's registration and the category link.
- Check the area associated with the device and the access rule of that area.
- Resend the templates via the Synchronize templates tab.
Operator does not receive notifications
Possible causes:
- Notification channel (e-mail/Telegram/MQTT) disabled on the Settings tab
- The camera's alert level is not among those selected by the operator
- The event type is not marked to generate a pop-up
Solution:
- Check the notification switches on the Settings tab.
- Check the camera's alert level and the levels selected in the operator's registration.
- For the pop-up, confirm the event type in "Which event should generate an alert Pop-up?".
Integration with other modules
People and Categories
Template synchronization depends on the registration of People (with a facial photo) and on the category configuration. Only people of the selected categories have their templates sent to the cameras.
Areas
Each device is associated with an Area, which defines the access destination and can be updated as the person's current location when the recognition occurs.
Logs and Events
Each recognition generates an access log. See Logs and Monitoring to understand how these events appear in the access history.
Next Steps
- People — Register the people with a facial photo and the DOMOCAM status
- Areas — Associate each camera with a destination area
- Logs and Monitoring — Track the logs generated by the recognitions
- Plugins — Learn more about ACCELERO's plugin system