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

Подключите бот заявки и разрешите Telegram только для выбранных валют и направлений

Что вы получите

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

Платёжные реквизиты скрываются на сайте только у заявки, для которой мессенджер фактически доступен. Всё равно не включайте режим до полной проверки: клиентский путь зависит от главного переключателя, правила валюты, правила направления, бота, webhook и состояния заявки.

Подготовьте отдельного бота

Создайте нового бота по инструкции BotFather. Его токен не должен использоваться обычными уведомлениями или Security-кодами.

Откройте «Настройки» — «Общие настройки» — «Уведомления» — «Подключения» и нажмите «Добавить».

1

Выберите назначение

Тип — Telegram, назначение — «Продолжение обмена». Канал или группа не выбираются: бот работает в личных диалогах клиентов.

2

Укажите понятное название

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

3

Введите токен

Используйте токен отдельного бота. После сохранения полное значение больше не отображается.

4

Выберите транспорт

Для рабочего сайта используйте «Защищённый webhook». «Локальное polling» предназначено для среды разработки и требует постоянно работающего отдельного процесса.

5

Сохраните и включите

Активным может быть только один бот продолжения обмена. Не включайте второй экземпляр параллельно.

Проверьте production webhook

Параметр	Правило
Публичный URL	Доступен Telegram по постоянному HTTPS-адресу
Путь приложения	/telegram/order-chat/webhook
Пустое поле URL	Адрес строится из публичного URL сайта
Свой URL	Полный HTTPS-адрес согласованной точки reverse proxy
Защита	Фактический webhook и секрет подключения совпадают

Webhook и getUpdates не работают одновременно. Не используйте production-бот заявки для поиска группы через polling.

Включите главный режим

Откройте «Настройки» — «Общие настройки» — «Основные» — «Обмен». В поле «Где продолжать обмен» выберите «В мессенджерах по правилам валют и направлений».

Это только главный рубильник. Он не разрешает Telegram каждой заявке автоматически. Если выбрать «На сайте», правила валют и направлений сохранятся, но продолжение останется в браузере.

Разрешите валюту «Отдаю»

Откройте «Основное» — «Валюты» — «Список валют», выберите нужную валюту и перейдите в «Общее» — «Основное».

В поле «Продолжение заявки в мессенджерах» выберите:

Разрешить

Правило применяется к направлениям, где эта конкретная валюта и сеть стоят на стороне «Отдаю».

Запретить

Направления с этой валютой «Отдаю» продолжаются на сайте, если конкретное направление не разрешит мессенджер явно.

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

Tether TRC20 USDT и Tether ERC20 USDT являются разными валютами и сетями. Разрешение одной не включает другую.

Проверьте правило направления

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

Значение	Результат
По настройке валюты «Отдаю»	Наследуется правило конкретной валюты и сети
Разрешить для направления	Telegram разрешён независимо от запрета валюты
Запретить для направления	Telegram запрещён независимо от разрешения валюты

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

Итоговое разрешение сохраняется в новой заявке в момент её создания. Изменение валюты или направления не переписывает уже созданную заявку. Всегда проверяйте новым объектом.

Пройдите полный клиентский сценарий

1

Создайте две новые заявки

Создайте одну заявку для разрешённого направления и одну для запрещённого. Так вы докажете область правила, а не только работу бота.

2

Сверьте место продолжения

У разрешённой заявки должен появиться QR-код или ссылка Telegram. Запрещённая должна продолжаться на сайте и показывать реквизиты в браузере.

3

Свяжите точную заявку

Откройте deep-link. Бот должен привязать именно текущую заявку и не раскрыть данные другой.

4

Проверьте данные и таймер

Бот должен показать основные условия обмена, реквизиты, дополнительные поля, инструкцию и актуальное оставшееся время оплаты.

5

Нажмите «Я оплатил»

Выполняйте действие только по контрольному регламенту. После успеха кнопка должна стать недоступной повторно, а состояние — обновиться в Telegram, на сайте и в панели.

6

Проверьте повторный вход

Закройте и снова откройте диалог и страницу заявки. Должно восстановиться актуальное состояние без создания дубля.

Проверьте двусторонний чат

Клиент → оператор

Отправьте сообщение в Telegram. Оно должно появиться в чате правильной заявки с Telegram-именем и ID клиента.

Оператор → клиент

Ответьте из панели. Сообщение должно прийти в тот же личный диалог и сохраниться в общей истории заявки.

Проверьте автора, время, порядок, разрешённые вложения и отсутствие дублей после обновления страницы.

Безопасно верните заявки на сайт

Если сценарий не подтверждён:

1. для одного направления выберите «Запретить для направления»;
2. для всех направлений валюты выберите «Запретить» у валюты «Отдаю»;
3. при общем риске верните главный режим «На сайте»;
4. создайте новую заявку и убедитесь, что реквизиты доступны в браузере;
5. отключите проблемное подключение после перевода клиентского пути;
6. сохраните время, webhook URL и этап ошибки без токена;
7. исправьте причину и повторите обе заявки.

Не заменяйте токен наугад: это изменяет действующий webhook и работу текущих привязок бота.

Этап завершён, если

• создан отдельный бот с назначением «Продолжение обмена»;
• production использует защищённый HTTPS webhook;
• активен только один бот заявок;
• главный режим выбран после проверки бота;
• разрешение задано для точной валюты и сети «Отдаю»;
• переопределение направления выбрано осознанно;
• разрешённая и запрещённая новые заявки ведут себя по-разному;
• QR-код и ссылка открывают точную заявку;
• реквизиты, таймер и «Я оплатил» работают ожидаемо;
• чат синхронизируется в обе стороны без дублей;
• команда умеет отключить один контур и вернуть общий режим на сайт.

Далее организуйте рабочие группы панели.