telegram-bot-api

Implement asynchronous Telegram Bot API clients with httpx and long polling.

62|7|Updated Feb 7, 2026
One-click install
npx skills add https://github.com/littlebearapps/untether --skill telegram-bot-api
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: telegram-bot-api
Source: https://github.com/littlebearapps/untether/tree/main/.claude/skills/telegram-bot-api
Command: npx skills add https://github.com/littlebearapps/untether --skill telegram-bot-api

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a deep dive into the raw HTTP patterns used by Untether to interact with the Telegram Bot API, enabling developers to understand and modify its core communication mechanisms.

Core Features & Use Cases

  • Direct API Interaction: Demonstrates using httpx for asynchronous HTTP requests to Telegram, bypassing SDKs.
  • State Management: Details the TelegramOutbox for managing message sending, editing, and deletion with rate limiting and prioritization.
  • Real-time Updates: Explains the long-polling mechanism (getUpdates) for receiving messages and callbacks.
  • Interactive Elements: Covers the creation and handling of inline keyboards and callback queries for user interaction.
  • Advanced Features: Includes patterns for voice transcription, forum topic management, and media group coalescing.

Quick Start

Review the src/untether/telegram/client.py file to understand the core TelegramClient implementation.

Frequently Asked Questions about telegram-bot-api

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement rate limiting for an asynchronous Telegram Bot API client?

Implement rate limiting in an asynchronous Telegram Bot API client by using a TelegramOutbox to manage message sending, editing, and deletion with built-in prioritization and rate limiting controls.

What's the best way to handle Telegram callback queries and inline keyboards without an SDK?

Handle Telegram callback queries and inline keyboards without an SDK by using raw HTTP patterns with httpx, parsing incoming updates via long polling, and constructing inline keyboard JSON payloads directly.

How does long polling work for receiving Telegram bot updates asynchronously?

Long polling for receiving Telegram bot updates works by repeatedly calling the getUpdates endpoint via an asynchronous HTTP client like httpx, holding the connection open until new messages or callbacks arrive.

Can I coalesce media group messages when interacting directly with the Telegram Bot API?

Yes, you can coalesce media group messages when interacting directly with the Telegram Bot API by implementing media group coalescing patterns within your custom asynchronous HTTP client logic.

Does this Telegram Bot API pattern require a specific bot framework or SDK?

No, these Telegram Bot API patterns do not require a specific bot framework or SDK, as they demonstrate direct API interaction using httpx for asynchronous HTTP requests and state management.

Why manage a Telegram outbox for message sending and editing?

Manage a Telegram outbox for message sending and editing to enforce rate limiting, prioritize outgoing payloads, and maintain state across asynchronous operations without relying on external SDK abstractions.