Старт

Введение

Что такое Telegram Bot API, чем он отличается от пользовательского клиента, и как устроен этот практический гайд.

Официальная документация Telegram Bot API точная, но «сухая»: много методов и мало прикладных сценариев. Этот гайд — практический слой поверх core.telegram.org/bots/api: от первого getMe до webhook, inline-кнопок, Mini Apps и боевых проектов на PHP.

Для кого этот раздел

  • PHP-разработчики (чистый PHP, Yii2, Laravel);
  • фронтенд-разработчики Mini Apps (React / Vue);
  • те, кто уже читал официальные docs и хочет рабочие паттерны: идемпотентность, secret_token, очереди, проверка initData.

Бизнес-кейсы и «зачем бот салону» остаются в блоге. Здесь — только техника.

Как читать

  1. Справа — оглавление по разделам (как в документации React).
  2. Пункты без ссылки помечены «скоро» — каркас уже заложен, контент набираем постепенно.
  3. В конце многих глав — ссылки на связанные разделы и мини-проекты.

Что понадобится

  • аккаунт Telegram и доступ к @BotFather;
  • HTTPS-домен для webhook (для локалки — long polling или туннель);
  • PHP 8.1+ с cURL (или фреймворк).

Карта гайда (кратко)

  • Старт — BotFather, токен, getMe;
  • Обновления — getUpdates, webhook, update_id;
  • Сообщения и клавиатуры — sendMessage, inline, callback;
  • PHP — клиент, ошибки API, фреймворки;
  • Mini Apps и платежи — отдельными главами;
  • Проекты — заявка с сайта, магазин, очередь.

Дальше: создайте бота в BotFather и сохраните токен вне Git.