Перейти к содержанию
12 минут чтения
Тема: Практика PHP · Поддержка · Рабочая группа

Как сделать Telegram-бота для поддержки: ответы оператора из группы

Для примера сделаем поддержку небольшого сервиса: клиент пишет боту в личный чат, а менеджер отвечает из закрытой Telegram-группы. Клиент получает ответ от бота и не вступает в рабочую группу. Разберём, как связать сообщения с обращением, передать фото или документ и не отправить клиенту внутреннее обсуждение.

Как проходит обращение

Пусть клиент спрашивает о доставке и прикладывает фотографию. Приложение создаёт обращение №1042, публикует в группе карточку с номером и копирует сообщения клиента. Оператор выбирает «Ответить» на карточке или скопированном сообщении. Только такой ответ становится кандидатом на отправку клиенту. Обычные сообщения группы остаются внутренними.

Ответ оператора через Reply на карточку №1042 приходит клиенту от бота, а внутреннее сообщение без Reply остаётся в рабочей группе.
Ответ оператора через Reply на карточку №1042 приходит клиенту от бота, а внутреннее сообщение без Reply остаётся в рабочей группе.
Схема маршрутизации из статьи. Переписка вымышленная; Reply показан условно, это не снимок Telegram.

Для этого сценария не нужны Telegram Business и доступ к личному аккаунту менеджера. Нужны обычный бот, закрытая группа, сервер с БД и уже настроенный приём обновлений. PHP-примеры ниже рассчитаны на PHP 8.3+ на 64-битной системе и PDO SQLite. Это ядро маршрутизации: HTTP-приёмник, хранилище обращений и worker отправки подключаются в вашем приложении.

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

Настройку входящих событий разбираем отдельно в руководстве по webhook. При прямом подключении проверяйте secret_token Telegram; успешный HTTP-ответ возвращайте после надёжного сохранения update, а не перед ним.

Настраиваем рабочую группу и операторов

Добавьте бота в отдельную закрытую группу и проверьте, что он может отправлять сообщения и нужные виды вложений. Не используйте общую группу компании, если доступ к обращениям нужен только поддержке. Участники такой группы увидят скопированное содержимое клиентов.

При включённом Privacy Mode бот получает ответы на свои сообщения. Поэтому карточку и копии публикует именно бот, а оператор отвечает на них через Reply. Для этого режима не требуется отключать приватность только ради чтения всего обсуждения. Исключения и взаимодействие нескольких ботов описаны в официальном FAQ Telegram.

Право писать в группе и право отвечать клиенту — разные вещи. Храните отдельный список разрешённых Telegram user_id операторов для конкретного бота. Проверяйте его при каждом ответе и закрытии обращения. Username меняется, а присутствие в группе само по себе не даёт прикладное право отправки.

Отклоняйте сообщения с sender_chat: так может выглядеть ответ анонимного администратора, за которым нельзя надёжно определить конкретного оператора. Для поддержки попросите менеджеров отвечать от личного профиля. Не обрабатывайте сообщения других ботов как ответы клиентов.

Если ответ не приходит на сервер, проверьте тип update, allowed_updates и Reply на сообщение именно вашего бота. Дополнительная диагностика есть в статье почему бот не видит сообщения группы.

Сохраняем связь между сообщением и обращением

Не извлекайте chat_id клиента из подписи, пересланного профиля или произвольного текста «Заявка №1042». Маршрут берётся только из БД. Message ID уникален внутри чата, поэтому ключ связи включает бота, рабочую группу и сообщение в ней.

SQL · минимальная таблица привязок
CREATE TABLE support_message_map (
    bot_id TEXT NOT NULL,
    group_chat_id INTEGER NOT NULL,
    group_message_id INTEGER NOT NULL,
    ticket_id INTEGER NOT NULL,
    PRIMARY KEY (bot_id, group_chat_id, group_message_id)
);

В отдельной таблице support_tickets храните id, bot_id, private_chat_id и status со значениями open/closed. В таблице операторов — bot_id, user_id и active. Поддерживайте создание единственного открытого обращения транзакцией и ограничением, подходящим вашей БД. Telegram chat_id сохраняйте в signed BIGINT: у группы он может быть отрицательным.

Сначала sendMessage создаёт служебную карточку. Сохраните result.message_id этой карточки в support_message_map. Затем copyMessage копирует клиентское сообщение; его result.message_id тоже привяжите к тому же ticket_id. Так Reply работает и на карточке, и на фотографии ниже неё.

JSON · параметры copyMessage из личного чата в группу
{
  "chat_id": -1001234567890,
  "from_chat_id": 123456789,
  "message_id": 57,
  "reply_parameters": {"message_id": 901}
}

Здесь 57 — сообщение клиента, 901 — уже созданная карточка в целевой группе. Числа демонстрационные. Для sendMessage результатом служит Message, для copyMessage — MessageId: в обоих случаях нужный идентификатор находится в result.message_id. Записывайте привязку только после успешного ответа API.

Если API создал сообщение, а сохранение привязки не удалось, ответ оператора на него нельзя безопасно направить клиенту. Покажите служебную ошибку и восстановите связь по журналу операции. Не подставляйте «последнего клиента», даже если сейчас он один.

Проверяем ответ оператора до отправки

Следующая функция не обращается к Telegram. Она проверяет сообщение и возвращает параметры copyMessage либо null. Вызовите её для message из уже проверенного update; edited_message здесь намеренно не обрабатывается, чтобы редактирование не стало второй отправкой.

PHP · support-route.php
<?php
declare(strict_types=1);

/** @param array<string, mixed> $message
 *  @param list<int> $operatorIds
 *  @return array{chat_id: int, from_chat_id: int, message_id: int}|null
 */
function operatorReply(
    PDO $db, string $botId, int $groupId,
    array $operatorIds, array $message,
): ?array {
    if (($message['chat']['id'] ?? null) !== $groupId
        || isset($message['sender_chat'])
        || ($message['from']['is_bot'] ?? true)
        || !in_array($message['from']['id'] ?? null, $operatorIds, true)) {
        return null;
    }
    $parentId = $message['reply_to_message']['message_id'] ?? null;
    $messageId = $message['message_id'] ?? null;
    if (!is_int($parentId) || !is_int($messageId)) {
        return null;
    }
    $supported = isset($message['text']) || isset($message['photo'])
        || isset($message['document']) || isset($message['voice'])
        || isset($message['video']) || isset($message['audio']);
    if (!$supported || str_starts_with(trim($message['text'] ?? ''), '/')) {
        return null;
    }
    $query = $db->prepare(
        'SELECT t.private_chat_id FROM support_message_map m
         JOIN support_tickets t ON t.id = m.ticket_id AND t.bot_id = m.bot_id
         WHERE m.bot_id = ? AND m.group_chat_id = ? AND m.group_message_id = ?
         AND t.status = ?'
    );
    $query->execute([$botId, $groupId, $parentId, 'open']);
    $chatId = $query->fetchColumn();
    return $chatId === false ? null : [
        'chat_id' => (int) $chatId,
        'from_chat_id' => $groupId,
        'message_id' => $messageId,
    ];
}

Список operatorIds загружайте из актуального хранилища прав. Возвращённый массив — параметры copyMessage из рабочей группы в личный чат клиента. Null означает «не отправлять клиенту»: для неподдерживаемого вложения или закрытого обращения лучше дать оператору отдельное служебное объяснение.

Перед реальной отправкой worker повторно проверяет статус обращения и права оператора. Само разрешение, полученное при приёме update, может устареть, пока операция ждёт очереди. В очередь сохраняйте bot_id, ticket_id, user_id оператора и исходные group_chat_id/message_id, а не только готовый адрес назначения.

Передаём вложения и не теряем контекст

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

Метод не универсален для всех сообщений: ограничения перечислены в документации copyMessage. В примере есть явный список поддерживаемых типов. На отклонённое вложение сообщите оператору причину и предложите отправить обычный документ или текст; не отвечайте клиенту, что файл доставлен.

Один альбом приходит несколькими message с общим media_group_id. Если копировать каждую часть отдельно, содержимое передастся отдельными сообщениями, а исходное оформление альбома не сохранится. Для сохранения группировки нужен отдельный накопитель частей и copyMessages с упорядоченными message_id. Каждый полученный ID свяжите с обращением; не обещайте сохранение альбома кодом одиночного copyMessage.

Функция выше также не переносит историю диалога автоматически. Если менеджер отвечает на своё прежнее сообщение, которого нет в support_message_map, маршрут не найдётся. Либо просите отвечать на карточку/копию клиента, либо отдельно добавляйте в таблицу такие сообщения после подтверждённой отправки.

Закрываем диалог и учитываем повторную доставку

Выделите команду /close, отправляемую Reply на карточку. Обработчик команды выполняется до обычной маршрутизации: проверяет группу, личность оператора и привязку, затем атомарно меняет open на closed. Команду не копируют клиенту. Повторное закрытие возвращает оператору «Обращение уже закрыто» и не запускает новое уведомление.

Для команды с упоминанием бота распознавайте /close@имя_вашего_бота, проверяя адресата. Уведомление клиенту о закрытии — отдельная отправка с собственным состоянием, а не обязательный побочный эффект каждого повторного update. После закрытия новый входящий текст создаёт новое обращение по выбранному правилу; старые карточки остаются привязанными к старому ticket_id.

Входящие обновления сохраняйте с уникальным ключом (bot_id, update_id), а операцию ответа — с ключом (bot_id, group_chat_id, group_message_id). Повтор webhook должен находить уже созданную операцию, а не заново копировать сообщение. При этом уникальность в БД не делает Telegram-отправку однократной: после таймаута результат может быть неизвестен.

Храните состояния pending, sending, sent, failed и unknown. При ok=true запишите ID отправленного сообщения. При подтверждённом лимите планируйте повтор по retry_after; после потери ответа переводите в unknown и разбирайте ситуацию, прежде чем повторять. Подробнее — диагностика дублей сообщений.

Проверяем поддержку на двух клиентах

  • Два тестовых клиента пишут почти одновременно. Ответ на карточку первого приходит только первому; ответ на фото второго — только второму.

  • Сообщение без Reply, ответ постороннего участника и ответ анонимного администратора не уходят клиентам.

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

  • После /close старый Reply не отправляется, а новое обращение получает другую карточку.

  • Повтор одного update не создаёт второй операции; таймаут отправки виден в журнале как неизвестный результат.

Если используете BotGate, меняется транспорт вызовов Telegram и проверка входящего webhook. Связи сообщений, права операторов, обращения и журнал отправок остаются в вашем приложении. Входящую подпись проверяйте по исходным байтам тела согласно документации webhook BotGate; не подменяйте её проверкой Telegram secret_token. Для исходящих методов см. подключение API.