Telegram-подключения

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

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

Точка входа в панели: «Настройки» — «Общие настройки» — «Уведомления» — «Подключения». Для страницы требуется хотя бы одно из прав: «Настройки уведомлений» из блока «Настройки», «Telegram-уведомления» из блока «Админпанель» или «Общие настройки» из блока «Админпанель». Для настройки бота Security-кодов дополнительно требуется право «Telegram-бот безопасности» из блока «Безопасность».

Права находятся по пути «Пользователи» — «Список групп пользователей». Откройте нужную группу. Обычному сотруднику уведомлений выдавайте только минимальное право его обязанности.

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

1. Создайте бота через официальный BotFather и получите токен. Полный порядок приведён в статье «Telegram-боты, группы и каналы».
2. Откройте «Настройки» — «Общие настройки» — «Уведомления» — «Подключения».
3. Нажмите «Добавить» и выберите Telegram.
4. Выберите «Назначение».
5. Для обычных уведомлений выберите «Куда отправлять».
6. Задайте «Название» и нажмите «Создать».
7. Откройте подключение и заполните «Токен доступа Telegram-бота».

Токен после сохранения хранится в зашифрованном виде и полностью не отображается. «Параметр заполнен» и маскированная часть подтверждают наличие значения. Не используйте один токен в разных подключениях.

Обычные уведомления

Назначение «Уведомления» поддерживает три места отправки:

• «В канал» — общие сообщения для сотрудников;
• «В группу» — сообщения рабочей группе сотрудников;
• «В бота» — личные сообщения клиентам и сотрудникам.

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

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

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

Security-коды

Назначение «Security-коды» используется только для одноразовых кодов входа и подтверждения важных действий. После сохранения подтвердите владельца по предусмотренному процессу.

В карточке проверяйте имя бота, ID, владельца и время последней проверки токена. Изменение или отвязка защищаются шестизначным кодом, отправленным владельцу по E-mail. Такое подключение нельзя удалить обычным действием списка.

Продолжение обмена

Назначение «Продолжение обмена» создаёт интерактивного личного бота. Клиент получает в нём платёжные реквизиты, а переписка синхронизируется с чатом заявки. Активным может быть только один такой бот.

Для рабочего сервера выберите «Защищённый webhook». Telegram должен обращаться к публичному HTTPS-адресу. Поле «Публичный URL webhook» можно оставить пустым для адреса сайта либо указать полный HTTPS-адрес, если используется отдельная точка входа.

«Локальное polling» предназначено для локальной проверки без публичного адреса. Оно требует постоянно работающего процесса, указанного самой формой, и не является обычным рабочим режимом сервера.

Кнопка продолжения обмена появляется у клиента только при одновременном выполнении условий:

• в настройке «Где продолжать обмен» выбран вариант «В мессенджерах по правилам валют и направлений»;
• чат заявок включён;
• текущий статус входит в список статусов, для которых показывается чат;
• подключение «Продолжение обмена» включено и успешно проверено;
• заявка не использует несовместимый сценарий оплаты.

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

События и проверка

Для обычного подключения откройте действие «Уведомления», выберите события и приоритеты. Security-коды и продолжение обмена имеют собственный ограниченный сценарий и не получают произвольный набор обычных событий.

1. Нажмите «Проверить» и убедитесь, что состояние стало «Стабильно».
2. Для канала или группы вызовите безопасное административное событие.
3. Для личного бота проверьте /start и клиентское событие.
4. Для продолжения обмена создайте тестовую заявку и откройте Telegram с клиентского шага оплаты.
5. Ответьте из Telegram и убедитесь, что сообщение появилось в чате той же заявки.
6. Ответьте оператором и проверьте доставку клиенту без дубля.

Если сообщение не приходит, проверьте общий переключатель Telegram, статус подключения, назначение, место отправки, выбранное событие, токен и результат последней проверки.