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

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

По умолчанию заявки приходят в основную ленту рабочей 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=Заявки РФ

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

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

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

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