Команды/Действия

Действие — это событие инициализированное пользователем, например: отправка команды, клик по кнопке (callback), отправка сообщения и т.д.

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

Некоторые действия требуют дополнительной обработки и настройки.

Обычные текстовые сообщения

Проблема обычных сообщений в том что сложно определить является оно “командой” или это просто диалог. Пара примеров:

1. Отправка в чат слова “Помощь” во многих ботах это слово может быть аналогично команде “/help” и запускает какой-то скрипт помощи пользователю. В этом случае слово “Помощь” мы должны расценивать как команду и собирать по ней статистику.

2. Допустим, ваш бот создан для поддержки пользователей и они просто пишут о своих проблемах “проблема по адресу улица Мира” в этом случае сообщение не должно обрабатываться как команда.

На тарифе "Продвинутый" сохраняются все сообщения пользователя, а не только команды.

Чтобы решить эту проблему, мы сделали простой алгоритм. Если одно и то же сообщение повторяется несколько раз, то оно преобразуется в “команду” и начинает отображаться в отчетах. Такие команды мы называем “скрытыми командами”.

Отключение скрытых команд

Для некоторых ботов эта функция может оказаться лишней или даже вредной. Например, если у вас большое кол-во пользователей и они много пишут в ваш бот. Это могут быть боты для общения пользователей или предоставляющий услуги нейросетей.

В этих случаях таких команд может быть создано слишком много что помешает адекватному анализу данных. Если для вашего бота не нужно учитывать такие команды, вы можете отключить это на странице настроек бота.

Если вы хотите дополнительно настроить эти команды, напишите нам, мы собираем информацию, чтобы выработать универсальное, настраиваемое решение.

Настройка скрытых команд

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

Вы увидите список всех команд вашего бота. У каждой команды есть статус

Вкл - активные команды, по таким командам будут создаваться событие

Выкл - отключенные команды, по таким командам события создаваться не будут

В процессе - это обнаруженные команды, но еще не созданные. При достаточном кол-ве повторений такая команда преобразуется в активную.

Добавление свои команд

Вы можете не дожидаться автоматического создания команд и добавить их в ручную или активировать их если такая команда "в процессе"

CALLBACK_QUERY

В телеграм существуют разные типы кнопок и один из типов это CALLBACK_QUERY. При нажатии пользователем на такую кнопку отправляется запрос вашему боту с какой-то информацией.

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

Но есть одна небольшая особенность, у нас есть ограничение на кол-во символов. Если длина команды (текста на кнопке) превышает определенное кол-во символов оно не регистрируется как отдельная команда. Этот параметр вы можете изменять для конкретного бота в настройках, по умолчанию это значение = 60 символам