Готовим бота и тестовый канал
Создайте отдельный канал для проверки и добавьте своего бота администратором с правом публикации сообщений. Не выдавайте остальные права только ради этого примера. Публикации в канал и сообщения в связанную группу обсуждений — разные назначения: здесь нужен сам канал.
Для публичного канала можно использовать @username. Для закрытого канала нужен числовой chat_id: его можно получить из chat.id в обновлении channel_post, если получение таких обновлений настроено. Не пытайтесь вычислить ID из ссылки-приглашения.
Если адрес неизвестен или Telegram отвечает chat not found, проверьте chat_id и доступ
Ниже — самостоятельные CLI-скрипты для PHP 8.2+ с расширением cURL. Задайте TELEGRAM_BOT_TOKEN и TELEGRAM_CHAT_ID в окружении процесса средствами своего сервера. Файл .env обычный PHP сам не читает. Скрипты храните вне public и не вызывайте отправку при простом открытии страницы.
Добавляем небольшой клиент Bot API
Сохраните этот код как telegram.php. Он используется следующими скриптами. Функция отправляет один запрос, возвращает result и прекращает выполнение при ошибке; автоматических повторов нет. В сообщение исключения не включается URL с токеном.
<?php
declare(strict_types=1);
function requiredEnv(string $name): string
{
$value = getenv($name);
if ($value === false || $value === '') {
throw new RuntimeException('Не задана переменная '.$name);
}
return $value;
}
/** @param array<string, mixed> $params
* @return array<string, mixed>|list<array<string, mixed>>
*/
function telegram(string $method, array $params, bool $multipart = false): array
{
if (!preg_match('/\A[a-zA-Z]+\z/', $method)) {
throw new InvalidArgumentException('Некорректный метод');
}
$body = $multipart ? $params : json_encode($params, JSON_THROW_ON_ERROR);
$curl = curl_init('https://api.telegram.org/bot'.requiredEnv('TELEGRAM_BOT_TOKEN').'/'.$method);
if ($curl === false) {
throw new RuntimeException('Не удалось создать запрос');
}
curl_setopt_array($curl, [
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => $body,
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CONNECTTIMEOUT => 10,
CURLOPT_TIMEOUT => 60,
CURLOPT_HTTPHEADER => $multipart ? [] : ['Content-Type: application/json'],
]);
$raw = curl_exec($curl);
$status = (int) curl_getinfo($curl, CURLINFO_RESPONSE_CODE);
if ($raw === false) {
// Не выводим URL: он содержит токен бота.
throw new RuntimeException('Сетевой сбой; результат отправки может быть неизвестен');
}
$data = json_decode($raw, true, 512, JSON_THROW_ON_ERROR);
if (!is_array($data) || ($data['ok'] ?? false) !== true) {
$error = is_array($data) ? (int) ($data['error_code'] ?? 0) : 0;
$wait = is_array($data) ? ($data['parameters']['retry_after'] ?? null) : null;
throw new RuntimeException('Telegram: HTTP '.$status.', error_code '.$error
.(is_int($wait) ? ', retry_after '.$wait.' с' : ''));
}
if ($status < 200 || $status >= 300 || !is_array($data['result'] ?? null)) {
throw new RuntimeException('Неожиданный ответ; автоматический повтор отключён');
}
return $data['result'];
}
Ошибки JSON или неожиданный ответ тоже должны остановить публикацию. Не включайте полный ответ и заголовки авторизации в публичный текст ошибки. В рабочем приложении сохраняйте безопасный код результата и идентификатор задания.
Проверяем доступ без публикации
<?php
declare(strict_types=1);
require __DIR__.'/telegram.php';
$target = requiredEnv('TELEGRAM_CHAT_ID');
$me = telegram('getMe', []);
$chat = telegram('getChat', ['chat_id' => $target]);
if (($chat['type'] ?? null) !== 'channel' || !is_int($chat['id'] ?? null)
|| !is_int($me['id'] ?? null)) {
throw new RuntimeException('Ожидался канал и корректный ID бота');
}
$member = telegram('getChatMember', ['chat_id' => $chat['id'], 'user_id' => $me['id']]);
if (($member['status'] ?? null) !== 'administrator' || ($member['can_post_messages'] ?? false) !== true) {
throw new RuntimeException('Боту нужны права администратора на публикацию');
}
echo json_encode(['bot' => $me['username'] ?? null, 'channel' => $chat['title'] ?? null,
'chat_id' => $chat['id']], JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;
php check-channel.php
Сверьте имя бота, название канала и числовой ID с тестовым каналом. Этот шаг ничего в него не отправляет. Если проверка прав не прошла, исправьте роль именно этого бота. Успешный getChat сам по себе недостаточен: доступ к описанию чата не доказывает возможность публикации.
Публикуем один тестовый пост
Следующий запуск действительно отправит сообщение в указанный канал. Текст фиксированный, уведомление без звука. Запустите его один раз после проверки адреса.
<?php
declare(strict_types=1);
require __DIR__.'/telegram.php';
$result = telegram('sendMessage', [
'chat_id' => requiredEnv('TELEGRAM_CHAT_ID'),
'text' => 'Тестовая новость: в субботу мастерская работает до 18:00.',
'disable_notification' => true,
]);
if (!is_int($result['message_id'] ?? null) || !is_int($result['chat']['id'] ?? null)) {
throw new RuntimeException('Не получены идентификаторы публикации; проверьте канал');
}
echo json_encode(['chat_id' => $result['chat']['id'], 'message_id' => $result['message_id']],
JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;
php publish.php
Убедитесь, что пост появился, и сохраните полученную пару chat_id + message_id. В интеграции с CMS храните её рядом с ID новости и ID бота. message_id без чата недостаточен. Повторный запуск создаст ещё один пост.
Между отправкой и записью message_id в БД есть окно сбоя. Если ответ потерян, не помечайте публикацию как точно неотправленную и не повторяйте её вслепую. Отдельное состояние «результат неизвестен» помогает остановить автоматический дубль и проверить канал.
Исправляем опубликованный текст
Возьмите message_id из результата предыдущего шага и задайте TELEGRAM_MESSAGE_ID в окружении. TELEGRAM_CHAT_ID должен указывать на тот же канал. Скрипт изменит тестовый пост, а не создаст новый.
<?php
declare(strict_types=1);
require __DIR__.'/telegram.php';
$messageId = filter_var(requiredEnv('TELEGRAM_MESSAGE_ID'), FILTER_VALIDATE_INT);
if (!is_int($messageId) || $messageId < 1) {
throw new RuntimeException('Нужен message_id опубликованного поста');
}
telegram('editMessageText', [
'chat_id' => requiredEnv('TELEGRAM_CHAT_ID'),
'message_id' => $messageId,
'text' => 'Уточнение: в субботу мастерская работает до 17:00.',
]);
echo 'Текст обновлён', PHP_EOL;
Проверьте изменение того же сообщения в канале. Если сообщение удалили, адрес перепутан или права изменились, сначала выясните причину. Не подменяйте неудачное редактирование автоматической новой публикацией. Повтор с тем же текстом может не дать успешного изменения; сравнивайте желаемое содержимое с сохранённой версией.
Подключаем к публикации новости на сайте
Задание создаётся после сохранения опубликованной новости, а не на каждом её просмотре.
Храните состояние публикации и уникальный ключ «новость + канал + бот». Параллельные задания не должны независимо создавать один пост.
Проверяйте, что новость всё ещё опубликована и разрешена к отправке в выбранный канал.
Сохраните message_id после подтверждённого ответа; последующие изменения направляйте на редактирование.
При 429 отложите задание с учётом retry_after; при ошибке параметров исправьте запрос. Таймаут требует проверки неизвестного результата.
Сам Telegram Bot API не заменяет планировщик вашего сайта: отложенное задание для обычной публикации запускает приложение. Работу очередей и ограничения отправки лучше держать отдельно от обработчика сохранения страницы.
Та же публикация через BotGate
Если выбрали BotGate, добавьте бота в сервис и используйте API-ключ с публичным ID бота. TELEGRAM_BOT_TOKEN для следующего примера не нужен. На стороне Telegram остаются те же права, канал и параметры сообщения.
composer require botgate/sdk
SDK требует PHP 8.2+. Задайте BOTGATE_API_KEY, BOTGATE_BOT_ID и TELEGRAM_CHAT_ID в окружении. Сохраните настройку клиента в botgate.php:
<?php
declare(strict_types=1);
require __DIR__.'/vendor/autoload.php';
use BotGate\Client;
use BotGate\Config;
$apiKey = getenv('BOTGATE_API_KEY');
$botId = getenv('BOTGATE_BOT_ID');
if (!is_string($apiKey) || $apiKey === '' || !is_string($botId) || $botId === '') {
throw new RuntimeException('Задайте BOTGATE_API_KEY и BOTGATE_BOT_ID');
}
$bot = Client::fromConfig(new Config(
apiKey: $apiKey,
timeout: 60.0,
maxRetries: 0,
))->bot($botId);
<?php
declare(strict_types=1);
require __DIR__.'/botgate.php';
$chatId = getenv('TELEGRAM_CHAT_ID');
if (!is_string($chatId) || $chatId === '') {
throw new RuntimeException('Задайте TELEGRAM_CHAT_ID');
}
$response = $bot->call('sendMessage', [
'chat_id' => $chatId,
'text' => 'Тестовая новость через BotGate.',
'disable_notification' => true,
]);
echo json_encode($response->result, JSON_UNESCAPED_UNICODE | JSON_THROW_ON_ERROR), PHP_EOL;
Это альтернативная отправка: запуск обоих вариантов создаст два поста. maxRetries: 0 отключает автоматические повторы SDK для этого примера, чтобы потерянный ответ не вызывал скрытую повторную публикацию. В рабочей очереди назначьте один уровень управления повторами.
Проверяем результат
Проверка доступа показала ожидаемого бота и тестовый канал.
Один запуск publish.php создал один пост, а полученная пара ID сохранена.
edit.php изменил этот пост и не создал новый.
После отзыва права публикации отправка останавливается с ошибкой.
Повторное событие CMS и сетевой сбой не запускают бесконтрольные публикации.