# Telegram

> Send Telegram messages, files, and interact with Telegram bots via the telegram-send CLI tool.

- Skill: `olasunkanmi-se/telegram` (Agent Skill)
- Install (CLI): `npx skillmds@latest add olasunkanmi-se/telegram`
- Raw SKILL.md: https://api.skillmd.com/api/skills/olasunkanmi-se/telegram/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: olasunkanmi-se (https://skillmd.com/u/olasunkanmi-se)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/olasunkanmi-se/telegram

---


# telegram-send

Use `telegram-send` to send messages, files, and media to Telegram chats.
This tool requires initial configuration with a Telegram bot token.

## Setup

Before using, configure telegram-send with your bot token:

```bash
telegram-send --configure
```

This will prompt you to:

1. Create a bot via [@BotFather](https://t.me/botfather) on Telegram
2. Enter the bot token
3. Send `/start` to your bot to enable messaging

For group chats, use `--configure-group` instead:

```bash
telegram-send --configure-group
```

## Common Commands

### Send Text Message

```bash
telegram-send "Hello from CodeBuddy!"
```

### Send with Formatting

```bash
# Markdown formatting
telegram-send --format markdown "**Bold** and _italic_ text"

# HTML formatting
telegram-send --format html "<b>Bold</b> and <i>italic</i> text"
```

### Send Files

```bash
# Send a document
telegram-send --file /path/to/document.pdf

# Send with caption
telegram-send --file /path/to/document.pdf --caption "Here's the report"
```

### Send Images

```bash
# Send image
telegram-send --image /path/to/image.png

# Send image with caption
telegram-send --image /path/to/screenshot.png --caption "Screenshot attached"
```

### Send to Specific Config (Multiple Bots/Chats)

```bash
# Use a specific config file
telegram-send --config /path/to/custom.conf "Message to specific chat"
```

### Send Code Blocks

```bash
# Send pre-formatted code
telegram-send --format markdown "\`\`\`python
def hello():
    print('Hello, World!')
\`\`\`"
```

### Silent Messages (No Notification)

```bash
telegram-send --silent "This won't trigger a notification"
```

### Send Location

```bash
telegram-send --location 37.7749 -122.4194
```

## Configuration Files

Default config location: `~/.config/telegram-send.conf`

You can have multiple configs for different bots/chats:

- `~/.config/telegram-send.conf` - default
- `~/.config/telegram-send-group.conf` - for group chats
- Custom paths with `--config`

## Security Notes

- Bot tokens are stored in the config file - ensure proper file permissions
- Run `chmod 600 ~/.config/telegram-send.conf` to secure credentials
- Never commit config files to version control
- Use separate bots for different purposes (personal, work, etc.)

## Error Handling

If you get "Unauthorized" errors:

1. Verify your bot token with @BotFather
2. Ensure you've sent `/start` to the bot
3. Re-run `telegram-send --configure`

## Limitations

- Can only send to users/groups that have started the bot
- Rate limits apply (avoid spamming)
- File size limits: 50MB for documents, 10MB for photos