Back to Documentation

    Notifications

    Configure email, Teams, Telegram, NTFY.SH, and webhook notifications for your events

    E-Mail

    To enable email notifications, you need to configure the SMTP settings and define recipients. You can specify which tenants should send event notifications and filter notifications by event severity directly within the sensors. Additionally, in each sensor and other relevant features, you have the option to refine the conditions under which an event notification should be triggered.

    SMTP Settings

    Note that these emails are dispatched by the NetLock RMM server's "Notification" role, not the web console itself. Make sure to account for this in your firewall settings to allow outgoing traffic from the server role responsible for sending notifications.

    Username

    This field represents the username of your email account, for example: noreply@netlockrmm.com

    Password

    Your SMTP password

    Server

    Your SMTP server

    Port

    Your SMTP port

    SSL/TLS

    Depending on your email server's configuration, you may need to enable SSL/TLS for secure communication

    Test Your Configuration

    To verify that your configuration is correct, use the "Test" button. If the test is successful, you'll see a confirmation message and receive a test email.

    Add & Edit

    E-Mail

    The recipient's email address

    Description

    For your internal purposes

    Severity

    Notifications will only be sent if an event meets the defined severity level

    Tenants

    Select the tenants from which you want to receive event notifications

    How to Add a New Notification

    1

    Navigate to Notifications

    In the left menu bar, scroll down to Notifications and select E-Mail

    2

    Configure SMTP Settings

    Click SMTP Settings and enter your SMTP credentials. Test the connection to ensure your configuration is correct

    3

    Click Add

    Click the Add button located to the left of the SMTP Settings button

    4

    Enter email address

    Enter the email address where you want to receive alerts

    5

    Add description (Optional)

    Provide a description for easier identification

    6

    Select severity level

    Choose the severity level you want to receive alerts for

    7

    Enable Uptime Monitoring (Optional)

    If you want to receive alerts for devices that go offline, enable Uptime Monitoring

    8

    Select tenants

    Drag the tenants you want to receive notifications for into the Selected Tenants section

    9

    Save configuration

    Click Save to apply your configuration

    Microsoft Teams

    To enable Microsoft Teams notifications, you'll need to set up connectors. For instructions on creating an incoming webhook connector, refer to Microsoft's documentation:

    Add & Edit

    Connector Name

    Your connector's name for internal purposes

    Connector-Webhook-URL

    The webhook URL of your connector

    Description

    For your internal purposes

    Severity

    Notifications will only be sent if an event meets the defined severity level

    Tenants

    Select the tenants from which you want to receive event notifications

    Telegram

    To enable Telegram notifications, you'll need to set up a Telegram Bot. For instructions refer to Telegram's documentation:

    Add & Edit

    Bot Name

    Your bot's name for internal purposes

    Bot-Token

    The bot's token/API key

    Chat-ID

    The ID of the chat you want to receive the messages to

    Severity

    Notifications will only be sent if an event meets the defined severity level

    Tenants

    Select the tenants from which you want to receive event notifications

    NTFY.SH

    To enable NTFY.SH notifications, you'll need to set up a topic URL and optionally an access token. For instructions refer to NTFY.SH documentation:

    Add & Edit

    Topic Name

    Your topic's name for internal purposes

    Topic URL

    The topic's URL

    Access Token

    If required, you can add your access token here

    Severity

    Notifications will only be sent if an event meets the defined severity level

    Tenants

    Select the tenants from which you want to receive event notifications

    Webhooks

    To enable Webhook notifications, you need to configure a webhook URL, HTTP method, request body, and optionally request headers.

    Available Variables

    You can use the following variables in your request body to include dynamic event information:

    $netlock_tenant_name
    $netlock_location_name
    $netlock_device_name
    $netlock_date
    $netlock_reported_by
    $netlock_event
    $netlock_description

    These variables will be automatically replaced with actual values when the webhook is triggered:

    • $netlock_tenant_name – The name of the tenant where the event occurred

    • $netlock_location_name – The location associated with the device or event

    • $netlock_device_name – The name of the device that triggered the event

    • $netlock_date – The exact date and time when the event occurred

    • $netlock_reported_by – The event type that reported the event

    • $netlock_event – The type or category of the event that occurred

    • $netlock_description – A detailed description of the event, if available

    Add & Edit

    Name

    Your webhook's name for internal purposes

    Description

    Optional description of the webhook's purpose

    URL

    The webhook endpoint URL (e.g., https://example.com/webhook)

    Method

    HTTP method to use (GET, POST, PUT, DELETE, PATCH)

    Request Body

    JSON payload to send (can include variables)

    Request Headers

    Custom HTTP headers (e.g., Content-Type, Authorization)

    Severity

    Notifications will only be sent if an event meets the defined severity level

    Tenants

    Select the tenants from which you want to receive event notifications

    Uptime Monitoring

    If enabled and Disconnection Alert is active in the device overview, the event will be forwarded

    Example Request Body

    JSON
    {
      "tenant": "$netlock_tenant_name",
      "device": "$netlock_device_name",
      "event": "$netlock_event",
      "timestamp": "$netlock_date",
      "message": "Alert from device $netlock_device_name in tenant $netlock_tenant_name"
    }

    Example Request Headers

    JSON
    {
      "Content-Type": "application/json",
      "Authorization": "Bearer your-token-here"
    }

    Testing Webhooks

    Use the "Test Webhook" button to verify your configuration before saving. This will send a test request to your webhook endpoint and display the response status.