telegramlisted
Install: claude install-skill afkbot-io/afkbotio
# telegram
Use this skill for Telegram Bot API operations through unified tool `app.run`.
Tool methods:
- `app.run`
- `credentials.list`
- `credentials.request`
Supported actions (`app_name=telegram`):
- `send_message`
- `send_photo`
- `send_document`
- `get_me`
- `get_updates`
- `ban_chat_member`
- `unban_chat_member`
Action naming:
- prefer canonical snake_case action names such as `send_message`
- common Telegram Bot API camelCase aliases such as `sendMessage` are accepted, but new calls should still use canonical snake_case
Credential set (per `profile_name`):
- required: `telegram_token`
- optional: `telegram_chat_id` (not needed if `params.chat_id` is provided)
Runtime params for `app.run`:
- `app_name=telegram`
- `action=<telegram_action>`
- `profile_name=<credential profile>` (optional; runtime auto-picks default or the only available profile)
- `params=<action payload object>`
- use top-level key `params`
Action payload contract:
- `send_message`
- required: `text`
- optional: `chat_id`, `message_thread_id`, `parse_mode`, `disable_web_page_preview`, `token_credential_name`, `chat_id_credential_name`
- note: `chat_id` may be omitted only if credential `telegram_chat_id` exists
- note: `message_thread_id` is used for Telegram forum/topic delivery
- `send_photo`
- required: `photo`
- optional: `caption`, `chat_id`, `message_thread_id`, `parse_mode`, `token_credential_name`, `chat_id_credential_name`
- `photo` may be one of: workspace file path, HTTP