Clomni

Mobil SDK: ilk 15 dəqiqə, sıfırdan ilk mesaja

Son yeniləmə: 9 oktyabr 2026 · 8 dəq oxunur

Bu yol sıfırdan tətbiqdə ilk mesaja qədərdir. Kanalı paneldə administrator yaradır, qalanını tətbiqin proqramçısı edir. Push üçün Firebase və Apple açarları əvvəlcədən hazırdırsa, hər şey təxminən 15 dəqiqə çəkir.

Addımlar

  1. 1

    Kanalı yaradın

    Parametrlər › İş sahəsi parametrləri › Gələn qutular › «Gələn qutu əlavə et». Kataloqda «Mobil tətbiq (App SDK)» kartında «Qoşul» basın. Kart yoxdursa, kanal hesabınızda açıq deyil: Clomni AI-yə yazın, Clomni komandası açacaq.

    Sehrbazın 1-ci addımında «Kanalın adı», «Platformalar», «Android paket adı» (app/build.gradle(.kts)-dəki applicationId, məsələn com.example.app) və «iOS Bundle ID»-ni (Xcode › hədəf › Signing & Capabilities) yazın və «Yarat» basın.

  2. 2

    Açarları saxlayın

    • 2-ci addım «Quraşdırma»: App ID və API açarlarını kopyalayın. Tam açar yalnız bu addımda görünür, sonra panel yalnız əvvəlini göstərir.
    • 3-cü addım «Identity verification»: Identity Secret-i serverinizdə saxlayın, məsələn CLOMNI_IDENTITY_SECRET mühit dəyişənində. O yalnız bir dəfə göstərilir və heç vaxt tətbiqə qoyulmur. «Secret-i təhlükəsiz yerdə saxladım» işarəsini qoyun, rejim «Tövsiyə olunan» qalsın.
    • Push, Görünüş və Flow-lar addımlarını indi «Sonra et» ilə keçmək olar.
  3. 3

    Paketi əlavə edin və SDK-nı başladın

    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, məhsul ClomniMessenger. Sonra:

    // 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 və Unity üçün kod öz məqalələrindədir. API açarı platformaya bağlıdır: Android-də android_…, iOS-da ios_….

  4. 4

    Messenger-i öz düymənizdən açın

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

    source Messenger-in tətbiqin harasından açıldığını deyir və paneldəki statistikada görünür.

  5. 5

    İstifadəçini tanıdın

    Serveriniz login cavabında istifadəçinin ID-si üçün user_hash qaytarır: hex(HMAC-SHA256(identity_secret, user_id)). Tətbiq login-dən sonra onu verir:

    // 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)

    Tətbiqin öz çıxışında Clomni.logout() çağırın. Server kodu 7 dildə «Mobil SDK açarları və istifadəçinin tanıdılması» məqaləsindədir.

  6. 6

    Push-u qoşun

    Firebase service account JSON və APNs .p8 açarını kanalın «Push» bölməsinə yükləyin, tətbiqdə cihaz tokenini Clomni.setDeviceToken(...) ilə verin. APNs açarı «Sandbox & Production» üçün yaradılmalıdır. Addımlar «Mobil SDK push açarları» məqaləsində və platformanızın məqaləsindədir.

  7. 7

    İşlədiyini yoxlayın

    1. Tətbiqi telefonda işə salın və Messenger-i açın. Parametrlər › İş sahəsi parametrləri › Gələn qutular › kanalınız › ayarlar sütunu › Quraşdırma: «Son cihazlar» siyahısında cihaz bir neçə saniyəyə görünür. «Ümumi baxış»da platforma «Quraşdırılıb» olur.
    2. Ayarlar sütunu › Təhlükəsizlik › «Hash-i yoxla»: user_id-ni və serverinizin hazırladığı user_hash-i yazın, «Yoxla» basın. Cavab «Düzdür. Hash cari secret ilə hazırlanıb.» olmalıdır.
    3. Ayarlar sütunu › Push › «Test bildirişi»: cihazı seçin, «Göndər» basın. Cavab «Göndərildi. Bildiriş cihazda görünməlidir.» olur və telefonda bildiriş çıxır. Cihaz siyahıda yoxdursa, telefonda bildirişlərə icazə verilməyib və ya setDeviceToken çağırılmır.
    4. Messenger-dən mesaj yazın. O, Söhbətlər-də bu kanalın adı ilə görünür. Söhbəti görmək üçün agent kanalın «Əməkdaşlar» bölməsində olmalıdır. Tətbiqi bağlayın və cavab yazın: telefona push gəlir.

    Nə isə alınmasa, «Mobil SDK: xətalar, səbəbləri və həlli» məqaləsinə baxın.

  8. 8

    Tam təlimat

Sənəd

Clomni Mobile SDK: inteqrasiya təlimatı v1.0.5 · 72 səhifə Aç Endir