Перейти к содержанию

Webim Mobile Widget

Webim Mobile Widget — готовый интерфейс чата для посетителя, который встраивается в мобильное приложение (Android/iOS) как UI-компонент. Он позволяет быстро добавить в приложение окно чата Webim без разработки собственного пользовательского интерфейса.

Mobile Widget построен поверх Webim Mobile SDK и использует ту же серверную часть Webim: сессии, диалоги, операторы, отделы и настройки размещения.

Когда использовать Mobile Widget

Mobile Widget подходит, если нужно:

  • быстро встроить чат в приложение и получить готовый экран диалога;

  • минимизировать объём клиентской разработки;

  • использовать стандартное поведение и внешний вид виджета с возможностью ограниченной кастомизации.

Что входит в Mobile Widget

В составе Mobile Widget:

  • UI-компонент для отображения диалога (список сообщений, поле ввода, вложения);

  • логика подключения к Webim через Mobile SDK (инициализация сессии, обработка событий и состояния чата);

  • набор настроек по умолчанию, которые можно переопределять в рамках поддерживаемых параметров платформы.

Базовые требования и термины

Для работы Mobile Widget нужны:

  • аккаунт Webim;

  • размещение — настройка, которая определяет правила обработки чатов (маршрутизация, отделы, рабочее время и т. п.);

  • параметры подключения, которые приложение передаёт в SDK/виджет (например, адрес аккаунта и имя размещения).

N.B.

Mobile Widget предназначен для чата посетителя в мобильном приложении. Возможности мобильной версии виджета могут отличаться от веб-виджета. Подробности приведены в статье «Различия между веб и мобильной версиями виджета».

Поддерживаемые платформы

  • Android — виджет используется как компонент View (ChatView) и подключается как библиотека проекта.

  • iOS — виджет подключается как зависимость (например, через CocoaPods/Swift Package Manager/Carthage) и встраивается в приложение.

N.B.

При использовании Webim Mobile Widget в iOS-приложении дополнительно подключается компонент WebimMobileKeyboard — как зависимость виджета. Отдельно этот компонент обычно не устанавливается и не используется. Репозиторий: https://github.com/webim/webim-mobile-keyboard-ios. Для Android отдельной версии WebimMobileKeyboard нет.