Как создать Telegram-бота на PHP + Mysql - Пошаговое руководство

Сейчас наиболее популярным в разработке является настройка взаимодействия клиентских приложений с Telegram. Это обеспечивает удобство коммуникаций на программном уровне с учетом того, что практически каждый пользователь интернета обзаведен данным приложением.

Как программно настроить данное взаимодействие в несколько простых шага?

Понимание данного алгоритма позволит вам расширять данную систему под свои цели.

Есть задача – создать телеграмм бота активировав которого (нажав кнопку старт) наше приложение получит Id этого пользователя, который будет сохранён в базу данных MYSQL в целях отправки ему сообщений и наоборот (от бота в личку пользователю), т.е. последующих коммуникации с ним от имени нашего телеграмм-бота.

Пошаговая инструкция:

Шаг 1: Создайте Telegram-бота

• Откройте Telegram и найдите бота @BotFather.
• Создайте нового бота, отправив команду /newbot.
• Следуйте инструкциям для задания имени и username вашего бота.
• После создания вы получите токен API (что-то вроде 123456789:ABCdefGhiJklMNOpQRstUvWxyZ). Сохраните его — он понадобится для отправки запросов к Telegram API.

Шаг 2: Настройка вебхука

• Создайте файл setWebhook.php и добавьте в него следующий код:

      <?php
      $token = "ВАШ_ТОКЕН"; // Замените на ваш токен
      $url = "https://api.telegram.org/bot$token/setWebhook?url=ВАШ_URL/webhook.php"; // Замените на ваш URL
              
      $response = file_get_contents($url);
      echo $response;
      ?>
  

• Запустите этот файл, чтобы установить вебхук.

Шаг 3: Создание обработчика сообщений

Создайте файл webhook.php, который будет принимать обновления от Telegram:

    <?php
    $update = json_decode(file_get_contents('php://input'), TRUE);

    if (isset($update['message'])) {
        $chat_id = $update['message']['chat']['id'];
        $text = $update['message']['text'];

        // Проверяем команду "/start"
        if ($text === '/start') {
            // Сохраняем ID пользователя в базу данных
            saveUserIdToDatabase($chat_id);

            // Отправляем приветственное сообщение
            sendMessage($chat_id, "Добро пожаловать в нашего бота!");
        }
    }

    function sendMessage($chat_id, $message) {
        $token = "ВАШ_ТОКЕН"; // Замените на ваш токен
        $url = "https://api.telegram.org/bot$token/sendMessage";

        $data = [
            'chat_id' => $chat_id,
            'text' => $message,
        ];

        file_get_contents($url . '?' . http_build_query($data));
    }

    function saveUserIdToDatabase($chat_id) {
        // Здесь ваш код для соединения с базой данных
        // и сохранения $chat_id
    }
    ?>
    

Шаг 4: Настройка базы данных

• Создайте базу данных и таблицу для хранения user_id:

              CREATE DATABASE telegram_bot;
              USE telegram_bot;
  
              CREATE TABLE users (
                  id INT AUTO_INCREMENT PRIMARY KEY,
                  chat_id BIGINT NOT NULL
              );
              

• Настройте соединение с базой данных в функции saveUserIdToDatabase:

  function saveUserIdToDatabase($chat_id) {
          $servername = "localhost"; 
          $username = "ВАШ_ПОЛЬЗОВАТЕЛЬ"; 
          $password = "ВАШ_ПАРОЛЬ"; 
          $dbname = "telegram_bot";
  
          // Создаем соединение
          $conn = new mysqli($servername, $username, $password, $dbname);
          
          // Проверяем соединение
          if ($conn->connect_error) {
              die("Ошибка подключения: " . $conn->connect_error);
          }
          
          // Сохраняем chat_id в базу данных
          $stmt = $conn->prepare("INSERT INTO users (chat_id) VALUES (?)");
          $stmt->bind_param("i", $chat_id);
          $stmt->execute();
          $stmt->close();
          $conn->close();
      }
      

Шаг 5: Тестирование

После того как вы установили вебхук и запустили ваш Telegram-бот, вы можете протестировать его, отправив команду /start. Вот шаги для проверки:

• Отправьте команду /start вашему боту в Telegram.
• Проверьте, что бот отвечает приветственным сообщением. Вы должны увидеть сообщение "Добро пожаловать в нашего бота!".
• Проверьте базу данных. Откройте вашу базу данных и убедитесь, что chat_id вашего пользователя был успешно сохранён в таблице users.

Шаг 6: Отправка сообщений пользователю

Теперь, когда вы сохранили chat_id пользователя, вы можете отправлять ему сообщения из вашего приложения. Для этого вы можете использовать функцию sendMessageToUser.

    function sendMessageToUser($chat_id, $message) {
        $token = "ВАШ_ТОКЕН"; // Замените на ваш токен
        $url = "https://api.telegram.org/bot$token/sendMessage";

        $data = [
            'chat_id' => $chat_id,
            'text' => $message,
        ];

        file_get_contents($url . '?' . http_build_query($data));
    }
    

Шаг 7: Обработка дополнительных команд

Вы можете расширить функционал вашего бота, добавив обработку других команд или сообщений.

    if ($text === '/help') {
        sendMessage($chat_id, "Доступные команды: /start, /help");
    } elseif ($text === '/news') {
        sendMessage($chat_id, "Вот последние новости...");
    } else {
        sendMessage($chat_id, "Неизвестная команда. Наберите /help для списка доступных команд.");
    }
    

Шаг 8: Настройка безопасности и оптимизация

• Безопасность: Убедитесь, что ваше приложение защищено от потенциальных атак (например, SQL-инъекций).
• Логи: Настройте ведение логов для ошибок и запросов.
• Тестирование: Проводите регулярное тестирование функциональности вашего бота.

Теперь мы имеете базовую настройку Telegram-бота на PHP, который может взаимодействовать с пользователями, получать их chat_id, и отправлять им сообщения. С помощью этого фрейма вы можете добавлять любые дополнительные функции и расширять возможности нашего бота в зависимости от потребностей.