Боты и Smart Apps

Чат-бот — это специальный контакт, за которым скрывается веб-приложение. Веб-приложение взаимодействует с пользователем через чат. Чат-боты обладают функциональностью, знакомой многим из других мессенджеров:

• отправка текстовых сообщений, файлов;
• отправка сообщений с кнопками;
• получение системных событий (создание чата, вход пользователя в чат и т. д.);
• включение/отключение режима повышенной конфиденциальности;
• назначение администраторов чата;
• создание чата с пользователем (полезно для корпоративных чат-ботов) и т. д.
• обмен данными со сторонними корпоративными системами или приложениями.

Подключить чат-бота может администратор корпоративного сервера в панели администратора. Создать бота может любой желающий, используя API, либо ботов можно заказать у поставщика eXpress.

❓ Связанные вопросы:
• Что делать, если чат-бот не работает или работает неправильно
• В чате, созданном ботом, отправляемые сообщения зависают с ошибкой

Внутренние боты

В eXpress есть внутренние боты (включить или подключить их в глобальный чат может администратор сервера). Некоторые из них:

• Conference Notifier bot. Оповещает пользователей о предстоящих конференциях. С его помощью также можно настроить регулярные напоминания о бессрочных конференциях.
• Notifications bot. Бот для отправки сообщений в глобальный чат.
• Recordings bot. Бот для уведомлений о готовых записях звонков.

Smart Apps — это полноценные веб-приложения для различных бизнес-процессов: почта, календарь, кадровые сервисы, электронный документооборот, порталы, поддержка и другие. Их можно встроить прямо в приложение eXpress.

⚠️ Приложение для Aurora временно не поддерживает Smart Apps.

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

Все Smart Apps работают внутри зашифрованного контейнера клиентского приложения, что гарантирует защиту корпоративной информации от третьих лиц.

Доступен каталог готовых к развёртыванию ботов и Smart Apps:

• Коллекция ботов и Smart Apps от команды eXpress
  Для каждого бота и Smart App в каталоге предусмотрен файл .env с переменными, содержащий подробное описание всех конфигурационных параметров.
• Руководство по развёртыванию бота и Smart App для администратора (PDF)

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

Боты и Smart Apps могут быть созданы:

• Командой разработки eXpress. Заявки на внедрение и доработку таких ботов и Smart Apps делаются через аккаунт-менеджера со стороны eXpress или коммерческий отдел.
• Заказчиком самостоятельно с использованием API BotX. Описание API доступно по ссылкам ниже.
• Партнёрами заказчика. Заявки на доработку таких ботов делаются через поддержку организации-партнёра.

API BotX

О ботах в базе знаний eXpress:

• Общая информация о ботах
• Разработчику ботов

Документация по API BotX:

• Приветственная страница документации BotX
• Общее описание BotX
• HTTP(s) Bot API v4 — протокол отправки данных от BotX к боту (BotX → Bot). Версия протокола задаётся на странице редактирования бота в панели администратора, в поле Версия протокола.
• HTTP(s) BotX API — API сервиса BotX. Позволяет боту взаимодействовать с внутренними сервисами eXpress.

Документация по Smart Apps:

• О Smart Apps в базе знаний — разработчику

Репозиторий GitHub с библиотеками и примерами:

• ExpressApp

Используйте актуальный Android System WebView

Для корректной работы Smart Apps в мобильном приложении для Android компонент операционной системы Android System WebView должен иметь актуальную версию. Очистите кэш приложения после обновления Android System WebView.

Что делать, если чат-бот не работает или работает неправильно

1. Определите, на какой платформе возникает проблема: веб/десктоп или мобильное приложение, и уточните версию приложения.
2. Проверьте, воспроизводится ли проблема на другой клиентской платформе.
3. Зафиксируйте шаги воспроизведения, сделайте скриншоты или запишите видео.

Если проблема возникает на двух и более платформах (например, iOS и Android), возможные причины:

• бот использует устаревшие методы и требует обновления,
• бот содержит ошибку в коде.

Обратитесь в поддержку своей организации для диагностики и сбора данных или напрямую в поддержку eXpress, предоставив собранную информацию.

Если проблема возникает только на одной платформе (веб/десктоп/iOS/Android), передайте в поддержку eXpress:

• описание проблемы,
• логи клиентского приложения.

При необходимости проблема будет заведена как баг и исправлена в будущем.

Что делать, если Smart App не работает или работает неправильно

1. Попробуйте очистить кэш Smart App через кнопку-троеточие на экране или на панели самого Smart App.
2. Если проблема не решена, определите, на какой платформе она возникает (веб/десктоп/мобильное приложение), и уточните версию приложения.
3. Проверьте, воспроизводится ли проблема на другой платформе.
4. Зафиксируйте шаги воспроизведения, сделайте скриншоты или видео.
5. Соберите клиентские логи Smart App.
6. Через администратора корпоративного сервера запросите:
   • логи Smart App с сервера,
   • файл .env со значениями переменных.
7. Отправьте все данные в поддержку eXpress для дальнейшего анализа.

При необходимости проблема будет заведена как баг и исправлена в будущем.