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=Привет");
? Приём файлов
ФайлыКак получить файл
- Получите
file_idиз сообщения - Запросите путь через
getFile - Скачайте файл по ссылке
$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— установить webhookgetMe— получить данные о ботеsetMyCommands— установить командыanswerCallbackQuery— ответ на кнопку