Proaktiv çatdırılma bildirişləri göndərmək üçün göndəriş izləmə API-lərindən necə istifadə etməli
İzləmə API-si ilə proaktiv çatdırılma bildirişləri göndərmək üçün hər bir bağlamanı sifarişi ilə əlaqələndirin, izləmə yeniləmələrini qəbul edin, bu yeniləmələri müştəri üçün əhəmiyyətli hadisələrə çevirin və email, SMS və ya tətbiq bildiriş xidmətiniz vasitəsilə mesajları işə salın. Daxil olan izləmə məlumatları ilə gedən mesajlar arasında etibarlı növbə və dublikat yoxlamaları yerləşdirin ki, təkrarlanan və ya gecikmiş yeniləmələr çaşdırıcı bildirişlər yaratmasın.

Bu təlimat belə bir iş axını quran tərtibatçılar və e-ticarət əməliyyatları komandaları üçündür. Məqsəd hər daşıyıcının skanını yönləndirmək deyil. Məqsəd müştərilərə nə vaxt əhəmiyyətli dəyişiklik baş verdiyini, bu dəyişikliyin nə demək olduğunu və onların hərəkət etməli olub-olmadığını bildirməkdir.
API-yə qoşulmazdan əvvəl bildiriş iş axınını layihələndirin
Bağlama izləmə API-si izləmə məlumatlarını təqdim edir; tətbiqiniz isə onlardan necə istifadə olunacağına qərar verir. Seçdiyiniz xidmət hər ikisini təqdim etsə belə, bağlamanın görünürlüğünü və müştəri ilə əlaqəni ayrı məsuliyyətlər kimi nəzərdən keçirin.
Praktik arxitektura altı mərhələdən ibarətdir:
- Sifarişlə əlaqələndirmə: tələb olunduqda izləmə nömrəsini və daşıyıcı identifikatorunu daxili bağlama qeydi ilə əlaqələndirin.
- İzləmənin qeydiyyatı: provayderin inteqrasiya tələblərinə uyğun olaraq bağlamanı göndərin və ya qeydiyyatdan keçirin.
- Yeniləmələrin qəbulu: webhook geri çağırışlarını qəbul edin, API sorğuları vasitəsilə yeniləmələri əldə edin və ya hər iki yanaşmanı birləşdirin.
- Hadisələrin emalı: daxil olan hadisələri yoxlayın, normallaşdırın, dublikatları silin və qiymətləndirin.
- Bildiriş qərarı: bildiriş göndərilib-göndərilməyəcəyini, kiminlə əlaqə saxlanacağını, hansı kanal və şablondan istifadə ediləcəyini seçin.
- Mesajın çatdırılması: bildirişi göndərin və mesajlaşma xidmətinin cavabını qeyd edin.
Müştərinin əlaqə məlumatlarını inteqrasiya həqiqətən tələb etmədikcə öz sifariş və ya mesajlaşma sisteminizdə saxlayın. İzləmə xidmətinə, adətən, tətbiqinizin izləmə hadisəsini sifarişlə əlaqələndirməsi üçün müştərinin email ünvanı lazım deyil.
1. İnteqrasiya müqaviləsini təsdiqləyin
Qəbuledicini yazmazdan əvvəl provayderin sənədlərində autentifikasiya, bağlamanın qeydiyyatı, daşıyıcının identifikasiyası, dəstəklənən yeniləmə üsulları, cavab formatları, sorğu limitləri və xətaların idarə edilməsi ilə bağlı məlumatları yoxlayın. Webhook inteqrasiyaları üçün geri çağırışların necə autentifikasiya edildiyini, hansı cavabın qəbul edilməni təsdiqlədiyini və uğursuz çatdırılmaların necə idarə olunduğunu da yoxlayın.
17TRACK tətbiqi üçün 17TRACK Tracking API səhifəsi və onun rəsmi API sənədləri ilə başlayın. İnteqrasiyanız üçün bu təlimatda nümunə kimi göstərilən sahə adlarını 17TRACK sorğu və ya cavab sahələri hesab etmək əvəzinə, sənədləşdirilmiş müqavilədən istifadə edin. Tətbiqdən əvvəl geri çağırış parametrlərini, təhlükəsizlik tələblərini və hesaba xas limitləri təsdiqləyin.
Yeniləmə üsulunu inteqrasiya müqaviləsinə uyğun seçin:
- Webhooks: dəstəklənir və infrastrukturunuza uyğundursa, geri çağırışlardan istifadə edin. Bu, provayderin yeniləmələri göndərdiyi zaman tətbiqinizə onları emal etməyə və eyni bağlamanı təkrar-təkrar sorğulamamağa imkan verir.
- Sorğulama: geri çağırışlar mövcud olmadıqda və ya uyğun gəlmədikdə, izləmə məlumatlarını cədvəl üzrə əldə edin. Cədvəli sənədləşdirilmiş sorğu limitləri daxilində saxlayın.
- Birləşdirilmiş yanaşma: normal emal üçün geri çağırışlardan, yeniləmələri köhnəlmiş görünən bağlamaları uzlaşdırmaq üçün isə seçmə API sorğularından istifadə edin; bu iş axını provayder tərəfindən dəstəklənirsə.
Webhook-lardan istifadə etdiyinizə görə müştərilərə ani bildirişlər vəd etməyin. Yuxarı mənbədəki izləmə məlumatı əlçatan olmadan tətbiqiniz daşıyıcının hadisəsini bildirə bilməz.
2. Real sifarişlərə davam gətirən bağlama qeydi yaradın
Əsas istinad kimi yalnız izləmə nömrəsindən deyil, daxili bağlama ID-sindən istifadə edin. Sifarişdə bir neçə bağlama ola bilər və izləmə nömrələrinin həmişə qlobal miqyasda unikal olduğu qəbul edilməməlidir.
Faydalı daxili qeydə aşağıdakılar daxildir:
- Daxili sifariş ID-si və bağlama ID-si.
- Məlum olduqda izləmə nömrəsi və daşıyıcı identifikatoru.
- Provayder tərəfindən təqdim edilərsə, provayderin bağlama istinadı.
- Cari normallaşdırılmış status və son əhəmiyyətli hadisə.
- Mümkün olduqda vaxt qurşağı və ya ofset daxil olmaqla daşıyıcı hadisəsinin vaxtı.
- Sisteminizin yeniləməni qəbul etdiyi vaxt.
- Müştərinin kommunikasiya seçimlərinə istinad.
- Bildiriş tarixçəsi və aktiv istisna iş axını.
Hadisənin vaxtını qəbul vaxtından ayrı saxlayın. Daha əvvəl baş vermiş skan daha yeni skandan sonra daxil ola bilər. Tətbiqiniz yalnız gəlmə sırasına əsasən çeşidləyərsə, çatdırılmış bağlamanı səhvən yenidən daşınma mərhələsinə qaytara bilər.
Bölünmüş sifarişlər üçün bildirişləri təsirlənmiş bağlama ilə əlaqələndirin. Başqa bağlama hələ yoldadırsa, “Sifarişinizdəki bir bağlama çatdırılıb” ifadəsi “Sifarişiniz çatdırılıb” ifadəsindən daha dəqiqdir.
3. İzləmə hadisələrini müştəri qərarlarına uyğunlaşdırın
Daşıyıcı təsvirləri əməliyyat məlumatlarıdır, hazır müştəri mesajları deyil. İlkin hadisəni saxlayan və eyni zamanda bildiriş qaydalarınızın anlaya biləcəyi daxili kateqoriya təyin edən normallaşdırma qatı yaradın.
Aşağıdakı kateqoriyalar təklif olunan tətbiq anlayışlarıdır, universal API status lüğəti deyil:
| Daxili kateqoriya | Bildiriş qərarı | Mesajlaşma sərhədi |
|---|---|---|
| Bağlama məlumatı qəbul edildi | Yalnız faydalıdırsa, hazırlıq yeniləməsi göndərin. | Yalnız etiketin yaradılmasına əsasən bağlamanın fiziki olaraq daşıyıcıya verildiyini bildirməyin. |
| Yoldadır | İlk əhəmiyyətli hərəkət zamanı bildiriş göndərməyi nəzərdən keçirin. | Müştərinin növbəti addımını dəyişmədikcə adi obyekt skanlarını susdurun. |
| Çatdırılma üçün çıxıb | Dəstəklənən hadisə bu statusu göstərdikdə bildiriş göndərin. | Statusu zəmanətli çatdırılma vaxtına çevirməyin. |
| Çatdırılma cəhdi və ya götürmə tələb olunur | Fəaliyyət tələb edən bildiriş göndərin. | Son tarixləri və ya götürmə təlimatlarını yalnız təsdiqləndikdə əlavə edin. |
| Çatdırılma istisnası | Səbəbi və müştərinin hərəkət etməli olub-olmadığını qiymətləndirin. | Hər istisnanı itirilmiş bağlama kimi təsvir etməyin. |
| Çatdırıldı | Bağlama səviyyəsində təsdiq göndərin. | Alıcını, çatdırılma yerini və ya çatdırılma sübutunu uydurmayın. |
Qeyri-müəyyənliyi qoruyun. Tanınmayan hadisə ən yaxın tanış kateqoriyaya zorla daxil edilmək əvəzinə yoxlama və ya alternativ yola yönləndirilməlidir. Dəstək əməkdaşlarının problemləri araşdırması üçün xam təsviri əlçatan saxlayın.
4. Yeniləmələri işi itirmədən və təkrarlamadan qəbul edin
Webhook son nöqtəniz sorğunu yoxlamalı, qəbul edilmiş yeniləməni etibarlı şəkildə saxlamalı və provayderin tələb etdiyi təsdiqi qaytarmalıdır. Geri çağırış sorğusu zamanı email və ya SMS xidməti gözləmək əvəzinə mesajların yaradılmasını asinxron yerinə yetirin.
Provayderin sənədləşdirilmiş geri çağırış yoxlama üsulunu tətbiq edin. İmza başlığı uydurmayın və hər provayderin eyni autentifikasiya sxemindən istifadə etdiyini düşünməyin. Həmçinin HTTPS, sorğu ölçüsü limitləri, faydalı yükün yoxlanılması və müvafiq giriş nəzarətlərini tətbiq edin.
Sadaləşdirilmiş emal axını belə görünür. Bunlar tətbiq səviyyəli əməliyyatlardır, işlək SDK nümunəsi deyil:
geri çağırışı qəbul et
sənədləşdirilmiş provayder mexanizmi ilə sorğunu yoxla
faydalı yükü yoxla
qəbul edilmiş faydalı yükü saxla və emalı atomik şəkildə növbəyə əlavə et
sənədləşdirilmiş təsdiqi qaytar
növbədəki yeniləməni emal et
daxili bağlamanı tap
müvafiq hadisələri normallaşdır
artıq emal edilmiş hadisələrə məhəl qoyma
xronologiyanı və vəziyyət keçidini qiymətləndir
siyasət icazə verərsə bildiriş işi yarat
vəziyyəti və işi birlikdə təsdiqlə
bildiriş işini göndər
alıcının seçimlərini və susdurma qaydalarını yoxla
mesajı mesajlaşma xidmətinə göndər
nəticəni qeyd et və yalnız uyğun olduqda yenidən cəhd etAtomik addımlar vacibdir. Tətbiqiniz status dəyişikliyini saxladıqdan sonra bildiriş işi yaratmazdan əvvəl çökərsə, müştəri heç vaxt xəbərdarlıq almaya bilər. Tranzaksiyalı outbox bir seçimdir: status dəyişikliyini və gözləyən işi eyni verilənlər bazası tranzaksiyasında saxlayın, sonra işçi işə göndərsin.
Naməlum bağlama istinadlarını açıq şəkildə idarə edin. Hansı müştərinin bildiriş almalı olduğunu təxmin etmək əvəzinə onları araşdırma və ya uzlaşdırma üçün karantinə alın.
5. Dublikatlardan qorunma və xronoloji yoxlamalar əlavə edin
Qəbuledicini təkrarlanan geri çağırışlara və işçi təkrar cəhdlərinə dözümlü layihələndirin. Sənədləşdirildikdə sabit provayder hadisə identifikatoruna üstünlük verin. Əks halda daxili bağlama ID-si, hadisə kodu, hadisə vaxtı və yer kimi uyğun sahələrdən deterministik hadisə barmaq izi yaradın. Ona güvənməzdən əvvəl bu barmaq izini real faydalı yüklərlə sınaqdan keçirin.
Hadisələrin dublikatlarının silinməsi və bildirişlərin susdurulması fərqli problemləri həll edir. Dublikatların silinməsi eyni hadisənin iki dəfə emal edilməsinin qarşısını alır. Susdurma bir neçə fərqli skanın mahiyyətcə eyni müştəri mesajını yaratmasının qarşısını alır.
Bildiriş identikliyini biznes hadisəsi ətrafında müəyyən edin. Çatdırılma təsdiqində bağlama ID-si və çatdırılma mərhələsindən istifadə edilə bilər. Çatdırılma cəhdində isə cəhdə xas identiklik lazım ola bilər, çünki sonrakı cəhd həqiqətən yeni hadisə ola bilər.
Sırasız yeniləmələr üçün hadisə vaxtlarını müqayisə edin və icazə verilən vəziyyət keçidlərini qiymətləndirin. Geri çağırışın yalnız yeni skanı ehtiva etdiyini düşünməyin; onun sənədləşdirilmiş strukturunun fərdi hadisəni, anlıq görüntünü və ya tarixçəni əks etdirib-etdirmədiyini yoxlayın. Ziddiyyətli yeniləmələri bütün düzəlişləri səssizcə silmək əvəzinə uzlaşdırmaya yönləndirin.
6. Növbəti mərhələni izah edən mesajlar yazın
Hər bildirişdə müvafiq bağlama, təsdiqlənmiş dəyişiklik və müştərinin növbəti addımı göstərilməlidir. Təhlükəsiz izləmə linki və tanınan sifariş istinadı əlavə edin. SMS mesajlarında və kilid ekranı önizləmələrində tam ünvanları və lazımsız şəxsi məlumatları göstərməkdən çəkinin.
Məsələn:
- Çatdırılma üçün çıxıb: “{order_reference} sifarişi üzrə bağlamanız çatdırılma üçün çıxıb. Gedişatı burada izləyin: {tracking_link}.”
- Çatdırılma cəhdi: “Daşıyıcı bağlamanız üçün çatdırılma cəhdi barədə məlumat verdi. Mövcud növbəti addımları izləmə səhifəsində yoxlayın: {tracking_link}.”
- Çatdırıldı: “Daşıyıcı {order_reference} sifarişi üzrə bağlamanızı çatdırılmış kimi qeyd edib. Mövcud çatdırılma detallarına baxın: {tracking_link}.”
Yerlər tutucularını yalnız yoxlanılmış məlumatlardan istifadə etməklə göstərin. Çatdırılma təxmini mövcuddursa və göstərilməsi uyğundursa, onu təxmin kimi qeyd edin. Yoxdursa, tarix uydurmaq əvəzinə onu çıxarın.
İstisnalar zamanı bağlama problemini müştərinin görməli olduğu işdən ayırın. Problem yalnız izah tələb edə bilər; təsdiqlənmiş ünvan problemi isə hərəkət tələb edə bilər. Yalnız etibarsız sərbəst mətnli izləmə məzmununa əsasən müştəriləri ödəniş və ya sənəd yükləmə səhifəsinə yönləndirməyin.
Kanal seçərkən müştəri seçimlərini, kanal icazələrini, təcililiyi və tətbiq olunan qaydaları nəzərə alın. İstifadə etdiyiniz yurisdiksiyalar və mesajlaşma kanalları üzrə razılıq, imtina və sakit saat tələblərini yoxlayın. Çatdırılma xidməti bildirişlərini reklam kampaniyalarından ayrı saxlayın və eyni icazələrin hər ikisini əhatə etdiyini düşünməyin.
7. İzləmə sakitləşdikdə nə baş verdiyini müəyyənləşdirin
Proaktiv kommunikasiya yeni hadisələrlə yanaşı, irəliləyişin olmamasını da əhatə etməlidir, lakin təkcə səssizlik bağlamanın gecikdiyini və ya itdiyini sübut etmir.
Xidmət səviyyəsi, marşrut, son əhəmiyyətli hadisə və dəstəklənən çatdırılma təxminindən istifadə edən köhnəlmiş izləmə qaydası yaradın. Hər bağlama üçün vahid gözləmə müddəti tətbiq etmək əvəzinə, hədləri əməliyyat məlumatlarınız və dəstək prosesiniz əsasında müəyyən edin.
Qayda işə düşdükdə buraxılmış emalı yoxlayın, dəstəklənirsə izləmə mənbəyi ilə uzlaşdırın və daxili dəstək tapşırığı açılıb-açılmayacağına qərar verin. Müştəriyə bildiriş göndərirsinizsə, bildiyiniz faktları əks etdirən ifadələrdən istifadə edin: “Yeni izləmə yeniləməsi almamışıq” ifadəsi “Bağlamanız itib” ifadəsindən fərqlidir.
Həll olunmamış istisnalar üçün məsul şəxs təyin edin. Problemi həll etmək üçün yol yaratmadan dəfələrlə problem elan edən bildiriş sistemi müştəri narazılığını artıra bilər.
8. Avtomatik göndərişləri aktivləşdirməzdən əvvəl tam yolu sınaqdan keçirin
Əvvəlcə iş axınını müşahidə rejimində işə salın: real və ya təsdiqlənmiş test hadisələrini qəbul edin, təklif olunan bildirişlər yaradın və müştərilərlə əlaqə saxlamadan nəticələri yoxlayın.
- Eyni geri çağırışı təkrar edin və əlavə mesaj yaratmadığını təsdiqləyin.
- Çatdırılma hadisəsindən sonra daha köhnə daşınma hadisəsini emal edin və nəticə vəziyyətini yoxlayın.
- Çatışmayan vaxt nişanlarını, naməlum statusları və səhv formatlı faydalı yükləri sınaqdan keçirin.
- Təsdiqdən əvvəl verilənlər bazası xətasını və saxlamadan sonra işçi xətasını simulyasiya edin.
- Mesajlaşma vaxt aşımını, xidmətin mesajı artıq qəbul etmiş ola biləcəyi qeyri-müəyyən cavablar da daxil olmaqla, sınaqdan keçirin.
- Bölünmüş bağlamaların bağlamaya xas ifadələr yaratdığını təsdiqləyin.
- İmtina etmiş alıcıları, etibarsız əlaqə məlumatlarını və sakit saatların idarə edilməsini yoxlayın.
- İzləmə linklərinin başqa müştərinin sifariş məlumatlarını açıqlamadığını təsdiqləyin.
Qəbul edilmiş geri çağırışları, emal xətalarını, növbənin yaşını, bildiriş işlərini, dublikatların susdurulmasını və mesajlaşma nəticələrini izləyin. Emal gecikməsini daşıyıcı hadisəsinin yaşından ayrı olaraq sisteminizin qəbul vaxtından ölçün. Bu fərq yavaş bildirişin yuxarı mənbədə məlumatın əlçatan olmamasından, yoxsa öz boru xəttinizdən qaynaqlandığını müəyyən etməyə kömək edir.
Yaxşı başa düşülən az sayda mərhələ ilə başlayın. Qaydaları yalnız dəstək və əməliyyat komandaları mesajların dəqiq, faydalı və qəbul edilməyə dəyər olduğu ilə razılaşdıqdan sonra genişləndirin.
Tez-tez verilən suallar
Bağlama izləmə API-si avtomatik olaraq email və ya SMS göndərir?
Mütləq deyil. İzləmə məlumatlarına çıxış və müştəri mesajlaşması ayrı imkanlardır. Xidmətin sənədləşdirilmiş əhatə dairəsini yoxlayın. Xüsusi inteqrasiyada tətbiqiniz izləmə yeniləmələrini emal edə və ayrıca mesajlaşma xidməti vasitəsilə bildirişlər göndərə bilər.
Müştərilərə hər izləmə skanı barədə bildiriş göndərməliyəm?
Adətən yox. Əhəmiyyətli mərhələlərə və hərəkət tələb edən hadisələrə üstünlük verin. Bir neçə obyekt skanı müştərinin bilməli olduğu şeyi dəyişmədən normal daşınmanı göstərə bilər. Ətraflı tarixçəni izləmə səhifəsində saxlayın.
Çatdırılma bildirişlərini real vaxtda təmin edə bilərəm?
Sisteminiz yeniləməni qəbul etdikdən sonra emal hədəfi təyin edə və onu izləyə bilərsiniz. Daşıyıcının skanı nə vaxt qeyd edəcəyinə və ya dərc edəcəyinə zəmanət verə bilməzsiniz. Xidməti bu asılılığı əks etdirən ifadələrlə təsvir edin.
Dublikat çatdırılma mesajlarının qarşısını necə ala bilərəm?
Davamlı hadisə dublikatlaşdırmasından, hər biznes mərhələsi üçün ayrıca bildiriş identikliyindən və tranzaksiyalı iş yaradılmasından istifadə edin. Mesajlaşma xidmətiniz idempotentliyi dəstəkləyirsə, onu əlavə qoruma kimi tətbiq edin. Yalnız yaddaşdaxili dublikat yoxlaması yenidən başladılmalara və ya bir neçə işçiyə davam gətirməyəcək.
Daşıyıcı çatdırılmış statusunu düzəldərsə nə baş verməlidir?
Hər iki hadisəni qoruyun və bağlamanın vəziyyətini uzlaşdırın. Düzəliş müştəriyə əhəmiyyətli təsir edirsə, siyasətinizə uyğun olaraq aydın düzəliş göndərin və ya dəstəyə yönləndirin. Kodu sadələşdirmək üçün çatdırılmış statusu həmişəlik geri dönməz etməyin.
Mənbələr
Aşağıdakı rəsmi resurslar yuxarıda müzakirə edilən 17TRACK inteqrasiyası üçün tətbiq istinadlarıdır. Bu təlimatdakı daxili sxem, bildiriş qaydaları və emal axını sitat gətirilmiş API müqavilələri deyil, arxitektura tövsiyələridir.
- 17TRACK Tracking API — API inteqrasiyasını qiymətləndirmək üçün rəsmi başlanğıc nöqtəsi.
- 17TRACK API documentation — provayderə xas sorğu formatları, autentifikasiya, izləmə əməliyyatları və inteqrasiya tələbləri üçün istinad.


