Telegram Notifications

What Telegram notifications do

Telegram notifications send real-time alerts to your Telegram chat or channel when:

• Posts are published (success or failure)
• Approvals are requested (team or client review needed)
• Warnings occur (platform errors, account issues)

Notifications are opt-in and default OFF — nothing sends until you explicitly enable each category.

Before you start

• You need a Telegram account and a Telegram bot
• A channel or group chat to receive notifications
• Aidelly workspace permissions to enable integrations
• A Telegram account you can message (direct chats, groups, or channels)

Step 1 — Create a Telegram bot

1. Open Telegram and search for @BotFather
2. Start a chat with @BotFather
3. Send /newbot
4. Follow the prompts:
   • Bot name: e.g., "Aidelly Updates"
   • Bot username: e.g., aidelly_updates_bot (must end with _bot, all lowercase)
5. @BotFather sends you a bot token (long string starting with numbers)
6. Copy and save the token

Step 2 — Set up your Telegram channel or group

Choose where notifications go:

Option A: Direct message

1. Search for your newly created bot in Telegram
2. Start a chat with it
3. Send /start to activate the chat
4. You'll use the chat ID for the webhook

Option B: Public channel

1. Create a new public channel
2. Add your bot as a member or admin
3. Note the channel username (@channelname)

Option C: Private group

1. Create a private group
2. Add your bot as a member
3. You'll need the group chat ID

Step 3 — Connect Telegram in Aidelly

1. Go to Workspace Settings → Integrations (or Account Settings → Integrations)
2. Find Telegram in the integrations catalog
3. Click Connect Telegram
4. Paste your bot token (from @BotFather)
5. Enter your target:
   • If direct message or private group: chat ID (get via testing)
   • If public channel: @channelname
6. Click Connect
7. Aidelly tests the connection and saves the token (encrypted)

Step 4 — Enable notification categories

Once connected, notification rules appear:

1. Go to Workspace Settings → Integrations → Telegram
2. You'll see three categories (each default OFF):
   • Approvals — when posts need approval
   • Publish results — when posts publish (success/failure)
   • Warnings — platform alerts, connection issues
3. Toggle each category ON to enable
4. Click Save

Important: Nothing sends until you explicitly enable categories.

Understanding each notification category

Approvals

Sent when a post is submitted for team or client approval:

• Shows post preview (caption snippet)
• Identifies the approver(s) needed
• Includes a link to the approvals page (in direct chat/group only)

Publish Results

Sent when a post completes publishing (success or failure):

• Success: Post published to X platforms at Y time
• Failure: Post failed on Z platform with reason (quota, account issue, etc.)
• Helpful for catching issues immediately

Warnings

Sent for platform-level issues:

• Account token expiring soon
• Webhook connection health issues
• Reconnect needed (account token revoked)
• Rate limiting on a platform

Platform support

Telegram notifications work in all three target types:

Common questions

Q: How do I find my chat ID for a private group?
A: Add @userinfobot to the group, it replies with the group ID.

Q: What if the bot can't send a message?
A: Check that:

• Bot is a member of the channel/group
• Chat ID is correct
• You have the latest bot token

Q: Can I send notifications to multiple channels?
A: Not yet. Create one connection per target. You can only have one Telegram integration per workspace currently.

Q: Are notifications encrypted?
A: Bot tokens are encrypted in Aidelly's database. Telegram's own protocol handles in-transit encryption.

Q: What if I revoke the bot?
A: Disable notifications or create a new bot and reconnect.

Q: Do notifications include post content?
A: Notifications show captions (truncated if long), not full media. Click the link to see the full post.

Q: Can I filter notifications per platform or account?
A: Not yet. All notifications in a category go to the same channel. Filter-by-platform is a future improvement.

Q: What's the difference between Telegram and Slack notifications?
A: Same categories and opt-in posture. Telegram sends to chats/channels via bot. Slack sends via app connection. Both are independent services.

Troubleshooting

What to do next

• Slack Notifications — connect Slack for similar notifications
• Workspace Settings — manage integrations
• Team Approvals — understand the approval workflow
• Account Settings — manage notification preferences