shield_lock
JinDaGe
← Back to skills
extension
Category: Content & MediaNo API key required

telegram

Process Telegram messages via GramJS MTProto client. Read messages, generate AI drafts, save drafts, and create intro groups. Use when handling Telegram conversations or facilitating introductions.

personAuthor: jakexiaohubgithub
open_in_newRepositorydownloadDownload package

Telegram Skill

Process Telegram messages via GramJS MTProto client. Supports unread messages, specific users, message requests, and group creation for introductions.

CRITICAL: NEVER SEND MESSAGES. Only save drafts.

Capabilities

| Capability | Description | |------------|-------------| | Unread Mode | Process N unread conversations | | User Mode | Find specific person by username/name (any read state) | | Requests Mode | Process message requests folder (non-contacts) | | Entity Context | Load context from database for known contacts | | Draft Replies | AI generates contextual reply drafts | | Save Drafts | Save drafts to Telegram (no sending) | | Create Groups | Create new groups and add members for introductions | | Dialog Cache | Fast lookups via cached dialog IDs (~1s vs ~90s) | | Mark Unread | Re-mark conversations as unread after processing | | History | Save per-person history to vault context/telegram/ |

Workflows

  • workflows/process-messages.md - Full workflow for reading/replying
  • workflows/create-intro-group.md - Workflow for facilitating introductions

Tools

| Script | Purpose | |--------|---------| | scripts/telegram-gramjs.ts | GramJS MTProto client - fetch messages, populate cache | | scripts/telegram-save-drafts.ts | Save AI drafts to Telegram from work file | | scripts/save-telegram-draft.ts | Quick helper to save one draft by username | | scripts/telegram-create-group.ts | Create groups and add members for intros |

Quick Reference

# Unread mode (default)
/cyber-telegram                    # 1 unread dialog
/cyber-telegram --count 3          # 3 unread dialogs

# User mode
/cyber-telegram --user "@username" # By username
/cyber-telegram --user "Name"      # By name

# Requests mode
/cyber-telegram --requests         # Message requests folder

# Modifiers
/cyber-telegram --dry-run          # Read only
/cyber-telegram --no-mark-unread   # Don't preserve unread state

# Create intro group
bun scripts/telegram-create-group.ts --dry-run --title "A <> B" --users "@user1,@user2"
bun scripts/telegram-create-group.ts --title "A <> B" --users "@user1,@user2" --draft "Intro message"

See workflow files for full documentation.

Dialog Cache

Dialog cache (~/.cybos/telegram/dialog-cache.json) stores all dialog IDs with access hashes for fast lookups:

  • Populated automatically during searches
  • Used by telegram-save-drafts.ts to avoid fetching all dialogs
  • ~1 second draft save vs ~90 seconds without cache

Safety

Drafts only - never sends messages automatically. User reviews and sends manually in Telegram.