Отправка и получение сообщений в Telegram на PHP

Привет, друзья! Сегодня мы узнаем, как отправлять и получать сообщения в популярном мессенджере Telegram с помощью языка программирования PHP. Если вы разработчик или просто энтузиаст, желающий автоматизировать свои действия в Telegram, эта статья для вас. Мы рассмотрим все, начиная с установки необходимых библиотек и заканчивая созданием полноценного бота, который сможет обмениваться сообщениями с пользователями.

Введение в Telegram API и PHP

Что такое Telegram API?

Telegram API — это интерфейс для взаимодействия с Telegram, который позволяет разработчикам создавать ботов, отправлять и получать сообщения, управлять каналами и группами и многое другое. С помощью Telegram API вы можете автоматизировать множество задач и интегрировать Telegram с другими сервисами.

Установка и настройка окружения

Шаг 1: Установка PHP

Если у вас еще нет PHP на вашем компьютере, самое время его установить. Вы можете загрузить PHP с официального сайта php.net и следовать инструкциям по установке для вашей операционной системы.

Шаг 2: Установка библиотеки для работы с Telegram API

Для работы с Telegram API на PHP существует несколько библиотек, но мы будем использовать одну из самых популярных и удобных — Telegram Bot API PHP SDK. Установить ее можно с помощью Composer — менеджера зависимостей для PHP.

Откройте терминал и выполните следующую команду:

composer require irazasyed/telegram-bot-sdk

Шаг 3: Создание бота в Telegram

Чтобы начать работу с Telegram API, нам нужен бот. Создать его можно с помощью @BotFather — официального бота Telegram для управления ботами.

1. Откройте Telegram и найдите @BotFather.
2. Отправьте команду /start, чтобы начать взаимодействие с BotFather.
3. Отправьте команду /newbot и следуйте инструкциям для создания нового бота.
4. В конце процесса вы получите токен API, который будет использоваться для взаимодействия с вашим ботом.

Отправка сообщений с помощью PHP

Простой пример отправки сообщения

Давайте начнем с самого простого — отправки сообщения пользователю. Вот пример кода, который отправляет сообщение «Привет, мир!» пользователю с помощью нашего бота:

require 'vendor/autoload.php';

use Telegram\Bot\Api;

$telegram = new Api('ВАШ_API_ТОКЕН');

$response = $telegram->sendMessage([
    'chat_id' => 'ИД_ЧАТА',
    'text' => 'Привет, мир!'
]);

echo "Сообщение отправлено: " . $response->getMessageId();

Разбор кода

1. Подключаем автозагрузчик Composer.
2. Используем пространство имн Telegram\Bot\Api.
3. Создаем экземпляр ласса Api, передавая ему ваш API токен.
4. Вызываем метод sendMessage, передавая параметры chat_id (идентификатор чата) и text (текст сообщения).
5. Выводим идентификатор отправленного сообщения.

Где взять ID чата?

Чтобы отправить сообщение конкретному пользователю, нам нужно знать его идентификатор чата. Это можно сделать с помощью следующего кода, который выводит ID чата для входящего сообщения:

$updates = $telegram->getWebhookUpdates();
$chat_id = $updates->getMessage()->getChat()->getId();

echo "ID чата: " . $chat_id;

Этот код предполагает, что ваш бот настроен на использование вебхуков. В следующем разделе мы рассмотрим настройку вебхуков подробнее.

Настройка вебхуков для бота

Что такое вебхуки?

Вебхуки позволяют Telegram отправлять обновления (например, новые сообщения) на ваш сервер в реальном времени. Это более эффективный способ обработки событий, чем периодическое опрос API.

Настройка вебхуков

1. Разместите PHP-скрипт на вашем сервере, который будет обрабатывать входящие зпаросы.
2. Настройте вебхук для вашего бота с помощью следующего кода:

$telegram->setWebhook(['url' => 'ВАШ_УРЛ']);

Обработка входящих сообщений

Создайте файл webhook.php со следующим содержимым:

require 'vendor/autoload.php';

use Telegram\Bot\Api;

$telegram = new Api('ВАШ_API_ТОКЕН');
$updates = $telegram->getWebhookUpdates();

$chat_id = $updates->getMessage()->getChat()->getId();
$text = $updates->getMessage()->getText();

$response = $telegram->sendMessage([
    'chat_id' => $chat_id,
    'text' => 'Вы отправили: ' . $text
]);

echo "Сообщение отправлено: " . $response->getMessageId();

Этот скрипт получает обновления от Telegram, извлекает текст сообщения и отправляет его обратно пользователю.

Расширенные возможности бота

Обработка команд

Боты Telegram могут обрабатывать команды, которые начинаются с символа /. Например, команда /start обычно используется для приветствия новых пользователей.

Вот пример обработки команды:

$text = $updates->getMessage()->getText();

if ($text == '/start') {
    $response = $telegram->sendMessage([
        'chat_id' => $chat_id,
        'text' => 'Добро пожаловать! Как я могу помочь?'
    ]);
} else {
    $response = $telegram->sendMessage([
        'chat_id' => $chat_id,
        'text' => 'Вы отправили: ' . $text
    ]);
}

Отправка медиа-файлов

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

Вот пример отправки изображения:

$response = $telegram->sendPhoto([
    'chat_id' => $chat_id,
    'photo' => 'https://example.com/path/to/photo.jpg',
    'caption' => 'Вот ваше изображение!'
]);

Клавиатуры и кнопки

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

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

$keyboard = [
    ['Кнопка 1', 'Кнопка 2'],
    ['Кнопка 3', 'Кнопка 4']
];

$response = $telegram->sendMessage([
    'chat_id' => $chat_id,
    'text' => 'Выберите опцию:',
    'reply_markup' => json_encode(['keyboard' => $keyboard, 'resize_keyboard' => true, 'one_time_keyboard' => true])
]);

Работа с базой данных

Для хранения данных о пользователях или сообщениях вашего бота может понадобиться база данных. Рассмотрим приер использования SQLite для хранения данных о пользователях.

Установка и настройка SQLite

Для начала установите SQLite и создайте базу данных:

sqlite3 bot.db "CREATE TABLE users (id INTEGER PRIMARY KEY, chat_id INTEGER, username TEXT);"

Вставка и извлечение данных

Вот пример кода для вставки и извлечения данных из базы:

$db = new PDO('sqlite:bot.db');

$chat_id = $updates->getMessage()->getChat()->getId();
$username = $updates->getMessage()->getChat()->getUsername();

// Вставка данных
$stmt = $db->prepare("INSERT INTO users (chat_id, username) VALUES (:chat_id, :username)");
$stmt->bindParam(':chat_id', $chat_id);
$stmt->bindParam(':username', $username);
$stmt->execute();

// Извлечение данных
$stmt = $db->prepare("SELECT * FROM users WHERE chat_id = :chat_id");
$stmt->bindParam(':chat_id', $chat_id);
$stmt->execute();
$user = $stmt->fetch(PDO::FETCH_ASSOC);

if ($user) {
    $response = $telegram->sendMessage([
        'chat_id' => $chat_id,
        'text' => 'Добро пожаловать обратно, ' . $user['username'] . '!'
    ]);
} else {
    $response = $telegram->sendMessage([
        'chat_id' => $chat_id,
        'text' => 'Добро пожаловать, новый пользователь!'
    ]);
}

---

---