Clomni

Что такое мобильный SDK и кому он нужен

Обновлено: 9 октября 2026 · 7 мин чтения

Clomni Mobile SDK открывает Clomni Messenger внутри Вашего приложения для iOS или Android. Пользователи пишут в поддержку, не выходя из приложения. Диалоги попадают к операторам в Clomni рядом с WhatsApp, Instagram и чатом сайта. В Clomni каждое приложение является одним каналом «Mobile app (App SDK)». Панель Clomni не имеет русского языка, поэтому названия меню ниже даны так, как они выглядят в английском интерфейсе.

Шаги

  1. 1

    Что делает SDK

    • Открывает Messenger нативными экранами, без WebView.
    • Запускает flow, собранные в Clomni, с нативными кнопками: выбор языка, меню, формы, передача оператору.
    • Показывает ответ оператора push-уведомлением, когда приложение закрыто.
    • Берёт цвета, логотип, тексты и новости из панели. Изменение в панели доходит до приложения без нового релиза.
    • Также есть отправка фото в диалоге, счётчик непрочитанных и опрос CSAT после диалога.

    SDK сам ничего не добавляет на Ваши экраны. Messenger открывается с Вашей кнопки, например со строки «Поддержка» на экране профиля. Есть и плавающая кнопка, но она скрыта, пока Вы её не включите.

  2. 2

    Кому нужен

    Компаниям со своим мобильным приложением, которые хотят поддерживать клиентов прямо в нём: магазины, банки, доставка, такси, игры. Канал в панели создаёт администратор, SDK в приложение добавляет разработчик приложения.

  3. 3

    Пакеты и минимальные версии

    • Android: ai.clomni:messenger:1.0.5 (Maven Central). Android 6.0 (API 23), Kotlin 1.8, compileSdk 35.
    • iOS: Swift Package https://github.com/clomni/clomni-mobile-sdk.git, версия 1.0.4, продукт ClomniMessenger. iOS 15, Xcode 15.
    • React Native: @clomni/react-native. React Native 0.75 (0.76 для New Architecture), Expo SDK 52 с development build.
    • Flutter: clomni_flutter. Flutter 3.16, iOS 15, Android API 24.
    • Unity: https://github.com/clomni/clomni-mobile-sdk.git?path=unity#unity-1.0.5. Unity 2021.3, iOS 15, Android API 23.

    React Native, Flutter и Unity работают поверх нативных SDK для Android и iOS, поэтому всё работает одинаково на всех платформах.

  4. 4

    Как подключается

    1. В панели создаётся канал «Mobile app (App SDK)». Вы получаете App ID, ключ API для каждой платформы и Identity Secret.
    2. Ваш сервер вычисляет user_hash с Identity Secret для каждого вошедшего пользователя.
    3. В приложение добавляется пакет, при запуске вызывается initialize, пользователь входит через loginUser, Messenger открывается с Вашей кнопки.
    4. Для push ключи Firebase и APNs загружаются в панель, токен устройства передаётся SDK.
    5. Проверка: «Test a hash», «Test push» и первое сообщение.

    Путь с нуля до первого сообщения описан в статье «Как подключить мобильный SDK к приложению за 15 минут».

  5. 5

    Включён ли канал в Вашем аккаунте

    Канал «Mobile app (App SDK)» включён не в каждом аккаунте. Если в «Settings › Workspace settings › Inboxes › Add Inbox» в каталоге нет карточки «Mobile app (App SDK)», канал в Вашем аккаунте ещё не включён. Его включает команда Clomni: напишите Clomni AI «включите мобильный SDK в моём аккаунте», и запрос будет передан команде.

    Если канал в аккаунте выключен, SDK пишет в лог this App SDK inbox is switched off in Clomni, и Messenger не открывается.

  6. 6

    Сеть

    SDK работает с https://app.clomni.ai/v1 по HTTPS и через WebSocket на том же хосте. Если корпоративная сеть или профиль MDM пропускает только разрешённые хосты, добавьте app.clomni.ai.

  7. 7

    Полное руководство

Документ

Clomni Mobile SDK: руководство по интеграции v1.0.5 · 72 стр. Открыть Скачать