StudyChime logoStudyChimeAlerts, filters & trends for Prolific

Guide

Set Up Prolific Telegram Alerts.

Create your own Telegram bot, find the correct chat ID, connect StudyChime, and test private Prolific study notifications.

StudyChime can send matching Prolific study alerts to Telegram using a Telegram bot.

To use Telegram alerts, you need two values:

  • a bot token
  • a chat ID

The bot token tells StudyChime which Telegram bot to use. The chat ID tells StudyChime where to send the alert.

Watch the video guide

Before you start

You will need:

  • StudyChime installed
  • a Telegram account
  • access to Telegram on desktop, web, or mobile

If you want alerts in a Telegram group, you will also need permission to add the bot to that group.

Create a Telegram bot

  1. Open Telegram.
  2. Search for BotFather.
  3. Start a chat with BotFather.
  4. Send the command /newbot.
  5. Follow the prompts to choose a bot name.
  6. Choose a bot username.

The bot username must end in bot, for example:

StudyChimeAlerts_bot

BotFather will then give you a bot token.

Keep this token private. Anyone with the bot token may be able to control your bot.

Start the bot

Before StudyChime can send alerts to you, you need to start the bot.

  1. Open the Telegram bot you just created.
  2. Click Start or send /start.

Telegram bots cannot usually start a conversation with you first. You need to start the chat before the bot can send you alerts.

Get your chat ID

StudyChime needs your Telegram chat ID so it knows where to send alerts.

The exact way to find a chat ID can vary, but a common approach is:

  1. Send a message to your new bot.

  2. Open this URL in your browser, replacing YOUR_BOT_TOKEN with your bot token:

    https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates

  3. Look for a chat object in the response.

  4. Copy the id value from that chat object.

For example, look for a section like this:

"chat": {
  "id": 123456789,
  "type": "private"
}

In that example, the chat ID is:

123456789

If you are setting up alerts for a group, the group chat ID may be a negative number.

Add Telegram details to StudyChime

  1. Open StudyChime from the Chrome toolbar.
  2. Open Settings.
  3. Open Alerts.
  4. Find Telegram.
  5. Paste your Telegram bot token into the Bot token field.
  6. Paste your Telegram chat ID into the Chat ID field.
  7. Enable Telegram alerts.
  8. Select Save alert settings.

You can also configure Telegram during Quick start if you select it at the alert chooser. Chrome requests Telegram permission only when you configure or test this destination.

Send a test alert

After saving your Telegram settings:

  1. Click Send Telegram test in Settings → Alerts.
  2. Open Telegram.
  3. Confirm that a StudyChime test message appears in the chat.

If the test message appears, Telegram alerts are configured correctly.

Before relying on Telegram alerts

  • Use a private chat or group you control because alerts can contain the study title, pay, estimated time, places, and link.
  • Treat the bot token like a password. If it is exposed, revoke it with BotFather, create a replacement, and update StudyChime.
  • StudyChime Free allows 10 external alert batches per rolling 24-hour period, shared across Discord, Telegram, and Pushover. Premium removes this StudyChime limit.
  • With Premium, you can add a Snooze alerts button to new-study alerts. See Remote snooze setup.

If Telegram alerts are not working

Check the following:

  • the bot token was copied correctly
  • the chat ID was copied correctly
  • you have started a chat with the bot
  • Telegram alerts are enabled in StudyChime
  • StudyChime settings were saved
  • StudyChime can send a test alert
  • you have not reached the 10-batch limit for the current rolling 24-hour period

If you see an error when sending a test alert, check the bot token and chat ID first. A common issue is using the bot’s own ID instead of your personal chat ID or group chat ID.

Using Telegram groups

To send alerts to a Telegram group:

  1. Add your bot to the group.
  2. Send /start@YourBotUsername in the group, replacing YourBotUsername with the bot’s username.
  3. Use the getUpdates method to find the group chat ID.
  4. Copy the group chat ID into StudyChime.
  5. Send a test alert.

Group chat IDs are often negative numbers. Copy the full value exactly.

Changing the Telegram destination

To send alerts somewhere else, update the chat ID in StudyChime settings.

For example, you can switch from a private chat to a group by replacing the private chat ID with the group chat ID.

After changing the chat ID, send another test alert.

Removing Telegram alerts

To stop Telegram alerts:

  1. Open StudyChime settings.
  2. Open Alerts.
  3. Disable Telegram alerts or remove the bot token and chat ID.
  4. Select Save alert settings.

You can also revoke the bot token in BotFather if you no longer want the token to be usable.