Возможные Триггеры И Действия

Этот документ фиксирует возможный продуктовый список триггеров и действий для редактора сценариев.

В этом варианте отдельные операции с сообщениями остаются разными узлами:

• Удалить сообщение
• Закрепить сообщение
• Открепить сообщение
• Переслать сообщение
• Редактировать сообщение

Принцип разделения

Триггер отвечает на вопрос:

• когда начинается сценарий

Действие отвечает на вопрос:

• что бот или система делает дальше

Условие отвечает на вопрос:

• по какой ветке идти после старта или после действия

Возможные Триггеры

Базовые триггеры

• Команда
• Текстовый триггер
• Любое сообщение
• Неизвестное сообщение
• Webhook
• По расписанию
• По таймеру

Триггеры по типу входящего контента

• Любой текст
• Фото
• Видео
• Аудио
• Документ
• Стикер
• Голосовое сообщение
• Анимация / GIF
• Геолокация
• Контакт

Триггеры по пользовательскому действию

• Нажатие inline-кнопки
• Нажатие reply-кнопки
• Выбор варианта
• Повторный вход пользователя

Триггеры по событиям чата

• Пользователь вошёл в чат
• Пользователь вышел из чата
• Бот добавлен в группу
• Бот удалён из группы
• Изменилось название чата
• Изменилась аватарка чата
• Закреплено сообщение

Возможные Действия

Отправка и отображение сообщений

• Текстовое сообщение
• Фото
• Видео
• Аудио
• Документ
• Стикер
• Голосовое сообщение
• GIF анимация
• Геолокация
• Контакт
• Медиафайл

Действия с уже существующими сообщениями

• Переслать сообщение
• Скопировать сообщение
• Редактировать отправленное сообщение
• Удалить сообщение
• Закрепить сообщение
• Открепить сообщение

Действия с клавиатурой и интерфейсом

• Клавиатура
• Показать inline-кнопки
• Показать reply-кнопки
• Убрать клавиатуру
• Обновить кнопки сообщения

Действия с данными пользователя

• Сохранить ответ
• Записать переменную
• Изменить переменную
• Очистить переменную
• Увеличить счётчик
• Уменьшить счётчик
• Сохранить в базу
• Обновить профиль пользователя

Действия навигации

• Перейти к узлу
• Автопереход
• Переход после ввода
• Запустить другой сценарий
• Вернуться назад
• Остановить сценарий
• Завершить сценарий

Логика и ветвление

• Условие
• Switch / выбор ветки
• Проверка переменной
• Проверка текста
• Проверка типа контента
• Fallback / если не найдено совпадение

Интеграции

• HTTP запрос
• Вызвать Webhook
• Записать в Google Sheets
• Прочитать из Google Sheets
• Отправить админу
• Логировать событие

Группы и модерация

• Заблокировать пользователя
• Разблокировать пользователя
• Ограничить пользователя
• Снять ограничения
• Исключить пользователя
• Назначить администратором
• Снять администратора
• Права администратора

Возможности Для Чат-Парсера

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

Подходящие триггеры для чат-парсера

• Любое сообщение
• Неизвестное сообщение
• Любой текст
• Фото
• Видео
• Документ
• Голосовое сообщение
• Медиа с подписью
• Сообщение из группы
• Сообщение из приватного чата
• Пересланное сообщение
• Ответ на сообщение
• Изменённое сообщение
• Webhook
• По расписанию

Действия для извлечения и разбора данных

• Извлечь сущности из текста
• Извлечь ссылки
• Извлечь email
• Извлечь телефон
• Извлечь username / mention
• Извлечь хэштеги
• Извлечь дату и время
• Извлечь сумму / цену
• Извлечь адрес
• Извлечь артикул / номер заказа
• Извлечь код / номер / идентификатор
• Распознать язык сообщения
• Определить тип сообщения
• Классифицировать намерение
• Определить тональность
• Выделить ключевые слова

Действия для нормализации и подготовки текста

• Очистить текст
• Нормализовать текст
• Убрать лишние пробелы и переносы
• Привести регистр
• Удалить служебные символы
• Транслитерировать
• Разбить текст на части
• Склеить части сообщения
• Обрезать текст до лимита
• Преобразовать Markdown / HTML в plain text

Действия для работы с медиа и вложениями

• Извлечь подпись к медиа
• Считать метаданные файла
• Определить MIME-тип
• Получить file_id / ссылку на файл
• Распознать текст из изображения (OCR)
• Распознать текст из документа
• Транскрибировать голосовое сообщение
• Извлечь кадр / превью

Действия для сопоставления и валидации

• Проверить по regex
• Сопоставить по шаблону
• Проверить формат поля
• Проверить обязательные поля
• Проверить уникальность
• Найти дубликат
• Сопоставить с существующей записью
• Обогатить данными из справочника
• Валидировать извлечённые данные

Действия для сохранения и маршрутизации результата

• Сохранить результат парсинга
• Записать структуру в переменную
• Записать JSON
• Записать в базу
• Записать в Google Sheets
• Отправить в Webhook
• Передать в CRM
• Создать лид / заявку
• Отправить админу результат парсинга
• Маршрутизировать по типу результата
• Маршрутизировать по успешности парсинга
• Отправить в ручную обработку

Служебные действия для парсера

• Пометить сообщение как обработанное
• Пометить сообщение как ошибочное
• Пропустить сообщение
• Поставить в очередь
• Повторить обработку
• Логировать шаг парсинга
• Сохранить сырой входящий payload
• Сохранить ошибку парсинга
• Собрать статистику по сообщениям

Рекомендуемый MVP набор для чат-парсера

• Любое сообщение
• Любой текст
• Документ
• Голосовое сообщение
• Извлечь сущности из текста
• Проверить по regex
• Классифицировать намерение
• Транскрибировать голосовое сообщение
• Распознать текст из изображения (OCR)
• Сохранить результат парсинга
• Записать в базу
• Отправить в Webhook
• Маршрутизировать по успешности парсинга
• Отправить в ручную обработку
• Логировать шаг парсинга

Рекомендуемый MVP Набор

Триггеры

• Команда
• Текстовый триггер
• Любое сообщение
• Нажатие inline-кнопки
• Webhook
• По расписанию

Действия

• Текстовое сообщение
• Фото
• Клавиатура
• Сохранить ответ
• Условие
• Перейти к узлу
• Переслать сообщение
• Редактировать отправленное сообщение
• Удалить сообщение
• Закрепить сообщение
• Открепить сообщение
• HTTP запрос

Рекомендуемый Extended Набор

Триггеры

• Неизвестное сообщение
• Фото
• Видео
• Документ
• Голосовое сообщение
• Пользователь вошёл в чат
• Пользователь вышел из чата
• По таймеру

Действия

• Скопировать сообщение
• Видео
• Аудио
• Документ
• Стикер
• Голосовое сообщение
• GIF анимация
• Геолокация
• Контакт
• Записать в Google Sheets
• Обновить профиль пользователя
• Заблокировать пользователя
• Разблокировать пользователя
• Ограничить пользователя
• Снять ограничения

Замечание По Архитектуре

Даже если действия остаются разными узлами, их полезно группировать в UI по категориям:

• Триггеры
• Сообщения
• Клавиатуры
• Логика
• Данные
• Интеграции
• Модерация

Такой подход сохраняет наглядность сценариев на холсте и не усложняет сайдбар.