telegram-bot-api

Use when working with Telegram Bot API for sending messages, handling updates, managing keyboards, sending media, or debugging bot errors. Also use when setting up authentication, handling rate limits, or working with Bot API types.

Model	Source
inherit	pack: telegram

Overview

Item	Value
Current version	Bot API 9.5 (March 1, 2026)
Base URL	https://api.telegram.org/bot<token>/
Auth	Bot token from BotFather — passed in URL path
Format	JSON (POST body or GET params)
Docs	core.telegram.org/bots/api

Full Reference

┏━ 🔧 telegram-bot-api ━━━━━━━━━━━━━━━━━━━━━━━━━━┓ ┃ Telegram Bot API 9.5 reference ┃ ┗━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━┛

Telegram Bot API

Overview

Item	Value
Current version	Bot API 9.5 (March 1, 2026)
Base URL	https://api.telegram.org/bot<token>/
Auth	Bot token from BotFather — passed in URL path
Format	JSON (POST body or GET params)
Docs	core.telegram.org/bots/api

Reference Index

File	Contents
reference/methods.md	Core methods — sendMessage, sendPhoto, editMessageText, deleteMessage, keyboards, rate limits
reference/updates.md	Update types — Message, CallbackQuery, InlineQuery, getUpdates polling vs webhook, update lifecycle

Usage: Read the reference file matching your current task. Each file has working code examples and inline gotchas.

Quick Auth Pattern

# Test your token
curl https://api.telegram.org/bot<YOUR_TOKEN>/getMe

const BOT_TOKEN = process.env.TELEGRAM_BOT_TOKEN;
const BASE = `https://api.telegram.org/bot${BOT_TOKEN}`;

async function sendMessage(chatId: number, text: string) {
  const res = await fetch(`${BASE}/sendMessage`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ chat_id: chatId, text }),
  });
  return res.json();
}