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
- Open Telegram.
- Search for BotFather.
- Start a chat with BotFather.
- Send the command
/newbot. - Follow the prompts to choose a bot name.
- 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.
- Open the Telegram bot you just created.
- 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.
Discover a private Chat ID
StudyChime needs your Telegram chat ID so it knows where to send alerts.
For a private conversation, use Find my chat after you start or message your bot. StudyChime fills in the Chat ID for you, so you do not need to find or copy it manually:
- Open StudyChime Settings → Alerts → Telegram.
- Paste the bot token from BotFather. StudyChime validates it and shows a clearer error if it is not usable.
- Start or send a new message to your bot in Telegram.
- Select Find my chat in StudyChime to fill in the Chat ID.
- Check that the discovered private chat is yours, then continue to the test.
If discovery cannot find the private chat, send the bot another message and retry. For a group destination, use the manual method below because private Chat ID discovery is intended for the user’s private chat.
Find a Chat ID manually
The manual method is also useful for groups:
-
Send a message to your new bot.
-
Open this URL in your browser, replacing
YOUR_BOT_TOKENwith your bot token:https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates -
Look for a
chatobject in the response. -
Copy the
idvalue 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
- Open StudyChime from the Chrome toolbar.
- Open Settings.
- Open Alerts.
- Find Telegram.
- Paste your Telegram bot token into the Bot token field.
- Start or message the bot, then select Find my chat to fill in your private Chat ID. You can also paste a Chat ID manually, including for a group.
- Enable Telegram alerts.
- 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:
- Click Send Telegram test in Settings → Alerts.
- Open Telegram.
- Confirm that a StudyChime test message appears in the chat.
- Click the relevant I received the Telegram test confirmation in StudyChime before continuing setup.
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 5 external alert batches per rolling 24-hour period, shared across Discord, Telegram, and Pushover. Premium removes this StudyChime limit.
- Test alerts do not use the Free external-alert allowance.
If Telegram alerts are not working
Check the following:
- the bot token was copied correctly
- the private Chat ID was discovered after you messaged the bot, or the manually entered 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 5-batch limit for the current rolling 24-hour period
If StudyChime rejects the bot token, copy a fresh token from BotFather and check for extra spaces. If sending still fails, check the Chat ID. 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:
- Add your bot to the group.
- Send
/start@YourBotUsernamein the group, replacingYourBotUsernamewith the bot’s username. - Use the
getUpdatesmethod to find the group chat ID. - Copy the group chat ID into StudyChime.
- 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:
- Open StudyChime settings.
- Open Alerts.
- Disable Telegram alerts or remove the bot token and chat ID.
- Select Save alert settings.
You can also revoke the bot token in BotFather if you no longer want the token to be usable.