Developer platforması: nədir və hansı yolu seçmək

Son yeniləmə: 11 noyabr 2026 · 6 dəq oxunur

Addımlar

1. 1

   Əsas sözlər

   • Token: proqramın Clomni-yə sorğu göndərəndə özünü tanıtdığı gizli açar. Parol kimidir, kimsəyə verilmir.
   • Scope: tokenin nə edə biləcəyini deyən icazə, məsələn contacts:read kontaktları oxumaq üçündür.
   • Endpoint: API-nin bir ünvanı və əməliyyatı, məsələn GET /v1/conversations söhbət siyahısını qaytarır.
   • Webhook: Clomni-də hadisə olanda (yeni mesaj, yeni kontakt) Clomni-nin sizin serverinizə özü göndərdiyi xəbər.
   • OAuth: başqa şirkətin administratorunun öz hesabını sizin app-a parol vermədən, razılıq ekranında «İcazə ver» basaraq qoşduğu qayda.
   • Review: Clomni əməkdaşının app-ın istədiyi scope-ları yoxlayıb təsdiqləməsi.
2. 2

   Yol 1: şəxsi API açarı

   Profil şəkliniz › Profil parametrləri › API girişi › «Yeni açar». Açar sizin adınızdan və sizin icazələrinizlə işləyir, scope və review yoxdur, dərhal işləyir. Sorğu Authorization: Bearer <API_ACARI> başlığı ilə gedir, ünvanda hesabın nömrəsi olur: https://api.clomni.ai/v1/accounts/{account_id}/whatsapp/.... Bu açar yalnız WhatsApp API-də işləyir (şablon, mesaj, status). Söhbət, kontakt, hesabat kimi digər məlumat üçün developer app lazımdır (Yol 2 və ya 3). Saytdan və ya CRM-dən WhatsApp ilə OTP və bildiriş göndərmək üçün uyğundur. Açar geniş giriş verir və onu yaradan əməkdaş işdən çıxanda inteqrasiya dayanır. Addımlar: «API açarı yaratmaq (API girişi)» məqaləsi.

3. 3

   Yol 2: daxili app

   developer.clomni.ai-da «Yeni app» ilə öz workspace-iniz üçün yaradılır, yalnız həmin workspace-in administratoru yarada bilər. Lazım olan scope-ları seçirsiniz, Clomni yoxlayır, token yalnız təsdiqlənmiş scope-larla işləyir. Şəxsi token (clomni_pat_, 30-365 gün) və ya serverin özü aldığı 1 saatlıq app tokeni (clomni_at_) var. İmzalı webhook-lar, sinxron, hadisə lenti, ixrac və test kanalı ilə gəlir. Ünvanda workspace nömrəsi yoxdur: https://api.clomni.ai/v1/conversations. CRM, ERP, öz panel, BI kimi daimi inteqrasiya üçündür.

4. 4

   Yol 3: public app

   Başqa Clomni hesablarının qoşduğu app. Hər workspace-in administratoru razılıq ekranında icazələri oxuyur, «İcazə ver» basır və həmin workspace üçün ayrıca token yaranır (OAuth). Aşağı riskli olanlar da daxil, hər scope review-dan keçir. Listinq ayrıca təsdiqlənəndən sonra app paneldəki App-lar kataloqunda görünür. Məhsulunuzu bir çox Clomni müştərisinə təklif edirsinizsə, bu yolu seçin. Ətraflı: «Public app və OAuth» məqaləsi.

5. 5

   İstəyə görə seçim

   • Saytdan OTP və ya sifariş bildirişi göndərmək, tez başlamaq: şəxsi API açarı və WhatsApp API («WhatsApp API-yə başlamaq» məqaləsi).
   • CRM kontaktları Clomni ilə sinxron qalsın: daxili app, «CRM sinxronu» dəsti.
   • Öz panelimizdə Clomni söhbətləri və cavab: daxili app, «Öz panelimdə Clomni» dəsti.
   • Rəqəmlər Power BI, Looker kimi alətə getsin: daxili app, «BI və hesabat» dəsti.
   • Bütün tarixçəni bir dəfə köçürmək: daxili app, «Məlumat ixracı» dəsti.
   • Məhsulumuzu bütün Clomni müştərilərinə təklif etmək: public app.
   • Hazır app qoşmaq, kod yazmamaq: Parametrlər › İş sahəsi parametrləri › App-lar («Paneldə App-lar» məqaləsi).

   Hansı scope-ların lazım olduğunu «Hansı scope lazımdır: istəyinizə görə scope və endpoint seçimi» məqaləsi izah edir.

6. 6

   Haradan başlamaq

   1. Yolu seçin. Hazır app-dırsa, panelin App-lar səhifəsinə keçin.
   2. Öz inteqrasiyanızdırsa, «developer.clomni.ai-da app yaratmaq» məqaləsi ilə app yaradın və scope istəyin.
   3. Review-u gözləyərkən test kanalında sınayın («Test kanalı» məqaləsi).
   4. Token yaradın və proqramçınıza tam bələdçini (PDF) verin: bütün addımlar, kod nümunələri və xəta kodları ordadır.

   Suallar üçün: [email protected], təhlükəsizlik üçün: [email protected].