Боты и Smart Apps

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

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

Где найти новых ботов?

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

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

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

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

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

Зачем нужны Smart Apps?

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

Как защищены Smart Apps на стороне пользователей?

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

Не могу найти Smart Apps в приложении для Aurora. Почему?

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

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

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

Кому доступны Smart Apps?

Платформа eXpress поддерживает создание собственных ботов и Smart Apps.

Обычные пользователи могут добавлять ботов и Smart Apps на сервер?

Кто может создавать ботов и 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 для дальнейшего анализа.

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