Skip to main content

Alert Message

The Alert Message plugin lets you register a free-text message on a person and display it as a pop-up on the operator's screen whenever that person is selected as a visitor in a visit event. It is a way to draw the operator's attention to important information about the visitor — restrictions, security notes, special instructions — at the exact moment of service.

Availability

This feature is delivered as a plugin (alert_message) and must be installed and enabled by the IONGRADE technical team. Contact support to check compatibility with your ACCELERO version.

Compatibility

Current plugin version: 0.0.10 — compatible with ACCELERO 2.16.0 and 2.16.1.

What the plugin does​

FeatureWhat happens in ACCELERO
Message field on the personAdds the Alert message field to the person record, where you write the text that should alert the operator
Pop-up during serviceWhen selecting that person as a visitor in a visit event, the registered message appears in a pop-up on the operator's screen
Main benefit

Ensures that relevant notices about a visitor actively appear to the operator at the moment of service, instead of relying on the operator looking for the information in the record.

Fields added to the entities​

Person​

The plugin adds the Alert message field to the person record (People > Edit).

FieldDescription
Alert messageFree text. When filled in, it will be shown as a pop-up to the operator whenever the person is selected as a visitor in a visit event. Leave it blank to not generate an alert
TODO: Add Screenshot

Person record (People > Edit) showing the new Alert message field filled in with example text.

Where the message is stored

The message is stored as additional data (metadata) of the person and follows the record. There is no automatic cleanup: the message remains until it is changed or deleted manually in the record.

How the pop-up triggers​

The alert is triggered for the operator during the quick editing of visit events.

  1. The operator opens a visit event and selects (or fills in) the visitor's data.
  2. When loading the person's data, ACCELERO also loads the Alert message registered for them.
  3. If there is a message, a pop-up is shown immediately on the operator's screen with the registered text.
  4. If the person has no alert message, nothing is shown.
TODO: Add Screenshot

Visit event editing screen with the Alert message pop-up shown over the visitor form.

Only in visits

The pop-up is triggered in the visit events flow (visitor selection). Registering the message in the person's profile does not, by itself, generate any pop-up outside this context.

Use cases​

Flag a restriction about a visitor​

  1. In People > Edit, locate the person.
  2. Fill in the Alert message field with the note (e.g. "Visitor must be accompanied throughout the stay").
  3. Save the record.
  4. The next time this person is selected as a visitor in an event, the operator will see the pop-up with the notice.

Remove an alert that is no longer needed​

  1. In People > Edit, locate the person.
  2. Delete the content of the Alert message field.
  3. Save the record — from then on, no pop-up will be shown for this person.

Best practices​

  • Short and objective messages: the pop-up should be read quickly by the operator at the moment of service. Prefer direct sentences.
  • Review periodically: since the message remains until it is removed manually, review old alerts to avoid outdated notices.
  • Use for actionable information: reserve the alert for situations that require an action or attention from the operator, not for general record notes.

Troubleshooting​

The pop-up does not appear for the operator​

Possible causes:

  • The person's Alert message field is empty.
  • The plugin is not enabled in this installation.
  • The person was not selected as a visitor in the visit event flow.

Solution:

  1. Confirm in People > Edit that the Alert message field is filled in and saved.
  2. Check with IONGRADE support whether the alert_message plugin is installed and active.
  3. Reproduce the service by selecting the person as a visitor in a visit event.

Integration with other modules​

People​

The message field is added directly to the People record and follows the person's record.

Events (Visits)​

The pop-up is triggered in the Events flow, when the visitor is selected during the editing of a visit.

Next Steps​

  • People — Register the alert message in the person's profile
  • Events — Understand the visit event flow where the pop-up is shown
  • Plugins — Learn more about the ACCELERO plugin system