Telegram Bot API: руководство разработчика

Пример с обычной клавиатурой

<?php
$keyboard = [
    [
        ['text' => '🏠 Главная'],
        ['text' => '📊 Статистика']
    ],
    [
        ['text' => '⚙️ Настройки'],
        ['text' => '📞 Поддержка']
    ],
    [
        ['text' => '📍 Отправить геолокацию', 'request_location' => true]
    ]
];

$reply_markup = [
    'keyboard' => $keyboard,
    'resize_keyboard' => true,
    'one_time_keyboard' => false
];

$data = [
    'chat_id' => $chat_id,
    'text' => 'Выберите действие:',
    'reply_markup' => json_encode($reply_markup)
];
?>

Пример с inline клавиатурой

<?php
$inline_keyboard = [
    [
        ['text' => '✅ Да', 'callback_data' => 'yes'],
        ['text' => '❌ Нет', 'callback_data' => 'no']
    ],
    [
        ['text' => '🌐 Открыть сайт', 'url' => 'https://botmix.pro']
    ],
    [
        ['text' => '📱 Поделиться', 'switch_inline_query' => 'Посмотрите на этого бота!']
    ]
];

$reply_markup = [
    'inline_keyboard' => $inline_keyboard
];

$data = [
    'chat_id' => $chat_id,
    'text' => 'Вам понравился этот бот?',
    'reply_markup' => json_encode($reply_markup)
];
?>

<?php
// Получаем callback query из webhook
$callback_query = $update['callback_query'];
$callback_data = $callback_query['data'];
$callback_query_id = $callback_query['id'];

// Обрабатываем нажатие
if ($callback_data === 'yes') {
    $response_text = 'Спасибо за положительный отзыв!';
} else if ($callback_data === 'no') {
    $response_text = 'Мы учтем ваше мнение и улучшим бота.';
}

// Отвечаем на callback query
$answer_data = [
    'callback_query_id' => $callback_query_id,
    'text' => $response_text,
    'show_alert' => false
];

$answer_url = "https://api.telegram.org/bot{$token}/answerCallbackQuery";
// ... отправляем запрос
?>

Отправка фото по URL

<?php
$data = [
    'chat_id' => $chat_id,
    'photo' => 'https://example.com/image.jpg',
    'caption' => 'Описание изображения',
    'parse_mode' => 'HTML'
];

$url = "https://api.telegram.org/bot{$token}/sendPhoto";
// ... отправляем запрос
?>

Отправка локального файла

<?php
$photo_path = '/path/to/local/image.jpg';

$post_fields = [
    'chat_id' => $chat_id,
    'caption' => 'Локальное изображение',
    'photo' => new CURLFile($photo_path)
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.telegram.org/bot{$token}/sendPhoto");
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $post_fields);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$result = curl_exec($ch);
curl_close($ch);
?>

<?php
// Получаем file_id из обновления
$file_id = $update['message']['photo'][0]['file_id']; // для фото
// или
$file_id = $update['message']['document']['file_id']; // для документов

// Получаем информацию о файле
$file_info_url = "https://api.telegram.org/bot{$token}/getFile?file_id={$file_id}";
$file_info = json_decode(file_get_contents($file_info_url), true);

if ($file_info['ok']) {
    $file_path = $file_info['result']['file_path'];
    $file_url = "https://api.telegram.org/file/bot{$token}/{$file_path}";
    
    // Скачиваем файл
    $file_content = file_get_contents($file_url);
    file_put_contents('downloaded_file.jpg', $file_content);
}
?>

<?php
$webhook_url = 'https://yoursite.com/webhook.php';

$url = "https://api.telegram.org/bot{$token}/setWebhook";
$data = [
    'url' => $webhook_url,
    'max_connections' => 100,
    'allowed_updates' => ['message', 'callback_query']
];

$options = [
    'http' => [
        'header' => "Content-type: application/x-www-form-urlencoded\r\n",
        'method' => 'POST',
        'content' => http_build_query($data)
    ]
];

$context = stream_context_create($options);
$result = file_get_contents($url, false, $context);
echo $result;
?>

<?php
// webhook.php
$token = 'YOUR_BOT_TOKEN';

// Получаем данные от Telegram
$input = file_get_contents('php://input');
$update = json_decode($input, true);

// Логируем для отладки
file_put_contents('log.txt', date('Y-m-d H:i:s') . " - " . $input . "\n", FILE_APPEND);

// Обрабатываем сообщение
if (isset($update['message'])) {
    $message = $update['message'];
    $chat_id = $message['chat']['id'];
    $text = $message['text'] ?? '';
    
    // Простая обработка команд
    switch ($text) {
        case '/start':
            sendMessage($chat_id, 'Добро пожаловать! Отправьте /help для списка команд.');
            break;
            
        case '/help':
            $help_text = "Доступные команды:\n/start - Начать работу\n/help - Справка\n/info - Информация о боте";
            sendMessage($chat_id, $help_text);
            break;
            
        default:
            sendMessage($chat_id, "Вы написали: " . $text);
    }
}

// Обрабатываем callback query
if (isset($update['callback_query'])) {
    $callback_query = $update['callback_query'];
    $callback_data = $callback_query['data'];
    $callback_query_id = $callback_query['id'];
    $chat_id = $callback_query['message']['chat']['id'];
    
    // Отвечаем на callback
    answerCallbackQuery($callback_query_id, 'Обработано!');
    sendMessage($chat_id, "Вы нажали: " . $callback_data);
}

function sendMessage($chat_id, $text) {
    global $token;
    
    $url = "https://api.telegram.org/bot{$token}/sendMessage";
    $data = [
        'chat_id' => $chat_id,
        'text' => $text
    ];
    
    $options = [
        'http' => [
            'header' => "Content-type: application/x-www-form-urlencoded\r\n",
            'method' => 'POST',
            'content' => http_build_query($data)
        ]
    ];
    
    $context = stream_context_create($options);
    return file_get_contents($url, false, $context);
}

function answerCallbackQuery($callback_query_id, $text) {
    global $token;
    
    $url = "https://api.telegram.org/bot{$token}/answerCallbackQuery";
    $data = [
        'callback_query_id' => $callback_query_id,
        'text' => $text
    ];
    
    $options = [
        'http' => [
            'header' => "Content-type: application/x-www-form-urlencoded\r\n",
            'method' => 'POST',
            'content' => http_build_query($data)
        ]
    ];
    
    $context = stream_context_create($options);
    return file_get_contents($url, false, $context);
}
?>