Telegram Integration

Ennote allows you to integrate with Telegram to receive real-time notifications about events within your organization. This integration enables you to stay informed and respond quickly to critical situations by receiving alerts directly in your Telegram chat.

Setting up the Telegram Bot

Open Telegram and Search for BotFather

In your Telegram app, search for the user "BotFather". This is a special bot provided by Telegram for creating and managing other bots.

Create a New Bot

Start a chat with BotFather and use the `/newbot` command. Follow the prompts to provide a name and username for your bot. BotFather will generate a unique API token for your bot. Keep this token secure, as it will be used to authenticate with Ennote.

Get Your Chat ID

For a Private ChatSend a message to your newly created bot. Then, use the following URL to get your chat ID: https://api.telegram.org/bot/getUpdates. Replace with the API token you received from BotFather. This will return a JSON response containing your chat ID.
For a Channel or GroupAdd your bot as an administrator to the channel or group where you want to receive notifications. You can then get the chat ID of the channel or group by using the same URL as above (https://api.telegram.org/bot/getUpdates). The response will include the chat IDs of all the chats your bot is part of, including the channel or group.

Adding the Integration in Ennote

Got to Notifications

Go to the "Notifications" tab under Organization Audit settings.

Select Telegram

Choose the Telegram integration from the list of available channels.

Enter Bot Token and Chat ID

Enter the API token you received from BotFather and the chat ID you obtained from the getUpdates request.

Select Audit Log Types

Choose the types of audit log events you want to receive notifications for (e.g., create workspace, read sensitive secret, share secret, etc.)

Select Severity Levels

Choose the severity levels of events that should trigger notifications (e.g., info, error)

Get notifications

Need Help?

If you encounter any issues or have questions, don’t hesitate to contact support. Our team is here to assist you with any challenges you might face.