Skip to content

Telegram

You can set up Wallarm to send scheduled reports and instant notifications to Telegram.

  • Scheduled reports can be sent on a daily, weekly, or monthly basis. Reports include detailed information about vulnerabilities, attacks, and incidents detected in your system over the selected period.

  • Notifications include brief details of triggered events:

    • System related: newly added users, deleted or disabled integration
    • Vulnerabilities detected
    • Scope changed: updates in hosts, services, and domains

Setting up integration

  1. Open the SettingsIntegrations tab.

  2. Click the Telegram block or click the Add integration button and choose Telegram.

  3. Add @WallarmUSBot (if you are using the Wallarm US Cloud) or @WallarmBot (if you are using the Wallarm EU Cloud) to the Telegram group receiving Wallarm notifications and follow the authentication link.

  4. After redirection to Wallarm UI, authenticate the bot.

  5. Enter an integration name.

  6. Choose the frequency of sending security reports. If the frequency is not chosen, then reports will not be sent.

  7. Choose event types to trigger notifications. If the events are not chosen, then notifications will not be sent.

  8. Test the integration and make sure the settings are correct.

  9. Click Add integration.

    Telegram integration

You can also start the chat with @WallarmUSBot or @WallarmBot directly. The bot will send reports and notifications as well.

Testing integration

Integration testing allows checking configuration correctness, availability of the Wallarm Cloud, and the notification format. To test the integration, you can use the button Test integration when creating or editing the integration.

The integration is tested as follows:

  • Test notifications with the prefix [Test message] are sent to the selected system.

  • Test integrations are sent for all events available for the selected system. If the integration card includes 3 event types, the system will receive 3 test notifications.

    If the integration card includes the event type System related, an appropriate test notification includes details on the newly added user.

  • Test notifications include test data.

The integration with Telegram can be tested only if this integration is already created. Test Telegram message:

[Test message] [Test partner] Network perimeter has changed

Notification type: new_scope_object_ips

New IP addresses were discovered in the network perimeter:
8.8.8.8

Client: TestCompany
Cloud: EU

Updating integration

To update the settings of active integration:

  1. Go to Wallarm Console → SettingsIntegrations in the US or EU Cloud.

  2. Open an active integration.

  3. Make required changes and click Save.

Disabling integration

To stop sending reports and notifications temporarily, you can disable the integration:

  1. Go to Wallarm Console → SettingsIntegrations in the US or EU Cloud.

  2. Open an active integration and click Disable.

To re-enable sending reports and notifications, open the disabled integration and click Enable.

Disabling the integration is the system event. If you receive system notifications, messages about disabled integration will be sent to the configured system.

Deleting integration

To stop sending reports and notifications permanently, you can delete the integration. Deleting an integration cannot be undone. The integration will be removed from the list permanently.

  1. Go to Wallarm Console → SettingsIntegrations in the US or EU Cloud.

  2. Open integration and click Delete.

  3. Confirm the action.

Deleting the integration is the system event. If you receive system notifications, messages about deleted integration will be sent to the configured system.