# 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/виджет (например, адрес аккаунта и имя размещения).

!!! Note "N.B."
    Mobile Widget предназначен для **чата посетителя** в мобильном приложении. Возможности мобильной версии виджета могут отличаться от веб-виджета. Подробности приведены в статье [«Различия между веб и мобильной версиями виджета»](https://webim.ru/kb/mobile/webim-widget/web-and-mobile-visitor-widget-differences.html).

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

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

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

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

---

Источник: https://webim.ru/kb/mobile/webim-widget/index.html