November 22, 2019

Инструкция. Как работать с Ботом-поисковиком @metturika_bot

Этот бот @metturika_bot уведомляет о новых постах в Телеграм каналах, содержащих заданные фразы, упоминания каналов и репосты из каналов. Бот поддерживает отправку уведомлений в личные сообщения, группы или каналы.

Для начала пользования ботом достаточно создать дайджест и добавить в него поисковую фразу.

Дайджест — группа поисковых фраз с общим набором фильтров и общим чатом доставки.

Канал доставки — пользователь, группа или канал, в который бот присылает уведомления.

Это экран приветствия бота @metturika_bot. Тут содержится общее описание возможностей бота. Для запуска бота присутствует кнопка start.

Основной экран бота содержит общее описание возможностей бота, содержит список доступных команд, версию бота и ссылку на группу технической поддержки пользователей бота. Экран вызывается командами /help или /start.

Команда /newdigest позволяет создать дайджест с уведомлениями о новых постах в Телеграм каналах. Для примера создадим новый дайджест с названием "Телеграм".

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

1. Меню работы с поисковыми фразами;

2. Меню работы с упоминаниями и репостами каналов;

3. Меню работы с фильтрами каналов;

4. Меню работы с watchlist и blacklist;

5. Меню настройки чата доставки уведомлений;

6. Меню удаления дайджеста;

Меню дайджеста содержит следующие кнопки:

1. Подменю добавления новой поисковой фразы;

2. Кнопки подменю работы с каждой поисковой фразой в виде списка. На скриншоте эти кнопки не показаны, так как в нашем примере ещё не добавлены поисковые фразы.

В меню добавления новой фразы доступны два метода поиска:

Regular match ищет совпадения различных словоформ, основываясь на языке (падежи, числа и т.д.);

Exact match ищет только строгое соответствие введённой фразы.

При выборе любого из поисковых режимов, regular match или exact match, бот предлагает выбрать язык сообщений. В текущей версии доступны языковые фильтры:

🇷🇺 — русский
🇬🇧 — английский
🌐 — без фильтра

После выбора языка бот предлагает отправить в чат поисковую фразу. На экране содержится справочная информация с примерами синтаксиса запросов:

1. Слово и словоформы;

2. Однокоренные слова (тильда);

3. Словосочетание / фраза;

4. Text fuzziness - максимальное расстояние между словами во фразе (кавычки, тильда, числовое значение).

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

Меню инструмента отслеживания упоминаний и репостов канала содержит справочную информацию и кнопки:

1. Подменю добавления нового отслеживания;

  1. Кнопки подменю работы с каждым отслеживанием в виде списка. На скриншоте они не показаны, так как в нашем примере ещё не добавлены отслеживаемые каналы.

При добавлении нового отслеживания бот предлагает отправить в чат username канала, который необходимо отслеживать. В подсказке с примерами указано, что username может быть отправлен в видах:

@username
t.me/username

После отправки юзернейма канала в чат, бот возвращает сообщение со статистической информацией и примерами совпадений. Далее можно подтвердить или отменить действие.

Фильтры каналов применяются ко всем уведомлениям, отправляемым в рамках дайджеста. В текущей версии бота доступны следующие фильтры каналов:

1. Member count - количество подписчиков канала;

2. Daily reach - средний показатель просмотров канала за день;

3. Message reach - средний показатель просмотров на одну публикацию канала;

4. ERR - Engagement rate. 100% * message reach / member count.

Для включения фильтра бот просит отправить в чат минимальный порог значения для выбраного фильтра.

После отправки значения появляется кнопка для отключения фильтра.

Меню работы с watchlist и blacklist состоят из кнопок перехода в канал и кнопок удаления канала из списка, расположенных в один ряд.

Сообщения из каналов добавленных в watchlist приходят в канал доставки со звуковым уведомлением.

Сообщения из каналов добавленых в blacklist исключаются из выдачи дайджеста.

Добавление каналов в watch list и black list в текущей версии бота реализовано в виде кнопок, прикреплённых к сообщениям, присылаемым в рамках дайджеста.

Команда /chatid возвращает ID текущего пользователя, канала или группы.

Бот поддерживает следующие каналы доставки уведомлений:

- Прямые сообщения пользователю;
- Группы, включая супергруппы;
- Каналы (бот должен быть администратором канала).

Последовательность действий для изменения канала доставки уведомлений:

  1. Добавить бота в группу или канал;
    2. Назначить бота администратором группы или канала;
    3. Отправить команду /chatid в новом канале доставки (группа или канал);
    4. Скопировать или переслать в @metturika_bot полученное сообщение, содержащее ID нового канала доставки.

Достаточные настройки прав бот�� для групп.

Достаточные настройки прав бота для каналов.