Clomni

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

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

Этот путь ведёт с нуля до первого сообщения в приложении. Канал в панели создаёт администратор, остальное делает разработчик приложения. Если ключи Firebase и Apple уже готовы, на всё уходит около 15 минут.

Шаги

  1. 1

    Создайте канал

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

    На шаге 1 мастера заполните «Channel name», «Platforms», «Android package name» (applicationId в app/build.gradle(.kts), например com.example.app) и «iOS Bundle ID» (Xcode › target › Signing & Capabilities), затем нажмите «Create».

  2. 2

    Сохраните ключи

    • Шаг 2 «Installation»: скопируйте App ID и ключи API. Полностью ключ показывается только на этом шаге, потом панель показывает лишь его начало.
    • Шаг 3 «Identity verification»: сохраните Identity Secret на своём сервере, например в переменной окружения CLOMNI_IDENTITY_SECRET. Он показывается один раз и никогда не попадает в приложение. Отметьте «I have stored the secret safely», режим оставьте «Recommended».
    • Шаги Push, Appearance и Flows можно пока пропустить кнопкой «Do it later».
  3. 3

    Добавьте пакет и запустите SDK

    Android:

    // app/build.gradle.kts
dependencies {
    implementation("ai.clomni:messenger:1.0.5")
}
    // App.kt, registered in AndroidManifest.xml as <application android:name=".App">
import android.app.Application
import ai.clomni.messenger.Clomni
import ai.clomni.messenger.ClomniLogLevel

class App : Application() {
    override fun onCreate() {
        super.onCreate()
        Clomni.initialize(this, appId = "app_…", apiKey = "android_…")
        if (BuildConfig.DEBUG) Clomni.setLogLevel(ClomniLogLevel.DEBUG)
    }
}

    iOS: Xcode › File › Add Package Dependencies, https://github.com/clomni/clomni-mobile-sdk.git, «Up to Next Major Version» 1.0.4, продукт ClomniMessenger. Затем:

    // AppDelegate.swift
import ClomniMessenger
import UIKit

@main
final class AppDelegate: UIResponder, UIApplicationDelegate {
    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        Clomni.initialize(appId: "app_…", apiKey: "ios_…")
        #if DEBUG
        Clomni.setLogLevel(.debug)
        #endif
        return true
    }
}

    Код для React Native, Flutter и Unity есть в их статьях. Ключ API привязан к платформе: на Android android_…, на iOS ios_….

  4. 4

    Откройте Messenger со своей кнопки

    // Android
Clomni.present(source = "profile_support")
    // iOS, after the screen is shown
Clomni.present(source: "profile_support")

    source показывает, из какого места приложения открыт Messenger, и виден в статистике панели.

  5. 5

    Идентифицируйте пользователя

    Ваш сервер возвращает в ответе на вход user_hash для ID пользователя: hex(HMAC-SHA256(identity_secret, user_id)). Приложение передаёт его после входа:

    // Android
Clomni.loginUser(ClomniUser(userId = "12345", email = "[email protected]", name = "Aysel"), userHash = hashFromYourServer)
    // iOS
Clomni.loginUser(ClomniUser(userId: "12345", email: "[email protected]", name: "Aysel"), userHash: hashFromYourServer)

    Вызывайте Clomni.logout() вместе с выходом из Вашего приложения. Код сервера на 7 языках есть в статье «Ключи мобильного SDK и идентификация пользователей».

  6. 6

    Подключите push

    Загрузите service account JSON из Firebase и ключ APNs .p8 в раздел канала «Push», а в приложении передайте токен устройства через Clomni.setDeviceToken(...). Ключ APNs должен быть создан для «Sandbox & Production». Шаги описаны в статье «Ключи push для мобильного SDK» и в статье Вашей платформы.

  7. 7

    Проверьте, что всё работает

    1. Запустите приложение на телефоне и откройте Messenger. «Settings › Workspace settings › Inboxes» › Ваш канал › колонка настроек › «Installation»: устройство появится в «Recent devices» через несколько секунд. В «Overview» платформа станет «Installed».
    2. Колонка настроек › «Security» › «Test a hash»: введите user_id и user_hash, сделанный Вашим сервером, нажмите «Check». Ответ должен быть «Correct. The hash was made with the current secret.»
    3. Колонка настроек › «Push» › «Test push»: выберите устройство, нажмите «Send». Ответ «Sent. The notification should appear on the device.», и на телефоне появится уведомление. Если устройства нет в списке, на телефоне не разрешены уведомления или setDeviceToken не вызывается.
    4. Напишите сообщение из Messenger. Оно появится в «Conversations» под именем канала. Чтобы его видеть, оператор должен быть в разделе канала «Collaborators». Закройте приложение и ответьте: на телефон придёт push.

    Если что-то не работает, смотрите статью «Мобильный SDK: ошибки, причины и решения».

  8. 8

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

Документ

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