Troubleshooting

Bot Not Responding

Symptoms: Bot doesn't reply to commands or messages.

Possible causes:

• Bot is down for maintenance (check status page)
• You've been rate-limited (wait a few minutes and try again)
• Command sent in wrong context (e.g., /groupadmin in DMs)

Solutions:

• Send /start to reinitialize
• Check if bot is still in the group (groups only)
• Verify you're using correct command syntax
• Contact support if issue persists

Admin Cockpit Won't Load

Symptoms: Clicking "Open Admin Cockpit" does nothing or shows an error.

Solutions:

• Update Telegram to the latest version (miniapps require recent builds)
• Ensure bot has admin permissions in the group
• Try sending /groupadmin from the group, not from DMs
• Clear Telegram cache and restart the app
• Try from a different device (desktop vs mobile)

Responses Feel Off-Target

Symptoms: Bot suggestions don't match the situation or tone.

Solutions:

• Provide more context when requesting a response
• Try a different mode (Stabilize vs Clarify vs Close)
• If your group has the RAG add-on enabled, ensure it is active in /groupadmin settings
• Report persistent issues to [email protected]

Rate Limit Errors

Symptoms: "You're sending requests too quickly" message.

Cause: Anti-abuse protection triggered.

Solutions:

• Wait 5-10 minutes before retrying
• Spread out requests over time instead of rapid-fire commands

Thread Context Lost

Symptoms: Bot doesn't remember previous message.

Cause: Context is held within a single session. Sending /start or beginning a new conversation resets it.

Solutions:

• Provide full context again when starting a new session
• Keep your conversation in a single uninterrupted session for best continuity
• Send /start to deliberately reset and start fresh

Permissions Issues (Group Mode)

Symptoms: Bot can't delete messages, ban users, or perform admin actions.

Cause: Insufficient admin permissions.

Solutions:

• Promote bot to admin in group settings
• Grant required permissions: Delete messages, Restrict members, Post messages
• Check if group has restrictions on bot permissions
• Re-add the bot if permissions are severely limited

Most common cause: running /groupadmin from DMs instead of from inside the group.

Admin Cockpit Access Denied

Symptoms: Bot says you're not authorized to access the Admin Cockpit.

Cause: Your Telegram account is not a group admin in that chat.

Solutions:

• Confirm you're an admin in the target group
• Ask the group owner to grant you admin permissions
• Run /groupadmin again from the correct group chat

Getting Additional Help

If your issue isn't covered here:

• Check the Flight Manual for detailed usage guides
• Review full documentation
• Check system status for known outages
• Email support: [email protected]
• Include error messages, screenshots, and steps to reproduce

Still stuck? Reach out at [email protected] or join the Community Group. Resolver takes issues seriously.