Skip to main content

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.

Availability

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.

Compatibility

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.

FeatureWhat happens in ACCELERO
Device registrationEach DOMOCAM camera is registered as a device with IP, port, credentials, communication gateway, and associated area
Facial template synchronizationPeople's photos (according to the configured categories) are sent to the cameras for recognition
Event receptionKnown person, blocked person, and unknown person are received and stored as DOMOCAM events
Access log generationEach recognition event generates an access log in ACCELERO, passing through the access verification rule
Real-time monitoringA monitor screen that displays events as they arrive, with the captured image
NotificationsPop-up to the operator, e-mail, Telegram, and MQTT, filtered by event type and alert level
Last seenRecords in the person's registration the time and the device of the last identification
Main benefit

It turns DOMOCAM facial recognition cameras into access control points integrated with ACCELERO, with centralized logs, monitoring, and alerts.

Configuration​

Navigation path: Settings > DOMOCAM

DOMOCAM screen with the Facial recognition, Gateways, Settings, Synchronize templates, and Clear storage tabs

The screen is organized into tabs: Facial recognition, Gateways, Settings, Synchronize templates, and Clear storage.

Settings tab​

Defines the notification and storage behavior.

Settings tab of the DOMOCAM screen with the pop-up events, notification switches, categories, and the space reserved for images

FieldDescription
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}`
CategoriesCategories of people whose facial templates are synchronized with the devices
Categories for automatic removalCategories whose templates are automatically removed from the devices
Automatic removal exceptionCategories 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
Storage space

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 two DOMOCAM devices selected and the Test template sending, Resend templates, and Delete all buttons

ButtonFunction
Test template sendingCounts how many templates would be sent, without sending them (dry-run)
Resend templatesSynchronizes the facial templates of the eligible people to the selected devices
Delete allDeletes all facial registrations from the selected devices

Clear storage tab​

Deletes all images stored by the DOMOCAM events.

Irreversible action

The storage cleanup cannot be undone. The button requires captcha confirmation before executing.

Registering DOMOCAM devices​

Navigation path: Settings > DOMOCAM, Facial recognition tab

Each DOMOCAM camera is registered as a device. The list allows creating, editing, searching, and deleting devices.

Facial recognition tab with the inclusion form open and the list of DOMOCAM devices

The inclusion form (New device button) asks for description, IP, port, gateway, user, password, and Device ID. Location, alert level, Update area, and Synchronize only the categories are on the device edit screen.

Device fields​

FieldDescription
DescriptionIdentification name of the device
ActiveDefines whether the device is active (only active devices synchronize templates)
IP addressIP of the DOMOCAM camera
PortCommunication port
GatewayCommunication gateway responsible for mediating the message exchange with the camera
UserAccess user for the camera
PasswordAccess password (leave blank to not change existing data)
Device IDIdentifier 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 alert level, Medium alert level, or High alert level. It is used to filter which operators receive notifications
Update areaSwitch shown on the device record. See the note below about the behavior in version 2.1.0
Synchronize only the categoriesRestricts template synchronization to specific categories on this device
Communication gateway

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:

FieldDescription
DOMOCAM - Person statusAllowed or Blocked. Defines whether the person is treated as blocked in the DOMOCAM recognition

DOMOCAM - Person status field on the General data tab of the person record, set to Blocked

Operator​

In the operator registration, the plugin adds the Domocam section:

FieldDescription
Telegram userTelegram 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 on the operator edit screen, with the Telegram user and the medium and high alert levels

Filter by alert level

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​

Navigation path: Logs > Monitor DOMOCAM

Monitoring screen that displays the recognition events as they arrive, in real time.

Monitor DOMOCAM events running, with an unknown person event in yellow, a blocked person event in red, and a known person event

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 images: the person's registration photo and the image captured by the camera, side by side. The list keeps the last events received.
  • Blocked person events are highlighted in red; unknown person events, in yellow.

Filters​

The filters are under the Filters... button.

FilterDescription
DevicesFilters by one or more DOMOCAM cameras
Event TypeFilters by recognition event type
Save filters

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​

Navigation path: Logs > Log DOMOCAM

Complete history of all DOMOCAM events received, with filters (Search button) and detailing.

DOMOCAM Log with unknown, blocked, and known person events and the Metadata column

Filters​

FilterDescription
GroupRecognition event type
DevicesOne or more DOMOCAM cameras
Person nameSearch by the person's name
Start date/time and End date/timeSelection 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 personPerson recognized and with access allowed
Blocked personPerson recognized, but marked as blocked
Unknown personCapture of a face not identified in the registration
Heartbeat

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:

  1. The system identifies the person from the data sent by the camera.
  2. If the person is not found in the registration, the Access denied - Unknown DOMOCAM person log is generated.
  3. 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 updates the person's current area to the camera's area.
    • Access not authorized → generates the log with the corresponding denial code.
Update area in version 2.1.0

In the current plugin code, the person's current area is updated on every authorized access, even with the Update area switch turned off on the device. Keep this in mind when placing cameras in areas that should not change occupancy.

Camera as a control point

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.

ChannelWhen it triggers
Pop-upFor the event types marked in "Which event should generate an alert Pop-up?"
E-mailWhen enabled; sent to the operators whose alert level matches that of the camera
TelegramWhen enabled; sent to the operators with Telegram configured
MQTTWhen enabled; published on the topic `{FACILITY}/io/domocam/{DEVICEID}/{known,unknown,blocked}`
TODO: Add Screenshot

Example of the notification e-mail "Security event detected DOMOCAM!" received by an operator. Pending: in version 2.1.0 the generated body comes out with an empty Device name (the plugin looks the device up by its name instead of its ID) and with a leftover %%MESSAGE%% placeholder at the end.

Targeting by alert level

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​

  1. Request the installation of the hqvt plugin from IONGRADE.
  2. In Settings > DOMOCAM, register the communication gateway.
  3. On the Facial recognition tab, register the camera (IP, port, credentials, Device ID, area, and alert level).
  4. On the Settings tab, select the categories whose people should be recognized and adjust the notifications.
  5. On the Synchronize templates tab, use Test template sending and then Resend templates.
  6. Track the DOMOCAM Monitor to validate the arrival of the events.

Investigate a denied access​

  1. Access DOMOCAM Log and filter by the person and the period.
  2. Open the event to see the type, similarity, device, and the captured image.
  3. 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​

  1. Open DOMOCAM Monitor and click Monitor.
  2. Optionally, filter by devices and event types and save the preference.
  3. 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 template sending (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:

  1. Check the gateway status on the Gateways tab.
  2. Confirm the IP, port, user, password, and Device ID in the device edit screen.
  3. 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:

  1. Confirm the person's registration and the category link.
  2. Check the area associated with the device and the access rule of that area.
  3. 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:

  1. Check the notification switches on the Settings tab.
  2. Check the camera's alert level and the levels selected in the operator's registration.
  3. 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