Создание события
Опишите событие приложения, передаваемые данные и доступные способы реакции.
Откройте раздел «События» приложения.
Как добавить событие
Событие сообщает Senler о том, что произошло в вашем приложении: например заказ оплачен или сделка закрыта. На него может отреагировать агент, а событие плагина может также начать автоматизацию. Пользователь проекта сам подключает нужную реакцию; создание события в приложении ещё не запускает обработку.
Объявление событий доступно приложениям типов «Интеграция на сайте» и «Плагин».
1. Откройте форму
Откройте раздел «События» и нажмите «Добавить», чтобы открыть страницу нового события.
2. Назовите событие для пользователя
В блоке для пользователя заполните название и краткое описание на вкладке «Русский», затем английское название и описание на вкладке English. Пользователь увидит вариант на языке своего интерфейса.
3. Задайте системное имя
Укажите системное имя, которое приложение будет отправлять через API, например payment.paid.
В блоке «Где доступно событие» выберите хотя бы один вариант:
- «Реакция агента» — пользователь сможет добавить событие своему агенту;
- «Начало автоматизации» — для плагина событие появится среди источников запуска автоматизаций «Для диалогов».
Можно включить оба варианта. Отдельное описание для агента показывается только при включённой реакции агента.
Если агенту нужно иначе сформулировать полученный факт, включите отдельное техническое описание и заполните текст для агента.
4. Опишите передаваемые данные
Если вместе с событием передаются данные, в блоке «Данные события» нажмите «Добавить поле».
В каждой карточке поля задайте имя, выберите в поле типа подходящий вариант. На вкладках «Русский» и English заполните русское и английское описание, затем при необходимости включите обязательность. Удаление убирает ненужное поле. Если дополнительных данных нет, оставьте этот блок пустым.
5. Сохраните событие
Нажмите «Сохранить». «Отмена» возвращает к списку без изменений.
Изменение и удаление
На странице «События» можно нажать «Добавить» для нового события или выбрать существующее в списке. Через действие редактирования можно изменить названия, описание и схему данных. После изменения схемы убедитесь, что приложение отправляет данные в новом формате.
Если событие больше не используется, выберите удаление. Откроется подтверждение: проверьте событие и подтвердите действие удаления. Событие сразу исчезнет из подписок всех агентов, а новые вызовы с этим системным именем будут отклоняться. Оно также перестанет быть доступным для автоматизаций. Проверьте схемы, которые использовали это событие, и замените источник запуска.
