Telegram Bot API — Справочник

Telegram Bot API — Справочник

? Получение обновлений

Обновления
Подробнее

Telegram передаёт обновления двумя способами:

  • Webhook — POST-запрос на ваш URL
  • getUpdates — вы сами запрашиваете список обновлений
$update = json_decode(file_get_contents('php://input'), true);

? Структура объекта $update

Обновления
Поля объекта
  • update_id — ID обновления
  • message — входящее сообщение
  • callback_query — нажатие кнопки
  • inline_query — inline-поиск

? Отправка сообщений

Сообщения
Доступные методы
  • sendMessage — текстовое сообщение
  • sendPhoto — фото
  • sendDocument — документ
  • editMessageText — редактирование
file_get_contents("https://api.telegram.org/bot$token/sendMessage?chat_id=$chatId&text=Привет");

? Приём файлов

Файлы
Как получить файл
  1. Получите file_id из сообщения
  2. Запросите путь через getFile
  3. Скачайте файл по ссылке
$fileUrl = "https://api.telegram.org/file/bot$token/$filePath";

? Инлайновые и обычные кнопки

Кнопки
Использование
  • inline_keyboard — инлайновые кнопки
  • reply_keyboard — клавиатура бота
  • callback_data — обработка кликов
'reply_markup' => json_encode([
    'inline_keyboard' => [
        [['text' => 'Нажми', 'callback_data' => 'click']]
    ]
])

?️ Дополнительные методы

Методы
Часто используемые методы
  • setWebhook — установить webhook
  • getMe — получить данные о боте
  • setMyCommands — установить команды
  • answerCallbackQuery — ответ на кнопку