What Telegram Alerts Do
Telegram alerts send a message to your phone or desktop when something happens in your workspace: a clip goes live, an article is drafted, new research is in, or a publish fails. You don't need to keep Apex® open to know what's going on.
Each alert is a picture in Apex®'s style with a short headline, the clip or video when there is one, a few details, and buttons that open the right page in Apex®. If you have more than one workspace, the alert shows which workspace it's from.
Alerts are set up per workspace in Preferences → Alerts. Each workspace can use its own bot and chat, or the same ones. Your in-app notifications still get everything, whatever you choose here.
Step 1: Create Your Bot With @BotFather
Telegram alerts come from a bot that belongs to you. Creating one is free and takes about two minutes, once.
- In Telegram, open a chat with @BotFather (Telegram's official bot for making bots).
- Send /newbot, then follow the prompts: give the bot a display name, then a username that ends in "bot".
- @BotFather replies with a token that looks like 123456789:ABC... Copy it.
- Open your new bot (BotFather links to it) and press Start. This step matters: a bot can't message you until you've started a chat with it.
Step 2: Connect the Bot in Apex®
- Open Preferences → Alerts.
- Paste the token into Bot token.
- Click Find My Chat ID. Apex® looks for the most recent chat that messaged your bot and fills in Chat ID, with a note like "Found your chat with" your name.
- Click Send Test Message. A real alert arrives in Telegram saying Telegram Alerts Are On and listing what you'll be sent.
- Turn on Send Telegram alerts. The status badge changes to On.
To send alerts to a group instead, add your bot to the group and send a message there (for example /start), then click Find My Chat ID again. Apex® picks up the chat that messaged the bot most recently.
Step 3: Choose What to Send
Under What To Send, five switches decide which alerts this workspace gets:
| Switch | What it sends |
|---|---|
| Posted and scheduled | When a clip or article goes live, or clips get a posting time. |
| Clips and articles ready | When clips, articles or a faceless video are ready to review. |
| Research ready | When new niche outliers, article ideas or video research are in. |
| Problems | When a video or publish fails, something didn't finish, or Autopilot pauses. |
| Settings and connections | When an account connects, disconnects or expires, or settings change. |
Most people keep Problems on at minimum, so a failed post never goes unnoticed.
How Apex® Keeps Your Chat Quiet
- Grouping: scheduling changes are collected for a couple of minutes, and settings and connection changes for a few minutes, then sent as one message instead of one per change.
- Hourly cap: after 12 alerts in an hour, the rest wait and arrive together as one summary at the end of the hour.
- Problems come first: problem alerts are never grouped or held back. They're sent straight away.
- Rescans: the daily niche rescan only alerts you when it finds new outliers.
- Setup: nothing is sent while a workspace is still in its welcome setup.
Troubleshooting
| Problem | What to do |
|---|---|
| "No messages found. Open your bot in Telegram, press Start" | Open your bot, press Start or send it any message, then click Find My Chat ID again. |
| "The bot token was rejected" | The token is wrong or was revoked in @BotFather. Copy the current token from @BotFather and paste it again. |
| "Chat not found" | Send your bot a message first, then use Find My Chat ID to fill in the right chat. |
| "Add your bot token first" | Paste the token into Bot token before clicking Find My Chat ID. |
| Badge says Delivery Failing | Read the "Last message failed" note under it, fix the cause, then click Send Test Message. |
| Badge says Off and no alerts arrive | Turn on Send Telegram alerts, and check that the switches you want under What To Send are on. |
| Too many messages | Turn off Posted and scheduled or Settings and connections. Problems still arrive. |
Related Guides
Was this article helpful?




