Skip to main content
Version: 1.0

Notification methods

Overview​

Notification methods define the channels through which ToBeAlert delivers alert messages to recipients. These methods include commonly used communication platforms such as email, Telegram, WhatsApp, and more.

By supporting multiple delivery options, ToBeAlert ensures that alerts can reach the right people, through the right medium, at the right time. Each method can be configured individually to match organizational preferences and technical requirements, enabling flexible and reliable alert distribution.

Creating and managing notification methods​

Notification methods

Email​

The Email notification method delivers alerts directly to users’ inboxes, providing a widely supported and easy-to-configure communication channel. It supports subject and body customization through templates, allowing clear and actionable messages to be sent in real time.

Creating an email notification method​

To create an email notification method:

  1. Click on the Create Method button
  2. Give the method a name and select "Email" as the method
  3. Fill the required information
  4. Test the notification to ensure it works (optional)
    • Enter an email and click the Test Notification button
  5. Save the method configuration

Email properties​

PropertyDescription
SMTP HostThe address of the mail server used to send outgoing emails
SMTP PortThe network port through which the SMTP server communicates
Enable SSLEnables SSL encryption for secure email transmission
Use Start TLSInitiates encryption using the STARTTLS command over an unencrypted connection
UsernameThe account name used to authenticate with the SMTP server
PasswordThe corresponding password for SMTP authentication
StatusWhether the method is enabled or disabled

Email method

Telegram​

The Telegram notification method sends alerts through Telegram bots, making it suitable for teams that rely on this platform for internal communication. Notifications can be directed to individual users or group chats for collaborative incident response.

Creating a Telegram notification method​

To create a Telegram notification method:

  1. Click on the Create Method button
  2. Give the method a name and select "Telegram" as the method
  3. Create a bot using @BotFather on Telegram
  4. Fill the required information
  5. Test the notification to ensure it works (optional)
    • Click the Test Notification button
  6. Save the method configuration

Telegram properties​

PropertyDescription
Bot TokenThe authentication token provided by Telegram when creating a bot
Default Chat IDThe unique identifier of the user or group chat where notifications will be sent

Telegram method

WhatsApp​

The WhatsApp notification method enables alerts to be sent via the WhatsApp messaging platform, offering a fast and accessible way to reach on-call staff or mobile users.

Rest API​

The REST API method allows alerts to be pushed to external systems via HTTP requests. This flexible integration approach supports custom headers, authentication, and payload formatting, enabling seamless interaction with third-party tools and automation platforms.

Custom​

Custom notifications can be configured so that they execute user-defined scripts in response to alert events. This enables full control over the notification behavior and is ideal for complex or highly specific delivery scenarios.

Best practices​

For effective notification method management:

  1. Choose channels based on urgency – Use instant messaging platforms for critical alerts, and email or API calls for less time-sensitive notifications.
  2. Avoid overload – Limit notifications to essential recipients to reduce alert fatigue and ensure that critical messages are not missed.
  3. Ensure reliability – Test each notification method during setup and periodically thereafter to confirm messages are being delivered as expected.
  4. Use fallback methods – Configure multiple notification methods where possible to ensure redundancy in case one channel fails.
  5. Format for readability – Adapt message templates to suit each delivery channel’s format and limitations, ensuring clarity and relevance.