Skip to content
Shodan Book

Telegram

To receive notifications in a Telegram chat we need to have 2 things:

  1. Bot Token: the unique token that identifies the bot and allows Shodan Monitor to post as the bot
  2. Chat ID: the unique ID that tells Shodan Monitor where to post the notification.

The first step is getting the chat_id number of an existing channel or create a new one dedicated to receiving Shodan Monitor notifications.

  1. Open the Telegram app
  2. Click on New Message
  3. Select New Channel
  4. Enter a channel name (ex. Shodan Monitor)
  5. Click the checkbox to create the new channel
  6. Post a test message to the channel. It doesn't matter what the message contains but we will forward it to another bot to get the channel ID.
  7. Start a chat with a bot such as @getidsbot
  8. Go back to your channel and forward the test message to the @getidsbot
  9. Look for the id in the Origin Chat section of the message that @getidsbot sends. The number should start with a -.

The next step is to generate a bot and get the token please follow the official instructions below:

https://core.telegram.org/bots/features#creating-a-new-bot

After creating the bot, make sure to invite it to the channel and give it permission to post messages. Finally, we get into Shodan Monitor to create the notifier:

  1. Click here to create the notifier in Shodan Monitor.
  2. Enter the token and chat_id from the previous steps.
  3. (optional) Provide a description (ex. Telegram channel xyz)
  4. Select Apply to existing asset groups if you want to get notifications from all asset groups delivered to Telegram
  5. Click on the Add Notifier button to save the settings
  6. Done! You've successfully connected Shodan Monitor and Telegram.