Перейти к основному содержимому

Развести потоки заявок по топикам

По умолчанию заявки приходят в основную ленту рабочей Telegram-группы проекта.

Если нужно развести потоки — например, российские и международные заявки с одного сайта — можно отправлять их в разные темы той же группы. Есть два способа: разметить формы на сайте или описать правила в боте по содержанию заявки.

Что нужно в Telegram​

  1. В рабочей группе проекта включите Темы (Topics). Как включить Темы в телеграм группе
  2. У @kvalliBot должны быть права администратора с возможностью управлять темами (Manage Topics) — иначе бот не сможет создать новую тему.
Как выглядит необходимое разрешение Управлять темами (Manage Topics)

По параметру на сайте​

В URL скрипта (или webhook) добавьте параметр sendToTopic — название темы:

<script
  src="https://api.kvbot.ru/script/v1/?p=ВАШ_КОД_ПРОЕКТА&sendToTopic=Заявки РФ"
  type="text/javascript"
  defer=""
></script>

Бот сам создаст топик с таким названием и будет направлять заявки туда. Можно латиницу, кириллицу, цифры, пробел, _ и -, до 128 символов.

Поведение​

  • При первой заявке с таким sendToTopic бот создаст тему с этим названием в группе и запомнит её.
  • Дальше все заявки с тем же параметром пойдут в эту тему, если не сработала настройка по содержанию.
  • Без параметра, без настройки и с недопустимым значением заявка уйдёт в основную ленту группы.

Webhook (Tilda, Motor и др.)​

Если заявки идут через webhook, добавьте тот же параметр к URL вебхука:

https://api.kvbot.ru/tilda_webhook/?p=ВАШ_КОД_ПРОЕКТА&sendToTopic=Заявки РФ

По правилам из бота​

В боте, в карточке проекта (Меню → Мои проекты → Правила заявок по топикам), опишите своими словами, какие заявки в какую тему должны идти.

Например:

  • «российские номера — в топик РФ, остальные — в международные»;
  • «казахские — в КЗ, российские — в РФ, остальные — в INT»;
  • «заявки с utm_source=yandex — в Яндекс, остальные — как обычно».

Бот сам разберёт описание и покажет, как понял правило: по какому признаку срабатывает каждая ветка и с примерами. Если понял не так — напишите поправку в том же разговоре, заново всё описывать не нужно.

Проверка идёт по содержанию заявки целиком (имя, телефон, комментарий, метки и т.п.) — не нужно угадывать точное имя поля на сайте. Работает и для скрипта на сайте, и для webhook’ов.

Как это стыкуется с сайтом​

Параметр sendToTopic на сайте и правила в боте работают вместе:

  • если сработало правило из бота — оно важнее;
  • если ни одно правило не подошло и вы не сказали «остальные сюда» — заявка пойдёт как раньше: по sendToTopic или в основную ленту;
  • если явно указали «остальные — в топик INT» — несовпавшие заявки уйдут туда, а не по sendToTopic.

Важное уточнение по работе топиков​

Обратите внимание на топики на скриншоте ниже:

Как устроены вкладки All, General и пользовательские топики
  • All - Здесь телега собирает сообщения из всех топиков. Это не топик, эту вкладку нельзя переименовать или удалить. На ПК этой вкладки нет, чтобы увидеть заявки со всех групп надо нажать на название группы над списком топиков.
  • #General - Это главный топик, сюда бот шлет заявку если не указан параметр sendToTopic и не сработало правило из бота. В этом же топике лежат все заявки которые у вас были до включения тем. Его можно переименовать но нельзя удалить.
  • Международные и РФ - Сюда попадают заявки по sendToTopic или по правилам из бота. Эти топики можно переименовать и удалить. При переименовании бот будет слать заявки в этот же топик по старому ключу, на сайте ничего обновлять не нужно.
важно

При удалении топика удалятся все его заявки, из All они тоже пропадут. Для последующих заявок с таким же названием темы бот создаст новый топик.