WhatsApp API-yə başlamaq: API açarı, account_id və channel_id

Son yeniləmə: 27 sentyabr 2026 · 8 dəq oxunur

Addımlar

1. 1

   Ön şərtləri yoxlayın

   • Hesabda WhatsApp Cloud API tipli gələn qutu olmalıdır. QR ilə qoşulmuş WhatsApp nömrəsi bu API ilə işləmir: şablon yalnız Cloud API-də var.
   • Meta Business Manager-də ən azı bir şablon APPROVED statusu almalıdır.
   • Şablonları Clomni-yə gətirin: Parametrlər › İş sahəsi parametrləri › Gələn qutular, WhatsApp qutusunun Konfiqurasiya bölməsində Şablonları sinxronlaşdır. Bu addım atılmasa API şablonu tapmır.
2. 2

   API açarını götürün

   Panelə administrator hesabı ilə daxil olun. Sol menyunun aşağısında profil şəklinizə basın, Profil parametrləri seçin və API girişi bölməsinə keçin. Yeni açar ilə açar yaradın və dərhal kopyalayın: açar bir daha göstərilmir.

   Sənəddə bu açar Access Token adlanır. Addımlar ətraflı «API açarı yaratmaq (API girişi)» məqaləsindədir.

3. 3

   account_id və channel_id-ni tapın

   account_id panelin ünvanındadır: my.clomni.co/panel/accounts/88/... ünvanında 88 hesabınızın nömrəsidir.

   channel_id WhatsApp gələn qutusunun nömrəsidir: Parametrlər › İş sahəsi parametrləri › Gələn qutular bölməsində qutunu açanda ünvanda görünür. Bütün WhatsApp nömrələrinizi və onların channel_id-sini bu sorğu da qaytarır:

   curl -s "https://api.clomni.ai/v1/accounts/{account_id}/whatsapp/channels" \
     -H "Authorization: Bearer <API_ACARI>"

   Orada sendable: false olan kanal QR ilə qoşulub, bu API onunla göndərmir.

4. 4

   Sorğunun ümumi qaydaları

   • Base URL: https://api.clomni.ai, yalnız HTTPS (HTTP sorğu 301 ilə yönləndirilir)
   • Hər sorğuda iki başlıq: Authorization: Bearer <API_ACARI> və Content-Type: application/json
   • Kodlaşdırma UTF-8, cavab JSON
   • Tarixlər ISO 8601 və UTC-dədir, məsələn 2026-08-07T18:20:28.080Z

   Xəta həmişə eyni formadadır, JSON-da error sahəsi:

   { "error": "Invalid phone number: 123" }

5. 5

   Kim nə edə bilər

   • Şablonların siyahısı, tək mesaj göndərmək və pəncərənin vəziyyəti: administrator və ya həmin gələn qutuya təyin olunmuş agent
   • Mesajın statusu: hesabın istənilən istifadəçisi
   • Toplu göndəriş: yalnız administrator

   İnteqrasiya üçün ayrıca istifadəçi (məsələn «API Integration») yaradıb açarı ondan götürmək yaxşıdır: kimin göndərdiyi söhbətdə görünür, işçi işdən çıxanda inteqrasiya dayanmır.

6. 6

   Açarı qoruyun

   Açar hesabınıza tam giriş verir. Onu yalnız öz serverinizdə saxlayın: brauzerdə, JavaScript-də, mobil tətbiqin içində yox. Açarı heç kimə göndərməyin, çata da yazmayın.

   Açar sızarsa API girişi bölməsində onu Söndür və ya Sil ilə dayandırın və yenisini yaradın. Bitmə tarixi boş qalsa açar müddətsizdir.

7. 7

   Köhnə versiya ilə qoşulmusunuzsa

   Versiya 1 ilə inteqrasiya etmisinizsə, yeni ünvan api.clomni.ai/v1/..., yeni başlıq Authorization: Bearer <API_ACARI>-dır. Köhnə api_access_token başlığı və inbox_id parametri işləməyə davam edir, keçidi tələsmədən edə bilərsiniz.

   inbox_id-nin yeni adı channel_id, cavabdakı source_id sahəsi isə indi whatsapp_message_id adlanır.

8. 8

   Sınaq

   Ayrıca test mühiti (sandbox) yoxdur. Sınaq üçün alıcı kimi öz nömrənizi yazın: real mesaj gedir, nəticəni tam görürsünüz.