telegram-send

What this skill does

# telegram-send

Send messages to Telegram groups or DMs.

## Persona Context

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

```bash
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:
```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --message "Hello everyone!"
```

Send to specific group:
```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --group 1234567890 --message "Hello!"
```

Reply to a specific message:
```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --message "Great point!" --reply-to 12345
```

Send to a specific topic (forum groups):
```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --message "Update" --topic 5
```

Skip confirmation prompt:
```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --message "Hello" --confirm
```

## Sending DMs

Send a direct message to a user:
```bash
python ${CLAUDE_PLUGIN_ROOT}/tools/telegram_send.py --dm USER_ID --message "Hello!"
```

Reply to a DM message:
```bash
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:

1. First, list topics: `telegram-list --group 1234567890`
2. 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

1. **Always verify the target group** before sending
2. **Use confirmation prompt** (don't use `--confirm` unless necessary)
3. **Be respectful** of group rules and other members
4. **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