Categories: Скрипты

Скрипт PHP для отправки сообщений в телеграм

Рассмотрим простой сценарий отправки сообщения в канал телеграма с помощью бота. Скрипт будет написан на языке программирования PHP.

Предварительная настройка
Пример скрипта

Подготовка

Прежде чем создать скрипт, нам нужно:

Создать телеграм бота.
Дать права созданному боту в канале, куда будем отправлять сообщения.
Убедиться в корректности настройки, отправив тестовое сообщение с помощью curl.
Установить php-расширение curl.

Приступим.

Создание бота

Открываем телеграм и ищем пользователя @BotFather :

Переходим в чат с найденным BotFather и запускаем бота:

Создаем бота, последовательно введя команду /newbot и отвечая на запросы мастера. Например:

/newbot

remontka_digest

remontkaDigestBot

* где:

/newbot — команда для создания нового телеграм бота.
remontka_digest — имя бота.
remontkaDigestBot — имя учетной записи бота. Обязательно должно быть Bot на конце.

В результате мы должны получить сообщение на подобие:

Done! Congratulations on your new bot. You will find it at t.me/remontkaDigestBot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you’ve finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.

Use this token to access the HTTP API:
1234567890:ABCDEFGHIYKLMNOPI8e48SeTHIGfzD8W4E
Keep your token secure and store it safely, it can be used by anyone to control your bot.

For a description of the Bot API, see this page: https://core.telegram.org/bots/api

* где 1234567890:ABCDEFGHIYKLMNOPI8e48SeTHIGfzD8W4E — токен бота. Его храним в безопасном месте.

Бот создан. Идем дальше.

Даем права боту отправлять сообщения в канал

Открываем наш телеграм канал, в который будут отправляться сообщения ботом. Добавляем бота в подписчики:

Мессенджер предложит назначить бота администратором. Соглашаемся и настраиваем разрешения. Как минимум, нужно разрешить отправку сообщений.

Теперь у нас есть все, чтобы сделать отправку сообщения в канал телеграма с помощью бота.

Делаем тестовую отправку сообщения

Нам, всего, нужно сделать запрос типа GET с синтаксисом:

https://api.telegram.org/bot<BotID>/sendMessage?chat_id=<ChannelName>&text=<Text>

Проще всего, для этого использовать утилиту командной строки curl. Для Windows она доступна в Powershell. Для Linux необходима установка (команда зависит от типа ОС):

а) Linux DEB (Debian / Ubuntu / Astra):

apt update

apt install curl

б) Linux RPM (Rocky / CentOS / РЕД ОС):

yum install curl

Теперь приведем реальный пример отправки сообщения с помощью curl.

Вводим команду:

curl ‘https://api.telegram.org/bot1234567890:ABCDEFGHIYKLMNOPI8e48SeTHIGfzD8W4E/sendMessage?chat_id=@remontka_ru&text=test’

* где:

1234567890:ABCDEFGHIYKLMNOPI8e48SeTHIGfzD8W4E — токен бота, который мы получили ранее.
@remontka_ru — название телеграм канала.
test — текст сообщения.

Проверяем сообщение в телеграм канале — мы должны увидеть наше тестовое сообщение:

Это значит, что наш бот может отправлять сообщения в канал.

Установка расширения php-curl

API телеграма реализовано с помощью сервиса, который отвечает на HTTP-запросы. В php данные запросы удобнее всего отправлять с помощью модуля curl. Необходимо убедиться, что он установлен.

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

Если запуск скрипта выполняется на собственном сервере, установим расширение самостоятельно.

а) Linux DEB (Debian / Ubuntu / Astra):

apt install php-curl

Если у нас установлено несколько версий PHP, возможно, придется уточнить версию, для которой необходима установка расширения, например:

apt install php8.2-curl

б) Linux RPM (Rocky / CentOS / РЕД ОС):

yum install php-curl

Теперь мы готовы писать скрипт.

Пример скрипта

Данный скрипт отправит простое текстовое сообщение в созданный ранее телеграм канал:

<?php
$chat_name = «@remontka_ru»;
$token = «1234567890:ABCDEFGHIYKLMNOPI8e48SeTHIGfzD8W4E»;
$message = «Здравствуйте.nЭто тестовое сообщение, отправленное ботом с помощью PHP-скрипта.nnВсем хорошего дня.»;
$text = urlencode($message);
$url = «https://api.telegram.org/bot{$token}/sendMessage?chat_id={$chat_name}&text={$text}»;
$ch = curl_init();
$optArray = array(
CURLOPT_URL => $url,
CURLOPT_RETURNTRANSFER => true
);
curl_setopt_array($ch, $optArray);
$result = curl_exec($ch);
curl_close($ch);
?>

Описание скрипта:

Строка	Описание
3	Переменная с указанием на имя канала, куда будет отправлено сообщение. У бота должны быть права отправки сообщения в данный канал.
4	Токен, который мы получили, когда создали бота.
5	Текст сообщения, которое будет отправлено в телеграм.
7	Прежде чем отправить сообщение, выполняем ее URL-кодирование, так как текст будет отправлен как часть GET-запроса.
8	Создаем переменную, значением которой будет строка обращения к Telegram API. Данная строка содержит токен, имя канала и текстовое сообщение. Действие будет sendMessage , то есть, отправка сообщения.
10 — 15	Инициализируем настройку curl. Указываем, что для запроса будет использоваться переменная $url. Также ответ от сервера должен возвращаться в виде строки, а не в поток вывода.
16	Выполняем запрос curl.
17	Удаляем все дескрипторы для запроса, чтобы не занимать память сервера.