# Внешнее событие

> [HTML Version](external-event.html)

Триггер запускает сценарий бота, когда происходит определённое внешнее событие, инициированное через API. Это событие можно вызвать в ходе сценария ELMA365, например, в рамках бизнес‑процесса или по нажатию кнопки, а также из внешней системы. Так, сценарий с триггером можно использовать, чтобы:

- запросить у клиента обратную связь по работе оператора после завершения сессии в [Линиях](https://elma365.com/ru/help/service/chat_lines.html);

- отправить пользователю уведомление по предстоящему мероприятию, сразу запросить информацию и ответить на вопросы;

- попросить клиента заполнить опрос по качеству заказа после его выполнения.

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

**(external-event-1.png)**

О том, как составить запрос API, читайте в документации разработчика ELMA Bot в статье [«Запустить внешнее событие»](https://dev-docs.elma-bot.ai/latest/externalEventTrigger/api/dispatchExternalEvent/). Получение всех триггеров внешнего события бота описано в статье [«Информация о доступных триггерах внешнего события»](https://dev-docs.elma-bot.ai/latest/externalEventTrigger/api/botExternalEventTriggers/).

Рассмотрим подробнее добавление триггера в сценарий бота.

## Настройки триггера

Разместите триггер **Внешнее событие** в начале сценария. Чтобы перейти к настройкам, наведите курсор на триггер, затем на появившиеся рядом с названием три точки и нажмите значок **(bot-gear-icon.png)**. Заполните поля:

**(external-event-2.png)**

- **Идентификатор** — задайте для внешнего события имя, уникальное в рамках данного бота. Оно используется при вызове события через Web API, например, из скриптов ELMA365. Рекомендуем использовать имя, которое отражает смысл запускаемого действия;

- **Имя** — укажите название триггера, которое будет отображаться на схеме сценария бота;

- **Переменные** — укажите или создайте переменные, в которые будут записываться данные из запроса. Переменные позволяют конструировать универсальные сценарии. Например, один и тот же сценарий можно использовать в разных рассылках, передавая в одни и те же переменные разный текст сообщений и ссылки на документы. Подробнее о работе с переменными читайте в статье [«Настройка переменных бота»](bot-variable-settings.md).

После завершения настройки сохраните изменения.

Вы можете скопировать идентификатор события на странице сценария бота. Для этого нажмите **(bot-chain-icon.png).**

**(external-event-3.png)**

Теперь событие можно [запускать](https://dev-docs.elma-bot.ai/latest/externalEventTrigger/api/dispatchExternalEvent/) с помощью метода API, чтобы бот выполнял настроенные действия. Например, вы можете вызвать сценарий бота на определённом этапе бизнес-процесса в блоке [Скрипт](360027203731.md). 

Обратите внимание, сообщения отправляются только в открытые сессии в разделе **Линии**. Если открытой сессии с клиентом нет, создайте её в сценарии перед запуском события. Для TelegramBot и ViberBot нельзя создать сессию для клиента, с которым раньше не велась переписка.

Чтобы удалить триггер из сценария бота, наведите на него курсор, рядом с его названием нажмите на три точки и выберите значок **(bot-close-icon.png)**.