telegram-send

Send messages to Telegram groups or DMs.

Persona Context

REQUIRED: Before executing this skill, load your configured persona:

python ${CLAUDE_PLUGIN_ROOT}/../community-agent/tools/persona_status.py --prompt

This outputs your persona definition. Apply it when composing messages:

• Voice: Write in first person as the persona ("I recommend..." not "The system suggests...")

• Style: Match the persona's communication style (formal/friendly/technical)

• Personality: Reflect the persona's traits in how you write

• Signing: Sign messages with persona name if appropriate for the context

Trigger Phrases

• "send to Telegram"

• "post in Telegram group"

• "reply on Telegram"

• "message the Telegram group"

• "telegram send"

• "send a DM on Telegram"

• "message someone on Telegram"

Description

This skill sends messages to Telegram groups or direct messages (DMs). It requires confirmation before sending to prevent accidental messages.

WARNING: Using a user token may violate Telegram's Terms of Service. This tool is intended for personal use only.

Usage

Send a message to default group:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --message "Hello everyone!"

Send to specific group:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --group 1234567890 --message "Hello!"

Reply to a specific message:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --message "Great point!" --reply-to 12345

Send to a specific topic (forum groups):

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --message "Update" --topic 5

Skip confirmation prompt:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --message "Hello" --confirm

Sending DMs

Send a direct message to a user:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --dm USER_ID --message "Hello!"

Reply to a DM message:

python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --dm USER_ID --message "Got it!" --reply-to 12345

Finding User IDs: Use telegram-list to see your DMs and their user IDs.

Confirmation

By default, the tool shows your message and asks for confirmation:

Message to send:

Hello everyone! This is a test message.

Send this message? (y/N):

Use --confirm to skip this prompt (useful for automation).

Output

On success (group):

Sending to: My Group (1234567890)

======================================== Message sent successfully! Message ID: 98765 Timestamp: 2026-01-06T12:00:00+00:00

On success (DM):

Sending DM to: Alice (@alice)

======================================== Message sent successfully! Message ID: 98765 Timestamp: 2026-01-06T12:00:00+00:00

Forum Topics

For groups with forum topics, you can target a specific topic:

• First, list topics: telegram-list --group 1234567890

• Then send to topic: telegram-send --group 1234567890 --topic 5 --message "Hello"

Rate Limiting

If you send too many messages too quickly, you may be rate limited. The tool will show how long to wait before trying again.

Exit Codes

• 0

• Success

• 1

• Authentication error

• 2

• Permission denied or configuration error

• 3

• Rate limited

Safety Notes

• Always verify the target group before sending

• Use confirmation prompt (don't use --confirm unless necessary)

• Be respectful of group rules and other members

• Don't spam - excessive messaging may result in account restrictions

Related Skills

• telegram-init

• Initialize Telegram connection

• telegram-list

• List groups and topics

• telegram-sync

• Sync messages from groups

• telegram-read

• Read synced messages