Telegram Troubleshooting

Common issues and solutions for the Telegram integration.

Connection Issues

Bot not responding

1. Check that NexusCore is running on your machine:

   nexus-cli status

2. Verify the Telegram bridge is active:

   nexus-cli telegram status

3. Check your internet connection on both your phone and machine
4. Try re-pairing:

   nexus-cli telegram pair

"Session expired" message

Telegram sessions expire after 24 hours. Re-pair to create a new session:

nexus-cli telegram pair

Or from NexusIDE: click Remote Access in the title bar and scan the new QR code.

Pairing code not working

• Pairing codes expire after 5 minutes. Generate a new one with nexus-cli telegram pair
• Make sure you're entering the code in the @NexusSuiteBot chat, not a different bot
• Codes are case-sensitive — enter them exactly as shown

"Session revoked" error

Your session was revoked from another device or the Portal. This can happen if:

• You revoked all sessions from the Portal
• Someone with access to your account revoked the session
• You paired a new Telegram session (only one active session per user)

Re-pair with nexus-cli telegram pair to create a new session.

Tool Errors

"Tool not allowed" message

The tool you're trying to use is not in the tool allowlist. Update the allowlist:

nexus-cli telegram config --allow-tools file_read,file_list,text_search,file_write

Tool approval buttons not appearing

Make sure you're using the latest version of the Telegram app. Inline buttons require Telegram 6.0 or later.

Performance

Slow responses

• Check your internet connection on both ends
• Large file operations take longer over the Telegram bridge
• Complex agent tasks may take time to process — the bot sends a "Working..." indicator
• If the relay server is under load, responses may be queued

Messages cut off

Telegram has a 4096-character message limit. Long responses are automatically split across multiple messages. If content appears missing, scroll down — the rest may be in the next message.

Resetting the Integration

If you're experiencing persistent issues, reset the Telegram integration:

# Revoke the current session
nexus-cli telegram revoke

# Re-pair
nexus-cli telegram pair

Getting Help

If you're still having issues:

• Check the Nexus Suite status page for service outages
• Visit nexus-suite.dev/support for support options
• Pro and Studio tier users have access to priority support