> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botflow.cc/llms.txt
> Use this file to discover all available pages before exploring further.

# Мессенджер

> Чат с подписчиками через ботов: список чатов, фильтры и готовые срезы по воронке, шаблоны быстрых ответов, медиа, перевод, статусы доставки и передача переписки ИИ-оператору.

Мессенджер это чат с подписчиками поверх ваших ботов. В меню бота он открывается пунктом **«Сообщения»** (группа **«Общение»**). Операторы видят все диалоги в одном окне и отвечают вручную, а часть переписок ведёт [ИИ-оператор](/ru/ai-operator). Раздел всегда открыт для одного выбранного бота: слева список чатов, в центре сам диалог, справа карточка подписчика.

<Note>Строка диалога появляется, когда подписчик впервые пишет боту, а также когда он приходит по инвайту и его заявку одобряют. По инвайту бот может написать первым, но ограниченное время: примерно 5 минут, пока подписчик не ответил. Дальше писать ему можно после его первого ответа. Клики по рекламе и переходы по ссылке сами по себе чат не создают. Импортированных подписчиков список тоже показывает, даже если они ещё не писали боту: такие чаты идут внизу.</Note>

## Список чатов

Слева колонка со всеми диалогами бота. Каждая строка показывает аватар, имя подписчика, превью последнего сообщения и его время. У исходящих превью начинается с «Вы:». Если последним было медиа, вместо текста стоит иконка типа: 📷 Фото, 🎬 Видео, 🎤 Голосовое, 📹 Видеосообщение, 🎵 Аудио, 📎 Документ. Непрочитанные диалоги помечены счётчиком, а подписчики, заблокировавшие бота, плашкой «Заблокирован».

### Поиск

Поле «Поиск» вверху колонки ищет по имени подписчика и его username. Пока в поле есть запрос, в списке остаются только совпадения.

### Фильтры списка чатов

Кнопка с иконкой ползунков справа от поиска открывает меню из пяти режимов. Активен всегда один режим.

| Режим           | Что показывает                                                        |
| --------------- | --------------------------------------------------------------------- |
| Все чаты        | все диалоги бота                                                      |
| Непрочитанные   | диалоги с непрочитанными входящими                                    |
| ИИ              | диалоги, которые сейчас ведёт ИИ-оператор                             |
| Оператор        | диалоги, переведённые на ручной режим (оператор перехватил переписку) |
| Заблокированные | подписчики, заблокировавшие бота                                      |

### Готовые фильтры

Над списком идёт полоса быстрых фильтров по воронке: готовые срезы, которые применяются в один клик. Их названия одинаковы во всех языках интерфейса.

* `All`: все чаты.
* `Reg`: есть событие регистрации.
* `FD`: был первый депозит (FTD).
* `RD`: был повторный депозит.
* `Deposits`: сумма депозитов больше нуля.
* `<$5`, `$5-10`, `$10-100`: срезы по сумме депозитов.

Скоро в наборе появится срез `>$100`.

### Сохранённые фильтры

В той же полосе показываются сохранённые фильтры (сегменты) этого бота. Избранные отмечены звёздочкой и идут первыми. Кнопка «Фильтр» в конце ряда открывает конструктор условий, тот же, что применяется к [подписчикам](/ru/subscribers): соберите произвольное условие (по стране, событиям [трекера](/ru/tracker), сумме депозита и так далее) и примените его к списку чатов. Подробнее о сегментах в разделе [Фильтры](/ru/filters).

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

## Открытие диалога

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

Кнопка со значком ⓘ («Информация о подписчике») в шапке диалога открывает панель «Инфо» с карточкой подписчика.

Если подписчик ещё ничего не писал, диалог покажет, что переписка пуста и можно написать первым.

### Панель подписчика

Панель «Инфо» собирает всё, что известно о человеке, и управляющие действия по нему. Разделы:

* **Контакт.** Имя, username, Telegram ID, дата рождения.
* **Источник трафика и атрибуция.** Страна, устройство, `click_id`, start-параметр, UTM и рекламные метки клика.
* **Конверсии.** Первый депозит (FTD) и его дата, сумма депозитов, депозиты и выводы, количество конверсий.
* **Воронка.** Текущий сценарий, шаг сценария и блок [конструктора](/ru/constructor), на котором стоит подписчик.
* **Активность.** Дата подписки, последняя активность, счётчики сообщений (всего, входящих, исходящих).
* **Теги.** Список [тегов](/ru/tags) подписчика: их можно добавлять и снимать прямо отсюда.
* **Расход ИИ.** Сколько токенов и ходов потратил [ИИ-оператор](/ru/ai-operator) на этот диалог.

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

<Note>Оператор с анонимным доступом видит обезличенные данные подписчика. Кнопка «Запросить раскрытие данных» отправляет запрос менеджеру: при одобрении реальные данные открываются на 15 минут.</Note>

## Ответ подписчику

Поле ввода внизу диалога. Enter отправляет сообщение, Shift+Enter переносит строку. Отправленное сообщение появляется в переписке сразу.

Если подписчик заблокировал бота, поле ввода отключается и показывает «Заблокирован». Отправка также недоступна, когда исчерпан баланс компании (пополнение в разделе [Баланс](/ru/billing)).

## Меню сообщения

Правый клик по сообщению (на телефоне долгое нажатие) открывает меню действий над ним. Набор пунктов зависит от сообщения:

* **Ответить.** Над полем ввода появляется плашка с цитатой, она уходит вместе с ответом. То же делает кнопка ответа, которая появляется при наведении на сообщение.
* **Копировать текст.** Копирует текст сообщения в буфер обмена.
* **Показать перевод.** Переводит это сообщение на ваш язык прямо в переписке, повторный выбор возвращает оригинал. Доступно, когда включены ИИ-оператор и перевод.
* **Отправить повторно.** Появляется у неотправленного сообщения и повторяет отправку того же текста и вложения.
* **Удалить.** Убирает ваше сообщение у вас и у подписчика.

## Медиа

Кнопка со скрепкой прикрепляет вложения. Поддерживаются те же типы, что в [конструкторе](/ru/constructor) и [рассылках](/ru/broadcasts), потому что и там, и здесь работает один и тот же загрузчик.

| Тип            | Особенности                              |
| -------------- | ---------------------------------------- |
| Фото           | группируется в альбом                    |
| Видео          | группируется в альбом                    |
| Видеосообщение | уходит отдельным сообщением, без подписи |
| Голосовое      | уходит отдельным сообщением              |
| Аудио          | уходит отдельным сообщением              |
| Альбом         | до 10 фото и видео одной сеткой          |

<Warning>
  Telegram накладывает правила на группировку, и платформа их соблюдает:

  * В один альбом помещается до 10 фото и видео.
  * Голосовое и видеосообщение всегда уходят одним отдельным сообщением и не комбинируются ни с чем.
  * Аудио не кладётся в один альбом с фото и видео, оно уходит своим сообщением.
  * У видеосообщения нет подписи. Если к прикреплённому видеосообщению набран текст, кнопка отправки блокируется.
</Warning>

Длина текста и подписи ограничена Telegram: 4096 символов без вложения и 1024 символа вместе с вложением. У лимита есть счётчик, а при превышении отправка блокируется.

## Переменные в сообщениях

В тексте ручного сообщения и в шаблонах можно использовать [переменные](/ru/variables) в двойных фигурных скобках. Сервер подставляет их значения из данных подписчика в момент отправки. Имена переменных всегда на английском, их не нужно переводить.

* `{{ first_name }}`, `{{ last_name }}`, `{{ full_name }}` имя подписчика
* `{{ username }}` username в Telegram
* `{{ user_id }}`, `{{ telegram_id }}` идентификаторы
* `{{ tag }}` значение из ссылки запуска бота (`t.me/бот?start=...`)
* `{{ created_at }}` дата подписки
* `{{ date_of_birth }}` дата рождения
* `{{ click_id }}` идентификатор клика для атрибуции
* `{{ event.<поле> }}` поля последнего постбека, например `{{ event.trader_id }}` идентификатор аккаунта у партнёра

<Info>Если поле у подписчика не заполнено, переменная подставится пустой строкой, само сообщение отправится.</Info>

## Шаблоны быстрых ответов

Частые ответы удобно сохранять в шаблоны и вставлять готовыми. Вставить шаблон можно двумя способами.

### Через «/» в поле ввода

Начните сообщение с `/`, и под полем откроется автодополнение с подходящими шаблонами. Стрелки вверх и вниз выбирают шаблон, Enter или Tab вставляют его, Esc скрывает список. Шаблоны ранжируются: точное совпадение шортката выше, затем совпадение по началу имени, затем вхождения. При равенстве частые шаблоны идут первыми. В поле подставляется только текст на место ведущего `/шортката`, а набранный после него хвост сообщения сохраняется.

### Через панель шаблонов

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

Шаблон состоит из шортката (например `/dep`), необязательного названия, текста и вложения (фото, видео или альбом). Шаблоны с вложением помечены иконкой скрепки.

* **Переменные.** Токены `{{ ... }}` внутри шаблона работают так же, как в обычном сообщении, и подставляются при отправке. В автодополнении активный шаблон показывает превью с уже подставленными значениями, если в тексте есть переменные.
* **Папки.** Шаблоны раскладываются по папкам. Удаление папки не трогает сами шаблоны, они просто остаются без папки.
* **Порядок.** Недавно и часто использованные шаблоны поднимаются вверх списка.
* **Доступ.** Создавать и редактировать шаблоны могут операторы. Роль «Контролёр» видит их только для вставки.

## Ручной ответ и ИИ-оператор

Когда подписчик находится на блоке ИИ-диалога, в шапке переписки виден статус ИИ-оператора.

* **ИИ-оператор отвечает автоматически.** Диалог ведёт ИИ.
* **Вы ведёте диалог, ИИ на паузе.** Как только вы отправляете сообщение вручную, переписка переходит под вас, и ИИ перестаёт отвечать.

Чтобы вернуть переписку ИИ, нажмите значок статуса в шапке и выберите «Вернуть под ИИ». ИИ ответит на следующее сообщение подписчика. Сам, без входящего сообщения, он писать не станет.

Рядом есть кнопка «Перевести в блок» (значок с двумя стрелками). Она переводит подписчика на любой активный блок бота: обычный блок отправит свой контент, блок ИИ-диалога передаст переписку ИИ. Перевод снимает ручной перехват. Логика блоков настраивается в [конструкторе](/ru/constructor).

## Перевод сообщений

Если для бота включён ИИ-оператор и в его настройках разрешён перевод, в диалоге появляются инструменты перевода. Функция общая для всей компании и настраивается в [настройках ИИ-оператора](/ru/ai-operator).

* **Вся переписка.** Кнопка перевода (значок с буквами) в шапке диалога переводит все сообщения на ваш язык. Повторный выбор возвращает оригиналы.
* **Отдельное сообщение.** В [меню сообщения](#меню-сообщения) пункт «Показать перевод» переводит только его.
* **Исходящее перед отправкой.** Набрав ответ, можно перевести его на язык подписчика и уже потом отправить.
* **Автоперевод исходящих.** Переключатель в меню перевода: каждое ваше сообщение автоматически переводится на язык подписчика при отправке.

Переведённые сообщения помечаются, и оригинал всегда можно вернуть.

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

Кроме сообщений, в ленте появляются системные события подписчика в виде компактных плашек. Они помогают понять контекст, не выходя из диалога:

* **Регистрация**, **Депозит**, **Повторный депозит**, **Вывод**, **RevShare**, **Подтверждение email** это события [трекера](/ru/tracker).
* **Запрос на вступление**, **Заявка одобрена**, **Вернулся в бота**, **Отписался**, **Реакция**, **Изменён статус** это события самого Telegram.

Системные события не меняют превью чата, не поднимают его наверх списка и не влияют на счётчик непрочитанных.

## Статусы доставки

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

| Причина                                | Что значит                                                                                     |
| -------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Подписчик заблокировал бота            | бот больше не может ему писать                                                                 |
| Подписчик ещё не отвечал боту          | зашёл по инвайту, но окно для первого сообщения закрылось; писать снова можно после его ответа |
| Медиафайл недоступен                   | вложение было удалено, загрузите его заново и отправьте                                        |
| Сообщение слишком длинное для Telegram | сократите текст                                                                                |
| Ошибка разметки                        | проверьте форматирование                                                                       |
| Бот недоступен в Telegram              | проблема с самим ботом                                                                         |
| Лимит Telegram                         | временное ограничение частоты, повторите отправку                                              |

Неотправленный пузырь остаётся в переписке, при этом он не становится последним сообщением диалога и не сбивает счётчик непрочитанных. В [меню сообщения](#меню-сообщения) «Отправить повторно» переотправит тот же текст и вложение, «Удалить» уберёт пузырь.

## Рассылки в диалоге

Сообщения массовых [рассылок](/ru/broadcasts) тоже видны в переписке, с пометкой «Рассылка». Из диалога их нельзя удалить или отредактировать, потому что это контент рассылки, отправленный автоматически. Ручные сообщения оператора удалять можно. Рассылки не считаются последним сообщением диалога и не влияют на счётчик непрочитанных.

## Удаление своего сообщения

Оператор может отозвать своё исходящее сообщение через [меню сообщения](#меню-сообщения), пункт «Удалить». Сообщение убирается и у вас, и у подписчика.

<Warning>Telegram разрешает удалить сообщение у подписчика в течение 48 часов после отправки. Позже пузырь пропадёт у вас, но останется у подписчика.</Warning>

Своё сообщение удаляет его автор. Сообщение коллеги или ИИ может удалить участник с ролью менеджера и выше. Сообщения рассылок отозвать нельзя.

## Что дальше

<Columns cols={2}>
  <Card title="ИИ-оператор" icon="robot" href="/ru/ai-operator">
    Как настроить автоматические ответы и когда переписку подхватывает человек.
  </Card>

  <Card title="Рассылки" icon="bullhorn" href="/ru/broadcasts">
    Массовые и триггерные сообщения по сегментам подписчиков.
  </Card>

  <Card title="Конструктор" icon="diagram-project" href="/ru/constructor">
    Блоки и логика воронки, которая ведёт подписчика до оператора.
  </Card>

  <Card title="Трекер" icon="chart-line" href="/ru/tracker">
    Источники трафика, события и сегменты, по которым фильтруется список чатов.
  </Card>
</Columns>