← All guides

Guide · Get notified

Send alerts to Telegram

You create your own personal Telegram bot, and Mortemain sends alerts through it to your chat. Mortemain needs two things from you: the bot token and your chat id.

1. Create a bot

In Telegram, open a chat with @BotFather (the official one, with the blue check). Send /newbot.

BotFather shows a menu of commands, but it also expects plain-text replies:

  • When it asks for a name, type a plain name (e.g. Mortemain Alerts).
  • When it asks for a username, type one ending in bot (e.g. mortemain_yourname_bot).

It replies with a token:

 your bot token
8123456789:AAHxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

That is the Bot token.

2. Open the chat and get your chat id

A bot cannot message you until you have messaged it first, so send your new bot any message (e.g. hi).

Then message @userinfobot, which replies with your numeric id:

 your chat id
123456789

That is the Chat id.

3. Add the target in Mortemain

In your Mortemain dashboard, add a notification target:

  • TypeTelegram
  • Bot token → the token from step 1
  • Chat id → the number from step 2

Save, then wire it to the checks you care about.

Test it

Hit Test on the target. The alert arrives as a message from your bot within a second or two. If nothing comes, the usual cause is that you have not sent your bot a first message yet (step 2).