Troubleshooting Telegram
Who fixes it
- The user experiencing the alert issue
- Workspace owner / Telegram ACL
admin— reconnect, ACL
Checklist
- Plan is Solo+ (
telegram_alerts) - Telegram integration status in Sheets
- User is in the ACL (
admin/operator/recipient) and the chat is linked - The bot is not blocked by the user; network access to the Telegram API
- For the Mini App — role
adminoroperatoris required
Common issues
| Symptom | Fix |
|---|---|
| No alerts | ACL recipient + alert enabled + report has data |
| Mini App 403 | Requires admin/operator, not recipient |
| Bot is silent | Send /start again, unblock, reconnect |
| After changing phones | Re-link the chat id |