Боты и Smart Apps

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

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

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

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

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

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

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

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

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

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

❓Связанные вопросы:
• Используйте актуальный Android System WebView
• Что делать, если Smart App не работает или работает неправильно

Есть набор готовых к развёртыванию ботов и SmartApp:

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

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

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

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

Документация по ботам и Smart Apps для разработчиков

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

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

Документация 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.

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

Сначала выясните, где повторяется проблема с ботом: веб/десктоп или мобильное приложение, и узнайте номер версии приложения.

Проверьте, не повторяется ли проблема на другой клиентской платформе. Запишите шаги для воспроизведения проблемы, сделайте скриншоты и видео.

Если проблема повторяется минимум на двух разных клиентских платформах (например, iOS и Android), это значит, что либо при написании бота использованы устаревшие методы, и его необходимо обновить, либо бот работает с ошибкой. Обратитесь в поддержку своей организации для сбора дополнительных данных по боту с вашего корпоративного сервера, либо сразу обратитесь в поддержку eXpress с ранее собранной информацией.

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

Вот что можно получить по боту с корпоративного сервера пользователя: логи контейнера с ботом в консоли, логи контейнера botx, логи контейнера messaging. Далее передаём информацию от пользователя (проблему, скриншоты, видео), файл .env со значениями переменных и эту информацию разработчикам через поддержку eXpress и ждём рекомендаций.

Если проблема повторяется только на конкретной клиентской платформе: веб/десктоп/iOS/Android, передайте информацию о проблеме и логи клиентского приложения разработчикам через поддержку eXpress, при необходимости проблема будет заведена как баг и исправлена в будущем.

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

Сначала попробуйте очистить кэш Smart App через кнопку-троеточие на экране или панели самого Smart App.

Если очистка кэша не помогает, выясните, в какой клиентской платформе повторяется проблема со Smart App: веб/десктоп или мобильное приложение, и узнайте номер версии приложения.

Проверьте, не повторяется ли проблема на другой клиентской платформе. Запишите шаги для воспроизведения проблемы, сделайте скриншоты и видео.

Далее соберите клиентские логи Smart App. Параллельно при необходимости через администратора корпоративного сервера (через вашу в поддержку) нужно собрать логи Smart App с сервера и файл .env со значениями переменных Smart App. Отправьте собранную информацию в поддержку eXpress, при необходимости проблема будет заведена как баг и исправлена в будущем.