Как отправить сообщение через бота Telegram: sendMessage, разметка и кнопки

Обновлено: 29 октября 2026 г. · 8 мин чтения

Чтобы отправить сообщение через бота Telegram, достаточно одного HTTP-запроса к методу sendMessage: https://api.telegram.org/bot<token>/sendMessage с параметрами chat_id (кому) и text (что). Ниже — готовые примеры на curl, Python и JavaScript, форматирование через parse_mode (HTML и MarkdownV2), inline-кнопки, отправка в группы и каналы и разбор ошибок, которые чаще всего возвращает Telegram Bot API.

Как отправить сообщение через бота: формат запроса

Любой метод Telegram Bot API вызывается по адресу https://api.telegram.org/bot<token>/ИМЯ_МЕТОДА. Обратите внимание: слово bot пишется слитно с токеном. Поддерживаются GET и POST, а параметры можно передать в query string, как application/x-www-form-urlencoded, application/json или multipart/form-data (последний нужен для загрузки файлов).

У sendMessage два обязательных параметра:

• chat_id — числовой идентификатор чата или @username публичного канала или супергруппы. Если id ещё неизвестен, посмотрите гайд как узнать chat id;
• text — от 1 до 4096 символов, считая после разбора разметки.

Ответ всегда приходит в JSON: при успехе — "ok": true и отправленное сообщение (объект Message) в поле result, при ошибке — "ok": false, error_code и description. И главное ограничение: бот не может написать пользователю первым. Человек должен сам открыть бота и нажать «Старт» (/start).

Отправка сообщения через curl

Самый быстрый способ проверить, что всё работает. Подставьте свой токен и chat id:

TOKEN="123456789:AAEexampleTokenReplaceWithYours"

curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{"chat_id": 123456789, "text": "Привет! Это сообщение отправлено через Bot API"}'

Успешный ответ (сокращённо):

{
  "ok": true,
  "result": {
    "message_id": 42,
    "chat": {"id": 123456789, "first_name": "Иван", "type": "private"},
    "date": 1793275200,
    "text": "Привет! Это сообщение отправлено через Bot API"
  }
}

Если параметров немного, можно обойтись без JSON — curl сам закодирует кириллицу и спецсимволы:

curl -s "https://api.telegram.org/bot$TOKEN/sendMessage" \
  -d chat_id=123456789 \
  --data-urlencode "text=Сборка #512 прошла успешно"

Пример на Python (requests)

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
API_URL = f"https://api.telegram.org/bot{TOKEN}"


def send_message(chat_id, text, **params):
    payload = {"chat_id": chat_id, "text": text, **params}
    resp = requests.post(f"{API_URL}/sendMessage", json=payload, timeout=10)
    data = resp.json()
    if not data["ok"]:
        raise RuntimeError(f"{data['error_code']}: {data['description']}")
    return data["result"]


msg = send_message(123456789, "Привет из Python!")
print("message_id:", msg["message_id"])

Функция возвращает объект Message: message_id пригодится, чтобы потом отредактировать или удалить сообщение. Дополнительные параметры передаются именованными аргументами, например send_message(chat_id, text, parse_mode="HTML").

Пример на JavaScript (fetch)

// Node.js 18+: fetch встроен. Запуск: BOT_TOKEN=... node send.mjs
const TOKEN = process.env.BOT_TOKEN ?? '123456789:AAEexampleTokenReplaceWithYours';

async function sendMessage(chatId, text, extra = {}) {
  const res = await fetch(`https://api.telegram.org/bot${TOKEN}/sendMessage`, {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({ chat_id: chatId, text, ...extra }),
  });
  const data = await res.json();
  if (!data.ok) throw new Error(`${data.error_code}: ${data.description}`);
  return data.result;
}

const msg = await sendMessage(123456789, 'Привет из JavaScript!');
console.log('message_id:', msg.message_id);

Этот код заработает и в браузере, но в продакшене так делать нельзя: токен во фронтенде увидит любой посетитель. Отправку держите на сервере, а токен — в переменных окружения.

parse_mode HTML: жирный текст, ссылки и код

Чтобы оформить текст, передайте "parse_mode": "HTML". Telegram понимает ограниченный набор тегов:

• <b>/<strong> — жирный, <i>/<em> — курсив, <u>/<ins> — подчёркнутый, <s>/<strike>/<del> — зачёркнутый;
• <tg-spoiler> или <span class="tg-spoiler"> — спойлер;
• <a href="…"> — ссылка, в том числе tg://user?id=… для упоминания пользователя;
• <code>, <pre> и <pre><code class="language-python"> — код, в последнем случае с подсветкой;
• <blockquote> и <blockquote expandable> — обычная и сворачиваемая цитата.

curl -s -X POST "https://api.telegram.org/bot$TOKEN/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": 123456789,
    "parse_mode": "HTML",
    "text": "<b>Заказ №1024 оплачен</b>\nСумма: <code>1 990 ₽</code>\n<a href=\"https://example.com/orders/1024\">Открыть заказ</a>"
  }'

Все символы <, > и &, которые не входят в тег, нужно заменить на <, > и &. Из именованных HTML-сущностей API понимает только эти три и ", плюс любые числовые. Пользовательский ввод экранируйте всегда:

import html

name = "<Иван & Ко>"  # пришло от пользователя
text = f"Новый заказ от <b>{html.escape(name, quote=False)}</b>"
send_message(123456789, text, parse_mode="HTML")

MarkdownV2 в Telegram: синтаксис и экранирование

MarkdownV2 компактнее HTML: *жирный*, _курсив_, __подчёркнутый__, ~зачёркнутый~, ||спойлер||, `код`, [ссылка](https://example.com), а строки, начинающиеся с >, превращаются в цитату. Подвох — в экранировании: вне разметки каждый из символов _ * [ ] ( ) ~ ` > # + - = | { } . ! нужно предварять обратным слешем \, иначе API вернёт ошибку разбора. Сам \ тоже экранируется. Внутри `кода` и блоков ``` экранируются только ` и \, а внутри круглых скобок ссылки — ) и \.

import re

def escape_md2(text: str) -> str:
    return re.sub(r"([_*\[\]()~`>#+\-=|{}.!\\])", r"\\\1", text)

price = "1.990 руб. (скидка -10%)"
send_message(123456789, f"*Итого:* {escape_md2(price)}", parse_mode="MarkdownV2")
# уйдёт текст: *Итого:* 1\.990 руб\. \(скидка \-10%\)

На JavaScript это одна строка:

const escapeMd2 = (s) => s.replace(/[_*[\]()~`>#+\-=|{}.!\\]/g, '\\$&');

Старый режим Markdown оставлен только для обратной совместимости: в нём нет подчёркивания, зачёркивания, спойлеров и цитат. Для новых ботов выбирайте HTML или MarkdownV2, а если текст приходит от пользователей, HTML обычно надёжнее — экранировать нужно всего три символа.

Inline-кнопки: reply_markup с url и callback_data

Кнопки под сообщением задаются параметром reply_markup с полем inline_keyboard — это массив рядов, а каждый ряд — массив кнопок. Кнопка с url открывает ссылку, кнопка с callback_data присылает боту апдейт callback_query.

{
  "chat_id": 123456789,
  "text": "Подтвердите заказ №1024",
  "reply_markup": {
    "inline_keyboard": [
      [{"text": "Открыть сайт", "url": "https://example.com"}],
      [
        {"text": "Подтвердить", "callback_data": "confirm:1024"},
        {"text": "Отменить", "callback_data": "cancel:1024"}
      ]
    ]
  }
}

• callback_data — от 1 до 64 байт, а не символов: буква кириллицы в UTF-8 занимает 2 байта. Кладите туда короткий идентификатор, а сами данные храните у себя.
• На каждое нажатие отвечайте методом answerCallbackQuery с callback_query_id из апдейта: пока ответа нет, клиент Telegram показывает на кнопке индикатор загрузки.
• Если параметры уходят не JSON-телом, а через query string или form-data, reply_markup передаётся строкой с сериализованным JSON.

Как отправить сообщение в группу или канал

• Группа и супергруппа. Добавьте бота в чат и используйте id чата: у обычных групп он отрицательный, у супергрупп начинается с -100, например -1001234567890. Privacy mode ограничивает только входящие сообщения и на отправку не влияет.
• Канал. Бот должен быть администратором с правом публикации. В chat_id подойдёт @username публичного канала или числовой id вида -100… для приватного.
• Тема форума. Добавьте параметр message_thread_id с id темы.
• Группу превратили в супергруппу. Старый id перестаёт работать: API вернёт ошибку 400, а новый id придёт в parameters.migrate_to_chat_id — сохраните его.

curl -s "https://api.telegram.org/bot$TOKEN/sendMessage" \
  -d chat_id=@my_channel \
  --data-urlencode "text=Новый пост в канале"

Тихие сообщения, превью ссылок и ответы

{
  "chat_id": 123456789,
  "text": "Ночной отчёт готов: https://example.com/report",
  "disable_notification": true,
  "link_preview_options": {"is_disabled": true},
  "protect_content": true,
  "reply_parameters": {"message_id": 42}
}

• disable_notification — сообщение придёт без звука;
• link_preview_options — настройки превью: is_disabled отключает его, url задаёт ссылку для превью, show_above_text ставит превью над текстом;
• protect_content — запрет пересылки и сохранения;
• reply_parameters — ответ на конкретное сообщение по его message_id.

Частые ошибки sendMessage и что с ними делать

Так выглядит ответ с ошибкой 429:

{"ok": false, "error_code": 429, "description": "Too Many Requests: retry after 7", "parameters": {"retry_after": 7}}

Подробно о лимитах и о том, как делать рассылки без 429, — в гайде лимиты Telegram Bot API.

Попробуйте sendMessage без кода

1. Откройте Bot API Tester на форме sendMessage.
2. Вставьте токен бота. Если токена ещё нет, поможет гайд как получить токен бота.
3. Заполните chat_id и text, при желании выберите parse_mode и добавьте reply_markup.
4. Нажмите Ctrl+Enter: в ответе появится message_id или текст ошибки.

Полное описание всех параметров метода — на странице sendMessage.