Zəng webhook-ları: inteqrasiya təlimatı
v1.0 · 11 səhifə · Son yeniləmə: 9 oktyabr 2026
Zəng başlayanda, cavab veriləndə, bitəndə və yazısı hazır olanda öz sisteminizə məlumat almaq: qurulum, sorğu nümunələri, bütün sahələr, imzanın yoxlanması və zəng xidmətləri arasında fərqlər.
Sənəddən yazılmış məqalələr
- Zəng webhook-ları: zəngləri öz sisteminizə ötürmək Parametrlər › İş sahəsi parametrləri › İnteqrasiyalar › Webhook › «Yeni webhook əlavə et». «Zənglər» bölməsində «Zəng başladı», «Zəngə cavab verildi», «Zəng bitdi», «Zəngin yazısı hazırdır» hadisələrini seçin. Clomni hər zəng üçün hər hadisəni bir dəfə göndərir: müddət, nəticə, zəngi kimin bitirdiyi, yazı, mətn və xülasə ilə.
- Zəng webhook-ları: hadisələr və nə vaxt gəldikləri call_started gələn zəng çalanda və ya əməkdaş zəng edəndə, call_answered cavab veriləndə, call_ended zəng bitəndə (müddət, nəticə, kim bitirdi), call_recording_ready yazı, mətn və xülasə hazır olanda gəlir. Hər hadisə hər zəng üçün bir dəfə. Cavab verilməyən zəngdə call_answered olmur. Telefonda cavab verilən WhatsApp (QR) zəngində call_ended telefonun jurnalını 10 dəqiqəyə qədər gözləyir.
- Zəng webhook-ları: sorğunun sahələri və nümunələr Hər sorğu JSON-dur: event, delivery_id, id, provider_call_id, account, inbox, conversation, message_id, direction, status, contact, agent, started_at, answered_at, ended_at, duration_seconds, duration_known, ended_by, answered_on, recording_url, transcript_available, transcript, summary, language. Bilinməyən sahə null olur.
- Zəng webhook-ları: imzanı yoxlamaq Hər sorğuda X-ChatX-Delivery, X-ChatX-Timestamp və X-ChatX-Signature başlıqları var. İmza: sha256= və HMAC-SHA256(gizli açar, "<timestamp>.<xam gövdə>"). Gizli açar webhook yarananda göstərilir və redaktə pəncərəsindədir. Vaxtı 5 dəqiqədən köhnə sorğunu qəbul etməyin.
- Zəng webhook-ları: çatdırma, təkrar və dublikatlar Serveriniz 5 saniyədə 2xx qaytarmalıdır. Qoşulma xətası, timeout, 429 və ya 5xx olanda Clomni göndərişi təkrarlayır: cəmi 5 cəhd, aralarda 30 saniyə, 1, 2 və 4 dəqiqə. 4xx son cavabdır, təkrar olmur. delivery_id təkrarda dəyişmir: eyni delivery_id ikinci dəfə gəlsə, dublikatdır.
- Zəng webhook-ları: WhatsApp QR, WhatsApp Business API və Twilio fərqləri WhatsApp (QR): gələn zəngə telefonda cavab verilir (answered_on: phone, agent: null), müddət cavab anından və ya telefonun jurnalından, yazı yalnız paneldən və tətbiqdən edilən zəngdə. WhatsApp Business API: cavab paneldə, ended_by agent/contact/system, busy var. Twilio: ended_by konfransdan ilk çıxan tərəfdir, yazı və xülasə yoxdur.
- Zəng webhook-ları: problemlər və həlli Hadisə gəlmir: webhook-da «Zənglər» bölməsinin hadisələrini seçin, ünvan HTTPS və açıq olsun, 4xx təkrar olmur. İmza uyğun gəlmir: xam gövdə və bu webhook-un gizli açarı. Eyni hadisə iki dəfə: təkrar göndərişdir, delivery_id ilə atın. duration_seconds null: cavab verilməyib və ya telefon jurnalı gəlməyib.