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 @WallarmBot (if you are using the Wallarm EU Cloud) or @WallarmUSBot (if you are using the Wallarm US 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 ensure the settings are correct.

  9. Click Add integration.

    Telegram integration

You can also start the chat with @WallarmBot or @WallarmUSBot 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 your Wallarm account → SettingsIntegrations in the EU or US 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 your Wallarm account → SettingsIntegrations in the EU or US cloud.

  2. Open an active integration and click Disable.

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

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 your Wallarm account → SettingsIntegrations in the EU or US cloud.

  2. Open integration and click Delete.

  3. Confirm the action.