> For the complete documentation index, see [llms.txt](https://docs.iexexchanger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.iexexchanger.com/learn/7.-telegram/11-telegram-continuation.md).

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

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

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

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

```mermaid
flowchart LR
    A["Главный режим: мессенджеры"] --> B["Правило валюты Отдаю"]
    B --> C["Переопределение направления"]
    C --> D["Снимок правила в новой заявке"]
    D --> E["Доступный бот и статус заявки"]
    E --> F["Telegram или сайт"]
```

{% hint style="danger" %}
Платёжные реквизиты скрываются на сайте только у заявки, для которой мессенджер фактически доступен. Всё равно не включайте режим до полной проверки: клиентский путь зависит от главного переключателя, правила валюты, правила направления, бота, webhook и состояния заявки.
{% endhint %}

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

Создайте нового бота по [инструкции BotFather](https://docs.iexexchanger.com/learn/7.-telegram/08-telegram-bot.md). Его токен не должен использоваться обычными уведомлениями или Security-кодами.

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

{% stepper %}
{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

## Проверьте production webhook

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

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

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

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

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

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

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

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

{% tabs %}
{% tab title="Разрешить" %}
Правило применяется к направлениям, где эта конкретная валюта и сеть стоят на стороне **«Отдаю»**.
{% endtab %}

{% tab title="Запретить" %}
Направления с этой валютой **«Отдаю»** продолжаются на сайте, если конкретное направление не разрешит мессенджер явно.
{% endtab %}
{% endtabs %}

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

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

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

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

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

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

{% hint style="info" %}
Итоговое разрешение сохраняется в новой заявке в момент её создания. Изменение валюты или направления не переписывает уже созданную заявку. Всегда проверяйте новым объектом.
{% endhint %}

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

{% stepper %}
{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

{% step %}

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

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

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

{% columns %}
{% column %}

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

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

{% column %}

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

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

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

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

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

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

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

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

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

Далее организуйте [рабочие группы панели](https://docs.iexexchanger.com/learn/8.-rabota-s-zayavkami/01-workspace-groups.md).
