WhatsApp API: mesajın qiyməti, 24 saatlıq pəncərə və fallback_template

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

Addımlar

1. 1

   Qiymətlər

   • UTILITY (sifariş, çatdırılma, ödəniş, xatırlatma): 0.036 AZN
   • AUTHENTICATION (OTP, giriş təsdiqi): 0.036 AZN
   • MARKETING (kampaniya, endirim, elan): 0.165 AZN
   • Pəncərə içində sərbəst mətn: pulsuz

   Bu, Meta-nın mesaj başına tarifidir, Clomni əlavə haqq almır. MARKETING UTILITY-dən 4,6 dəfə bahadır, ona görə sifariş, çatdırılma və xatırlatma şablonlarını Meta-da UTILITY kimi yaradın. Kateqoriya həm qiymətə, həm də təsdiq şansına təsir edir.

2. 2

   24 saatlıq pəncərə

   Müştəri sizə yazan andan 24 saat açılır. Bu müddətdə ona istənilən mətni pulsuz göndərə bilərsiniz. Pəncərə bağlıdırsa yalnız təsdiqlənmiş şablon göndərmək olar və hər şablon ayrıca ödənilir.

   Sizin göndərdiyiniz şablon pəncərəni açmır. Pəncərəni müştəri açır: cavab yazanda və ya şablondakı sürətli cavab düyməsinə (quick reply) toxunanda.

3. 3

   fallback_template ilə bir sorğu

   Sorğuda text (mətn) və fallback_template (pəncərə bağlı olanda göndəriləcək şablon) birlikdə verin. Clomni pəncərəni özü yoxlayır:

   • açıqdırsa mətn gedir, cavabda sent_as: "session" olur (pulsuz);
   • bağlıdırsa şablon gedir, sent_as: "template" (ödənişli);
   • fallback_template verilməyibsə və pəncərə bağlıdırsa, mesaj göndərilmir və 422 qayıdır: xəbəriniz olmadan ödənişli mesaj getmir.

   fallback_template-in quruluşu template ilə eynidir: name, language, parameters.

   {
     "channel_id": 159,
     "phone_number": "+994 50 123 45 67",
     "text": "Bağlamanız kuryerə verildi. Bu gün 18:00-a qədər çatdırılacaq.",
     "fallback_template": {
       "name": "kargo_status",
       "language": "az",
       "parameters": { "body": { "1": "AZ-10422", "2": "kuryerdə" } }
     }
   }

4. 4

   Kargo nümunəsi: 5 bildiriş, 1 ödəniş

   Bir bağlama üçün gün ərzində 5 bildiriş gedir: «qəbul olundu», «anbara çatdı», «gömrükdən keçdi», «kuryerdə», «təhvil verildi». Hər birini ayrıca şablonla göndərmək 5 ödənişdir. Düzgün yol belədir:

   • birinci bildirişi sürətli cavab düyməsi olan şablonla göndərin, məsələn «Bağlamanı izlə» və ya «Bəli, xəbərdar edin» (1 ödəniş);
   • müştəri düyməyə toxunanda 24 saatlıq pəncərə açılır;
   • qalan bildirişləri adi mətn kimi göndərin: pulsuzdur, təsdiq tələb etmir;
   • növbəti bildiriş 24 saatdan sonraya düşərsə, API özü fallback_template-ə keçir.
5. 5

   Hesablama

   1000 bağlama, gündə 5 bildiriş:

   • hər bildiriş ayrıca şablonla: gündə 180 AZN, ayda (30 gün) 5 400 AZN, ildə 65 700 AZN;
   • 1 şablon və 4 pulsuz mətnlə: gündə 36 AZN, ayda 1 080 AZN, ildə 13 140 AZN;
   • qənaət: gündə 144 AZN, ayda 4 320 AZN, ildə 52 560 AZN.

   Hesab bütün müştərilərin düyməyə toxunduğunu fərz edir. Praktikada 60-80% toxunur, real qənaət təxminən bu məbləğin dörddə üçüdür.

   10 000 nəfərlik MARKETING kampaniyası 10 000 × 0.165 AZN = 1 650 AZN edir. Cavab yazan və ya düyməyə toxunan müştəri ilə sonrakı 24 saatlıq yazışma pulsuzdur.

6. 6

   Hansı halda nə gedir

   • Müştəri son 24 saatda yazıb və ya şablon düyməsinə toxunub: text gedir, pulsuzdur.
   • Pəncərə bağlıdır, fallback var: fallback_template gedir, 0.036 AZN (utility) və ya 0.165 AZN (marketing).
   • Pəncərə bağlıdır, fallback yoxdur: 422 xətası, mesaj getmir, ödəniş yoxdur.
   • İlk təmas: şablon, OTP üçün 0.036 AZN, kampaniya üçün 0.165 AZN.
7. 7

   Pəncərəni əvvəlcədən yoxlayın

   Çox bildiriş hazırlayırsınızsa, hansı nömrələrin pəncərəsinin açıq olduğunu əvvəlcədən öyrənin: açıq olanlar pulsuzdur.

   curl -s "https://api.clomni.ai/v1/accounts/{account_id}/whatsapp/messages/window?channel_id=159&phone_number=%2B994501234567" \
     -H "Authorization: Bearer <API_ACARI>"

   Cavab:

   {
     "open": true,
     "last_inbound_at": "2026-08-07T09:15:00Z",
     "expires_at": "2026-08-08T09:15:00Z",
     "conversation_id": 1042
   }

   open: false və last_inbound_at: null o deməkdir ki, bu nömrə sizə heç yazmayıb: ilk mesaj şablonla olmalıdır.