Введение

О продукте

SDK edna Chat Center для мобильных приложений — это отличный инструмент, с помощью которого вы сможете создать чат с агентами Chat Center и встроить его в ваше iOS‑приложение. Этот чат послужит удобным и эффективным средством связи между вами и вашими клиентами. Сообщения, полученные и отправленные через чат, будут доступны агентам в АРМ edna Chat Center.

Как работает чат

Чат открывается по кнопке, настраиваемой на вашей стороне. Клиенты, которые пишут в чат в мобильном приложении, всегда являются авторизованными для edna Chat Center, edna получает их уникальный внешний идентификатор, который не меняется от обращения к обращению. Таким образом, и ваши агенты, которые общаются с клиентами, и сами клиенты всегда смогут отследить историю обращений и переписки. Когда клиент заходит в чат в приложении, edna получает его идентификаторы на фоне, и это может быть что угодно: ФИО, имя домашнего животного, марка машины, наличие карты лояльности и так далее. Агенты edna Chat Center увидят эти данные в карточке клиента и смогут использовать полученную информацию, тем самым улучшая качество предоставляемой консультации. Идентификаторы, которые получает edna от клиента, могут быть любыми — вы самостоятельно настраиваете поля, которые необходимо отправить системе (externalClientId и любые данные в формате параметр-значение). За подробностями обращайтесь в поддержку support@edna.ru.

Кастомизация чата

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

Архитектура и ключевые компоненты

• ChatCenterUISDK — фасад SDK, который управляет жизненным циклом, хранит ссылку на конфигурацию и темы.
• ChatConfig — модель бизнес-настроек (функции чата, поиск, голосовые сообщения, работа сокета).
• ChatTransportConfig/ChatNetworkConfig — параметры подключения (REST, WebSocket, datastore, SSL pinning).
• ChatTheme и ChatComponents — дизайн‑система: цвета, типографика, изображения и точечные стили экранов.
• ChatLoggerConfig, ChatLocalizationConfig — вспомогательные модели для логирования и локализации.

Полное описание классов доступно в API-справочнике docs-sdk.edna.ru/ios-docs/index.html.

Жизненный цикл интеграции

1. Инициализация — создайте ChatTransportConfig, ChatConfig и экземпляр ChatCenterUISDK.
2. Настройка тем/локали/логирования — примените ChatTheme, darkTheme, localizationConfig, loggerConfig.
3. Авторизация пользователя — вызовите authorize(user:auth:), когда в приложении доступен устойчивая идентификация клиента.
4. Открытие чата — получите контроллер через getChat() и встроите его в навигацию (push/present).
5. Обработка уведомлений — передавайте device token и вызывайте handleNotification(userInfo:), когда нужно открыть чат по пушу.
6. Завершение сессии — при необходимости выполните logout() или deauthorizeUser(), чтобы отключить пользователя и освободить ресурсы.

Дополнительно используйте isChatCenterNotification(_:), чтобы отличить уведомления SDK от ваших собственных. Подробнее — в разделах “Подключение”, “Инициализация”, “Отображение чата” и “Уведомления”.