Решение проблем с чат-ботами и SmartApps

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

Обновите компонент операционной системы Android System WebView до актуальной версии: от него зависит работа SmartApps в мобильном приложении для Android. Если после обновления Android System WebView SmartApp работает с ошибками, очистите кэш SmartApp.

Бот не работает или работает неправильно — общие рекомендации

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

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

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

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

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

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

CTS

eCTS

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

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

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

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

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

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

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

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

Ошибка авторизации бота “401 Unauthorized”

Параметры чат-бота — база знаний, откроется в новой вкладке

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

SmartApp не работает или работает неправильно — общие рекомендации

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

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

Proxy SmartApp не открывает ресурс или показывает пустой экран

В веб-версии проксирование не работает: откройте приложение на компьютере или на телефоне.

Очистите кэш Proxy SmartApp: нажмите три точки в правом верхнем углу приложения и выберите очистку кэша. Затем откройте Proxy SmartApp заново.

Сравните поведение Proxy SmartApp в корпоративной и в мобильной сети. По разнице администратор поймёт, где искать причину.

Если ничего не помогло, обратитесь в поддержку своей организации или к администратору: Proxy SmartApp настраивают на корпоративном сервере.

Администратору: сбор диагностики Proxy SmartApp

Соберите файл .env, серверные логи бота и SmartApp, клиентскую диагностику и HAR с десктопа.

Администратору: ресурс открывается на компьютере, но не на телефоне

Чаще всего причина в сертификате ресурса. Проверьте три условия:

1. Корневой и промежуточные сертификаты удостоверяющего центра добавлены в карточке бота, в поле TLS сертификаты проксируемого ресурса (PEM).
2. Сервер ресурса отдаёт полную цепочку сертификатов.
3. В сертификате ресурса есть расширение Extended Key Usage со значением TLS Web Server Authentication. Без него iOS не принимает сертификат.

В приложении eXpress для iOS корпоративный удостоверяющий центр нужно дополнительно установить на каждое устройство. После установки включите доверие к нему: Настройки > Основные > Об этом устройстве > Доверие сертификатам. Порядок установки — в разделе Сертификаты на iOS/iPadOS.

В брендированном приложении (ETS) для iOS удостоверяющий центр подгружается автоматически, без установки на устройства, если в сборке приложения включён отдельный флаг. Чтобы его включили для вашей сборки, обратитесь в поддержку eXpress.

Ошибка «Нет подключения к интернету» в SmartApp

Убедитесь, что с сетевым подключением вашего устройства всё в порядке — подробнее. Если с соединением всё в порядке, проблема может быть на корпоративном сервере с ботами и SmartApps. Обратитесь в поддержку вашей организации.