Telegram бот PHP: от основ до продвинутых сценариев

Расширенные примеры программного кода

Данный раздел содержит подробные примеры для типичных сценариев Telegram бота на PHP. Каждый пример сопровождается пояснением и результатом выполнения.

Пример 1: Отправка сообщения с Inline-клавиатурой

Inline-клавиатура позволяет пользователю нажимать кнопки внутри сообщения. Код с использованием Guzzle:

$chatId = 123456789;
$text = 'Выберите действие:';
$keyboard = [
    'inline_keyboard' => [
        [
            ['text' => 'Кнопка 1', 'callback_data' => 'btn1'],
            ['text' => 'Кнопка 2', 'callback_data' => 'btn2']
        ],
        [
            ['text' => 'Ссылка', 'url' => 'https://example.com']
        ]
    ]
];
$response = $client->post('sendMessage', [
    'form_params' => [
        'chat_id' => $chatId,
        'text' => $text,
        'reply_markup' => json_encode($keyboard)
    ]
]);
$result = json_decode($response->getBody(), true);
if ($result['ok']) {
    echo 'Сообщение отправлено с клавиатурой';
}

// Результат: в чат отправлено сообщение с двумя inline-кнопками и одной ссылкой.
// Пользователь может нажать кнопку, и Telegram пришлет callback_query с соответствующими данными.

Пример 2: Обработка Callback Query

Когда пользователь нажимает inline-кнопку, Telegram отправляет callback_query. Обработка:

$update = json_decode(file_get_contents('php://input'), true);
$callbackQuery = $update['callback_query'] ?? null;
if ($callbackQuery) {
    $callbackId = $callbackQuery['id'];
    $data = $callbackQuery['data'];
    $chatId = $callbackQuery['message']['chat']['id'];
    // Ответ на callback
    $client->post('answerCallbackQuery', [
        'form_params' => [
            'callback_query_id' => $callbackId,
            'text' => "Вы нажали: $data"
        ]
    ]);
    // Можно также изменить сообщение
}

// Пользователь увидит всплывающее уведомление с текстом "Вы нажали: btn1".

Пример 3: Отправка фотографии

Для отправки изображения используется метод sendPhoto. Файл может быть загружен из URL или локально.

$chatId = 123456789;
$photoUrl = 'https://picsum.photos/400/300';
$response = $client->post('sendPhoto', [
    'form_params' => [
        'chat_id' => $chatId,
        'photo' => $photoUrl,
        'caption' => 'Случайное изображение'
    ]
]);

// В чат отправлена фотография с подписью.

Пример 4: Загрузка файла с сервера (multipart)

Если изображение лежит на вашем сервере, используйте multipart/form-data:

$response = $client->post('sendPhoto', [
    'multipart' => [
        [
            'name' => 'chat_id',
            'contents' => $chatId
        ],
        [
            'name' => 'photo',
            'contents' => fopen('/path/to/image.jpg', 'r'),
            'filename' => 'image.jpg'
        ]
    ]
]);

// Отправленный файл появится в чате.

Пример 5: Работа с ParseMode (Markdown / HTML)

Telegram поддерживает форматирование текста. Пример с HTML:

$text = '<b>Жирный текст</b> и <i>курсив</i>';
$response = $client->post('sendMessage', [
    'form_params' => [
        'chat_id' => $chatId,
        'text' => $text,
        'parse_mode' => 'HTML'
    ]
]);

// В чате отобразится: Жирный текст и курсив.

Пример 6: Отправка документа (PDF, ZIP)

$response = $client->post('sendDocument', [
    'multipart' => [
        ['name' => 'chat_id', 'contents' => $chatId],
        ['name' => 'document', 'contents' => fopen('/path/to/file.pdf', 'r'), 'filename' => 'file.pdf']
    ]
]);

// Пользователь получает файл с именем file.pdf.

Пример 7: Получение информации о боте

$response = $client->get('getMe');
$result = json_decode($response->getBody(), true);
echo $result['result']['username']; // выведет username бота

// Пример вывода: MyTestBot

Пример 8: Удаление вебхука

$client->post('deleteWebhook');
// или с параметрами
$client->post('deleteWebhook', ['form_params' => ['drop_pending_updates' => true]]);

// После удаления можно переключиться на getUpdates.

Пример 9: Использование getUpdates с offset для пропуска обработанных обновлений

$offset = 0; // хранить в БД или файле
$response = $client->get('getUpdates', ['query' => ['offset' => $offset, 'timeout' => 30]]);
$updates = json_decode($response->getBody(), true)['result'];
if (!empty($updates)) {
    $lastId = end($updates)['update_id'];
    $offset = $lastId + 1;
    // сохранить offset
    foreach ($updates as $update) {
        // обработка
    }
}

// Каждый следующий вызов получит только новые сообщения.

Пример 10: Отправка сообщения с Reply-клавиатурой (обычной)

$keyboard = [
    'keyboard' => [
        ['Кнопка 1', 'Кнопка 2'],
        ['Кнопка 3']
    ],
    'resize_keyboard' => true,
    'one_time_keyboard' => false
];
$response = $client->post('sendMessage', [
    'form_params' => [
        'chat_id' => $chatId,
        'text' => 'Выберите кнопку:',
        'reply_markup' => json_encode($keyboard)
    ]
]);

// Внизу экрана появится клавиатура с тремя кнопками.