Боты и SmartApps

Обзор

Функция	Описание	Возможности
Бот	Lite CTS eCTS Бот — это специальный контакт, за которым скрывается веб-приложение. Взаимодействует с пользователем через чат. Чат-боты обладают функциональностью, знакомой многим из других мессенджеров. Пользователям eXpress Lite можно использовать только встроенные служебные боты.	отправка текстовых сообщений, файлов; отправка сообщений с кнопками; получение системных событий (создание чата, вход пользователя в чат и т.д.); включение/отключение режима повышенной конфиденциальности; назначение администраторов чата; создание чата с пользователем (полезно для корпоративных чат-ботов) и т.д. обмен данными со сторонними корпоративными системами или приложениями.
SmartApp	CTS eCTS SmartApps — это веб-приложения с полноценным пользовательским интерфейсом для различных бизнес-процессов: почта, календарь, кадровые сервисы, электронный документооборот, порталы, поддержка и другие. Они встраиваются прямо в приложение eXpress или ETS -приложение.	SmartApps позволяют быстро решать рабочие задачи даже на смартфоне или планшете, экономя время и повышая продуктивность сотрудников. В результате организация получает единую платформу, объединяющую и мобильные, и десктопные устройства пользователей, для большинства корпоративных задач.

Кто может управлять ботами и SmartApps?

Управлять ботами и SmartApps или подключать внутренние боты в глобальный чат может администратор корпоративного сервера /.

Кому доступны SmartApps?

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

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

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

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

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

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

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

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

Стандартные SmartApps

Если ваша организация приобрела лицензию с поддержкой SmartApps, вам доступны SmartApps «Почта», «Календарь» и «Главная страница» и некоторые другие.

---

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

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

Ссылка	Описание
Коллекция ботов и SmartApps от команды eXpress	Для каждого бота и SmartApp в каталоге предусмотрен файл .env с переменными, содержащий подробное описание всех конфигурационных параметров.
Бот для переноса чатов из Telegram	Дистрибутив с описанием и инструкция для пользователей бота.
Руководство по развёртыванию бота и SmartApps для администратора	Инструкция PDF по установке ботов и SmartApps для корпоративных администраторов.

Как установить бота или SmartApp?

Если вы корпоративный пользователь (и ваша организация обладает расширенной лицензией с поддержкой SmartApps), обратитесь в поддержку своей организации, чтобы заказать установку.

Можно ли изучить код готовых ботов и SmartApps?

Мы не предоставляем исходный код.

Платформа eXpress поддерживает создание собственных ботов и SmartApps. Создать бота или SmartApp можно самостоятельно, используя API BotX, либо заказать у поставщика eXpress.

Создание ботов и SmartApps

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

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

Кто может создавать ботов и SmartApps?

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

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

Есть конструктор ботов или аналог Bot Father из Telegram?

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

API BotX

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

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

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

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

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

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

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

• ExpressApp

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

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

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

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

Проблема с ботом возникает на нескольких клиентских платформах?

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

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

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

Администратору: сбор данных для диагностики чат-бота

CTS

eCTS

Для диагностики можно получить с корпоративного сервера:

• логи контейнера с ботом,
• логи контейнера botx,
• логи контейнера messaging.

Передайте в поддержку eXpress:

• описание проблемы, скриншоты, видео,
• файл .env со значениями переменных,
• собранные логи.

Проблема с ботом возникает на одной клиентской платформе?

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

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

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

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

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

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