Перейти к содержанию
11 минут чтения
Тема: Интеграции PHP · Каналы · Bot API

Как публиковать сообщения в Telegram-канал через бота: пример на PHP

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

Готовим бота и тестовый канал

Создайте отдельный канал для проверки и добавьте своего бота администратором с правом публикации сообщений. Не выдавайте остальные права только ради этого примера. Публикации в канал и сообщения в связанную группу обсуждений — разные назначения: здесь нужен сам канал.

Для публичного канала можно использовать @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 · telegram.php
<?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 · check-channel.php
<?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;
Bash / PowerShell · запуск проверки
php check-channel.php

Сверьте имя бота, название канала и числовой ID с тестовым каналом. Этот шаг ничего в него не отправляет. Если проверка прав не прошла, исправьте роль именно этого бота. Успешный getChat сам по себе недостаточен: доступ к описанию чата не доказывает возможность публикации.

Публикуем один тестовый пост

Следующий запуск действительно отправит сообщение в указанный канал. Текст фиксированный, уведомление без звука. Запустите его один раз после проверки адреса.

PHP · publish.php
<?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;
Bash / PowerShell · отправка тестового поста
php publish.php

Убедитесь, что пост появился, и сохраните полученную пару chat_id + message_id. В интеграции с CMS храните её рядом с ID новости и ID бота. message_id без чата недостаточен. Повторный запуск создаст ещё один пост.

Между отправкой и записью message_id в БД есть окно сбоя. Если ответ потерян, не помечайте публикацию как точно неотправленную и не повторяйте её вслепую. Отдельное состояние «результат неизвестен» помогает остановить автоматический дубль и проверить канал.

Как разбирать дубли и неизвестный результат отправки

Исправляем опубликованный текст

Возьмите message_id из результата предыдущего шага и задайте TELEGRAM_MESSAGE_ID в окружении. TELEGRAM_CHAT_ID должен указывать на тот же канал. Скрипт изменит тестовый пост, а не создаст новый.

PHP · edit.php
<?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 остаются те же права, канал и параметры сообщения.

Bash / PowerShell · установка SDK
composer require botgate/sdk

SDK требует PHP 8.2+. Задайте BOTGATE_API_KEY, BOTGATE_BOT_ID и TELEGRAM_CHAT_ID в окружении. Сохраните настройку клиента в botgate.php:

PHP · 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 · publish-botgate.php
<?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 для этого примера, чтобы потерянный ответ не вызывал скрытую повторную публикацию. В рабочей очереди назначьте один уровень управления повторами.

Ошибки и ответы PHP SDK

Проверяем результат

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

  • Один запуск publish.php создал один пост, а полученная пара ID сохранена.

  • edit.php изменил этот пост и не создал новый.

  • После отзыва права публикации отправка останавливается с ошибкой.

  • Повторное событие CMS и сетевой сбой не запускают бесконтрольные публикации.

Источники

Telegram: sendMessage

Telegram: ChatMemberAdministrator

Telegram: editMessageText

PHP: cURL

BotGate SDK на Packagist