Overview
Chat with your CharacterSphere.ai characters directly from Telegram. This feature lets you continue your conversations on the go, using Telegram as a mobile client for your CharacterSphere.ai chats.
Getting Started
Step 1: Link Your Telegram Account
- Log in to your account on CharacterSphere.ai
- Navigate to your profile or settings page
- Click on “Connect Telegram” or similar linking option
- A QR code will appear on the screen
- Open the Telegram app on your mobile device
- Scan the QR code with your Telegram app (use the camera feature or scan option)
- Wait for the confirmation message that your account is linked
Note: You only need to link your Telegram account once. After that, you can chat anytime without additional setup.
Starting a Chat
- Navigate to the character you want to chat with on CharacterSphere.ai
- Click the “Chat on Telegram” button on the character page
- This will automatically open Telegram with the correct command
- If you’re starting a new chat, select the scenario (or choose to start without one)
- The bot will send the character’s image and initial greeting
Managing Your Chats
Listing Conversations
To see all your chats open list of chats in the browser, or send the following command in the bot:
/listchats
The bot will display a numbered list of all your conversations with inline buttons to quickly continue any chat.
Stopping a Chat Session
To end your current chat session, send:
/stopchat
Your chat history is automatically saved, so you can continue anytime using /listchats.
Account Commands
| Command | Description |
|---|---|
/status |
Check if your Telegram account is linked and show verification status |
/unlink |
Unlink your Telegram account from CharacterSphere.ai (you’ll need to re-link to chat) |
/help |
Display a list of all available commands and instructions |
Chat Access and Permissions
Your access to characters via Telegram is determined by the character’s visibility settings:
| Character Type | Access via Telegram |
|---|---|
| Private Verified | Character owner only |
| Community | Any registered CharacterSphere.ai user |
Access Control Examples
- Private Characters: Only you can chat with your own private characters via Telegram
- Community Characters: Any logged-in user can chat with community characters
Message Handling
When you start or continue a chat via Telegram, the bot will:
- Display the character’s featured image
- Show the character’s name
- Display the last 6 messages from your conversation (as a preview)
- Wait for your input to continue the conversation
Important Notes
- One Active Chat: You can only have one active chat session at a time per Telegram account
- Chat History: All your chat history is automatically saved and synced between web and Telegram, and you can continue the same conversation switching between a browser and Telegram as needed.
- Scenario Support: Scenarios (1-5) created by character authors are fully supported on Telegram
- Multiple Users: One Telegram account can only be linked to one CharacterSphere.ai account
Troubleshooting
Linking Issues
- “Not linked” error: Send
/statusto check your linking status, then re-link via the website - QR code expired: Generate a new QR code on the CharacterSphere website (QR codes expire after 15 minutes)
Chat Issues
- “No active chat”: Send
/listchatsto see your conversations and select one - “Could not find conversation”: The chat may have been deleted or you may need to start a new chat
Unlinking Your Account
If you want to unlink your Telegram account:
- Send
/unlinkin the Telegram bot - Your Telegram account will be unlinked and you’ll need to re-link to chat again
