Clomni

Мобильный SDK: частые вопросы

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

Короткие ответы о мобильном SDK. Подробные шаги есть в других статьях этой темы.

Шаги

  1. 1

    Минимальные версии

    • Android: Android 6.0 (API 23), Kotlin 1.8, compileSdk 35.
    • iOS: iOS 15, Xcode 15.
    • React Native: 0.75 (0.76 для New Architecture), Expo SDK 52.
    • Flutter: 3.16, iOS 15, Android API 24.
    • Unity: 2021.3 (Unity 6 тоже работает), iOS 15, Android API 23.
  2. 2

    Насколько SDK увеличивает приложение

    Библиотека Android (release AAR) весит около 2 МБ, в приложении с R8 меньше. Фреймворк iOS весит около 3,7 МБ. SDK для Android использует только OkHttp, kotlinx.serialization, Coil и Jetpack Compose, SDK для iOS только системные фреймворки.

  3. 3

    Какие данные собираются

    • То, что передаёт приложение: ID пользователя, имя, e-mail, телефон, пользовательские атрибуты.
    • Сообщения пользователя в поддержку и отправленные фото.
    • Об устройстве: случайный ID устройства, который SDK создаёт сам, платформа, версия ОС, модель, версии приложения и SDK, язык, часовой пояс, токен push.
    • Где открыт Messenger (source).

    Рекламного ID, геолокации и отслеживания нет. Данные служат только функции поддержки. SDK для Android запрашивает только разрешения на интернет и состояние сети. В пакете iOS есть privacy manifest Apple (PrivacyInfo.xcprivacy): в форме конфиденциальности App Store укажите эти типы как «связаны с пользователем, для работы приложения, без отслеживания».

  4. 4

    Лицензия

    SDK распространяется по лицензии Apache License 2.0. Имя Clomni, логотипы, маскот и звук сообщения под неё не подпадают (файл NOTICE в репозитории).

  5. 5

    Что будет при смене ключа или секрета

    • «Security» › «Make a new secret»: старый секрет работает ещё 7 дней, за это время переведите сервер на новый.
    • «Installation» › «New key»: старый ключ API работает ещё 7 дней. Потом версии приложения со старым ключом не подключаются, поэтому создавайте новый ключ вместе с новым релизом приложения.
    • «Revoke»: ключ останавливается сразу. Только для утёкшего ключа.
    • Новый ключ push: загрузите его в разделе Push, следующий push его использует.
  6. 6

    Сколько приложений в одном канале

    Один канал соответствует одному приложению: одно имя пакета Android и один iOS Bundle ID. Версии одного приложения для Android и iOS делят один канал. Для каждого другого приложения создайте отдельный канал: у каждого будут свои App ID, ключи, внешний вид и статистика.

  7. 7

    Тестовая и боевая среда

    Отдельного тестового сервера в Clomni нет: тестовая сборка тоже работает с app.clomni.ai, её сообщения попадают в настоящий канал. На iOS SDK сам сообщает среду APNs каждого устройства (sandbox или production), ключ Sandbox & Production обслуживает обе. Чтобы отделить тестовые диалоги от боевых, создайте отдельный канал для тестовых сборок. Режим «Off» в Identity verification предназначен только для тестов.

  8. 8

    Как выглядит заголовок push

    «Push» › «Notification title»: «Agent · Brand» (по умолчанию, например «Leyla · Example»), «Brand name only», «Agent name only» или «Your own text». Когда отвечает бот, показывается имя бренда. Текст является самим сообщением. На Android одно уведомление на диалог, новое сообщение заменяет старое.

  9. 9

    Работает ли CSAT в приложении

    Да. Включите опрос в разделе CSAT канала. Когда диалог решён, Messenger показывает опрос карточкой внутри диалога: 5 эмодзи или 5 звёзд, с необязательным комментарием. Результаты в «Reports › CSAT».

  10. 10

    Что происходит без интернета

    Messenger вверху показывает «Нет подключения к интернету». Пользователь может продолжать писать: каждое сообщение сохраняется на устройстве до отправки, не теряется при обрыве связи или закрытии приложения и уходит само, когда интернет вернётся. Если после нескольких попыток оно не ушло, рядом с ним появляется «Не отправлено», и его можно отправить снова.

  11. 11

    Поддерживается ли Expo

    Да, Expo SDK 52 или новее с development build (npx expo prebuild, сборка EAS). Expo Go не загружает нативные модули. Config plugin пакета @clomni/react-native записывает тексты разрешений для фото, entitlement push для iOS, разрешение Android POST_NOTIFICATIONS и иконку уведомления.

  12. 12

    Можно ли скрыть «Powered by Clomni»

    Внизу главной Messenger написано «Powered by Clomni». Опция «Show "Powered by Clomni" at the bottom» в «Appearance» › «Theme» работает только в аккаунте с white label. Если видите «Hiding this label is not part of your plan», её включает команда Clomni: напишите Clomni AI.

  13. 13

    Добавляет ли SDK кнопку в моё приложение

    Нет. Messenger открывается через present с Вашей кнопки. Есть и плавающая кнопка, по умолчанию выключенная.

  14. 14

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

Документ

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