Öz sisteminizdən (sayt, tətbiq, CRM) WhatsApp ilə şablon, OTP kodu, bildiriş və toplu mesaj göndərmək: API açarı, endpointlər, xərc, 24 saatlıq pəncərə, webhook, xətalar və kod nümunələri.

Sənəddən yazılmış məqalələr

• WhatsApp API-yə başlamaq: API açarı, account_id və channel_id WhatsApp API şirkətinizin öz sistemindən (sayt, tətbiq, CRM) müştəriyə WhatsApp mesajı göndərir. Lazımdır: Cloud API tipli WhatsApp gələn qutusu, təsdiqlənmiş şablon, API açarı, account_id və channel_id. Sorğular https://api.clomni.ai ünvanına Authorization: Bearer <API_ACARI> başlığı ilə gedir.
• WhatsApp API: mesajın qiyməti, 24 saatlıq pəncərə və fallback_template Meta mesaj başına tutur: UTILITY və AUTHENTICATION şablonu 0.036 AZN, MARKETING 0.165 AZN, 24 saatlıq pəncərə içində sərbəst mətn pulsuzdur. Clomni əlavə haqq almır. Pəncərəni müştəri açır. text ilə fallback_template birlikdə göndərin: pəncərə açıqdırsa mətn pulsuz gedir (sent_as: session), bağlıdırsa şablon (sent_as: template).
• WhatsApp API ilə mesaj göndərmək: OTP kodu, şablon və mətn POST /v1/accounts/{account_id}/whatsapp/messages: channel_id, phone_number və template (name, language, parameters) və ya text göndərin. Şablonun adını, dilini və dəyişənlərini GET /v1/accounts/{account_id}/whatsapp/templates verir. Cavab 201: mesajın id-si və sent_as.
• WhatsApp API ilə toplu göndəriş (bulk_messages) POST /v1/accounts/{account_id}/whatsapp/bulk_messages bir şablonu bir sorğuda ən çoxu 1000 nömrəyə göndərir, cavab 202 və batch_id-dir. Nəticəni GET /v1/accounts/{account_id}/whatsapp/bulk_messages/{batch_id} ilə 7 gün oxumaq olar. Yalnız administrator göndərə bilər.
• WhatsApp API: mesajın çatdırılma statusunu izləmək Mesajın vəziyyətini GET /v1/accounts/{account_id}/whatsapp/messages/{message_id} ilə oxuyun: sent, delivered, read, failed. Daha səmərəli yol webhook-dur: Parametrlər › İş sahəsi parametrləri › İnteqrasiyalar › Webhook bölməsində message_updated («Mesaj yeniləndi») hadisəsini seçin. Hər mesaj üçün öz ünvanınıza xəbər: göndərişə status_callback (url, after_seconds, on_change, secret) əlavə edin.
• WhatsApp API xətaları: 401, 403, 404, 422 və Meta xətaları Xəta JSON-da error sahəsi ilə qayıdır. 401: açar yoxdur və ya səhvdir. 403: açarın sahibi gələn qutunun üzvü deyil. 404: channel_id və ya mesaj id-si səhvdir. 422: sorğuda nə isə çatmır, pəncərə bağlıdır, şablon tapılmır və ya nömrə səhvdir. Meta rədd etsə mesaj failed olur, səbəb external_error-dadır.
• API ilə göndərilən mesajlar paneldə: söhbət niyə «həll olunub» olur API ilə göndərilən mesaj müştərinin söhbətinə yazılır, söhbət isə avtomatik «həll olunub» (resolved) olur: açıq söhbətlərdə görünmür, səs gəlmir. Müştəri cavab yazan kimi söhbət açılır. Söhbəti açıq saxlamaq üçün conversation_status: open və ya pending göndərin.