Chat Manager

Chat groups are stored in .claude/telegram-groups.json in the user's home directory. Read this file first to know available groups.

File Format

{
  "groups": [
    {
      "name": "clients",
      "description": "Client project chats",
      "chats": [
        {
          "name": "Project Alpha",
          "entity": "-1234567890",
          "type": "group",
          "contacts": ["Alice", "Bob"]
        }
      ]
    }
  ]
}

Entity IDs

• Group chats have negative IDs (e.g., -5244953466)
• Users have positive IDs or usernames (e.g., @username)
• Use search_dialogs to find unknown chat IDs

Commands

Check Messages

When the user says "check telegram", "check [group]", "any new messages":

1. Read ~/.claude/telegram-groups.json
2. For the specified group (or all groups), call get_messages for each chat with limit: 10
3. Summarize concisely: who said what, when, anything needing a response
4. Highlight messages that tag the user or ask questions

Reply to Chat

When the user says "reply to [chat/person]", "tell [person]", "message [chat]":

1. Find the chat in groups by name
2. If the user provided exact text, send it
3. If not, ask what to say
4. Use reply_to with a message_id only when responding to a specific earlier message

Broadcast

When the user says "broadcast to [group]", "blast [group]", "send to all":

1. Show the message and list of recipient chats
2. Ask for confirmation before sending
3. Send to each chat in the group sequentially
4. Report results (sent/failed)

Manage Groups

When the user says "add [chat] to [group]", "create group [name]", "list groups":

1. Read the groups file
2. Make the requested change
3. Write updated file back
4. If adding a new chat and entity ID is unknown, use search_dialogs to find it

Behavior Rules

• Always read the groups file before any operation
• Keep responses concise — summarize conversations, don't dump raw messages
• For broadcasts, ALWAYS confirm before sending
• When showing messages, format as: Name (time): message
• If a chat isn't in any group, offer to add it
• Handle missing groups file gracefully — offer to create it