> 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](/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-код и ссылка открывают точную заявку;
* [ ] реквизиты, таймер и **«Я оплатил»** работают ожидаемо;
* [ ] чат синхронизируется в обе стороны без дублей;
* [ ] команда умеет отключить один контур и вернуть общий режим на сайт.

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.iexexchanger.com/learn/7.-telegram/11-telegram-continuation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.