Notifier

A notifier object represents a notification channel integrated into Netsocs. Its function is to send messages or alerts to external recipients (users, messaging systems, third-party services) through whatever mechanism the driver implements: email, SMS, mobile push, Telegram, Slack, webhooks, etc.

Think of the notifier as the "messenger" of the ecosystem. It does not observe or control the environment: its sole responsibility is to dispatch a notification when instructed, and report whether delivery succeeded or failed.

Main characteristics

• On-demand delivery: It only acts upon receiving the create action; it never generates notifications on its own.
• Rich content: The payload supports a title, message, multimedia attachments (images, audio, video), and a specific target recipient.
• Traceability: Each notification can include a notification_id to correlate the delivery with other system events.
• Visible lifecycle: States allow detecting whether the notifier is free, processing, or in error, and responding accordingly from automations.

Common use cases

• Sending security alerts to operators when a sensor detects an anomaly.
• Push notification to a user when access to a door is granted.
• Automatic reports generated by scheduled automations.
• Integration with enterprise messaging platforms (Slack, Teams, Telegram).
• Incident escalation when a system enters an error state.

States

State	Description
notify.state.unknown	Initial unknown state; the notifier has not operated yet.
notify.state.idle	The notifier is ready to receive a create action.
notify.state.busy	A notification is currently being sent.
notify.state.error	The last send attempt failed.

Actions

Action	Description
create	Sends a notification with the content specified in the payload.

create action payload

Field	Type	Required	Description
message	string	Yes	Main text of the notification.
title	string	No	Title or subject of the notification.
notification_id	string	No	Identifier to correlate the notification with other system events.
target	string	No	Specific recipient (user, channel, phone number, etc.).
data.image_urls	[]string	No	List of attached image URLs.
data.audio_urls	[]string	No	List of attached audio file URLs.
data.video_urls	[]string	No	List of attached video URLs.