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

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

Для корректной работы SmartApps в мобильном приложении для Android компонент операционной системы Android System WebView должен иметь актуальную версию. Если после обновления 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

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

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

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