Skip to main content
Faqja kryesoreBlogUdhëzuesSi të përdorni API-të e gjurmimit të dërgesave për të dërguar njoftime proaktive për dorëzimin

Si të përdorni API-të e gjurmimit të dërgesave për të dërguar njoftime proaktive për dorëzimin

17TRACK

Për të dërguar njoftime proaktive për dorëzimin me një API për gjurmimin e dërgesave, lidhni çdo paketë me porosinë e saj, merrni përditësimet e gjurmimit, përkthejini ato përditësime në ngjarje të rëndësishme për klientin dhe aktivizoni mesazhet përmes shërbimit tuaj të email-it, SMS-ve ose njoftimeve në aplikacion. Vendosni një radhë të qëndrueshme dhe kontrolle për dublikatat midis të dhënave hyrëse të gjurmimit dhe mesazheve dalëse, në mënyrë që përditësimet e përsëritura ose të vonuara të mos prodhojnë sinjalizime konfuze.

Si të përdorni API-të e gjurmimit të dërgesave për të dërguar njoftime proaktive për dorëzimin

Ky udhëzues është për zhvilluesit dhe ekipet e operacioneve të tregtisë elektronike që ndërtojnë këtë rrjedhë pune. Qëllimi nuk është të përcillni çdo skanim të transportuesit. Është t'u tregoni klientëve kur ndryshon diçka me rëndësi, çfarë nënkupton ai ndryshim dhe nëse duhet të veprojnë.

Dizenjoni rrjedhën e punës së njoftimeve përpara se të lidhni API-në

Një API për gjurmimin e dërgesave ofron informacion gjurmimi; aplikacioni juaj vendos se si ta përdorë atë. Trajtojini dukshmërinë e dërgesës dhe komunikimin me klientin si përgjegjësi të ndara, edhe nëse shërbimi i zgjedhur i ofron të dyja.

Një arkitekturë praktike ka gjashtë faza:

  1. Lidhja me porosinë: lidhni numrin e gjurmimit dhe identifikuesin e transportuesit, kur kërkohet, me një regjistrim të brendshëm të dërgesës.
  2. Regjistrimi i gjurmimit: dërgojeni ose regjistrojeni dërgesën sipas kërkesave të integrimit të ofruesit.
  3. Marrja e përditësimeve: merrni përgjigje webhook, merrni përditësime përmes kërkesave API ose kombinoni të dyja qasjet.
  4. Përpunimi i ngjarjeve: vlerësoni, normalizoni, eliminoni dublikatat dhe shqyrtoni ngjarjet hyrëse.
  5. Vendimi për njoftimin: zgjidhni nëse duhet të njoftoni, kë të kontaktoni dhe cilin kanal e shabllon të përdorni.
  6. Dorëzimi i mesazhit: dërgoni njoftimin dhe regjistroni përgjigjen e shërbimit të mesazheve.

Mbajini të dhënat e kontaktit të klientit në sistemin tuaj të porosive ose të mesazheve, përveç rasteve kur integrimi kërkon vërtet ndarjen e tyre. Një shërbim gjurmimi zakonisht nuk ka nevojë për adresën e email-it të klientit vetëm që aplikacioni juaj të lidhë një ngjarje gjurmimi me një porosi.

1. Konfirmoni kontratën e integrimit

Përpara se të shkruani marrësin, kontrolloni dokumentacionin e ofruesit për autentikimin, regjistrimin e dërgesës, identifikimin e transportuesit, metodat e mbështetura të përditësimit, formatet e përgjigjeve, kufijtë e kërkesave dhe trajtimin e gabimeve. Për integrimet webhook, kontrolloni gjithashtu se si autentikohen përgjigjet, cila përgjigje konfirmon marrjen dhe si trajtohen dërgesat e pasuksesshme.

Për një implementim të 17TRACK, filloni me faqen e API-së së gjurmimit 17TRACK dhe dokumentacionin zyrtar të API-së. Përdorni kontratën e dokumentuar për integrimin tuaj, në vend që t'i trajtoni emrat ilustrues të fushave në këtë udhëzues si fusha kërkesash ose përgjigjesh të 17TRACK. Konfirmoni konfigurimin e përgjigjeve, kërkesat e sigurisë dhe kufijtë specifikë të llogarisë përpara implementimit.

Zgjidhni metodën e përditësimit sipas kontratës së integrimit:

  • Webhook-et: përdorni përgjigjet kur mbështeten dhe janë të përshtatshme për infrastrukturën tuaj. Ato i lejojnë aplikacionit tuaj të përpunojë përditësimet kur ofruesi i dërgon, pa kërkuar vazhdimisht të njëjtën dërgesë.
  • Polling-u: merrni informacionin e gjurmimit sipas një orari kur përgjigjet nuk janë të disponueshme ose nuk janë të përshtatshme. Mbajeni orarin brenda kufijve të dokumentuar të kërkesave.
  • Qasja e kombinuar: përdorni përgjigjet për përpunimin normal dhe marrjen selektive përmes API-së për të rakorduar dërgesat, përditësimet e të cilave duken të vjetruara, nëse ofruesi e mbështet këtë rrjedhë pune.

Mos u premtoni klientëve njoftime të menjëhershme vetëm sepse përdorni webhook-e. Aplikacioni juaj nuk mund të raportojë një ngjarje të transportuesit përpara se të dhënat hyrëse të gjurmimit ta bëjnë atë të disponueshme.

2. Ndërtoni një regjistrim dërgese që i përballon porositë reale

Përdorni një ID të brendshme të dërgesës si referencë kryesore, jo vetëm numrin e gjurmimit. Një porosi mund të përmbajë disa paketa dhe nuk duhet të supozoni se numrat e gjurmimit do të jenë gjithmonë unikë në nivel global.

Një regjistrim i dobishëm i brendshëm përfshin:

  • ID-në e brendshme të porosisë dhe ID-në e dërgesës.
  • Numrin e gjurmimit dhe identifikuesin e transportuesit, kur dihen.
  • Referencën e dërgesës së ofruesit, nëse jepet.
  • Statusin aktual të normalizuar dhe ngjarjen më të fundit me rëndësi.
  • Orën e ngjarjes së transportuesit, duke përfshirë zonën kohore ose zhvendosjen kur është e disponueshme.
  • Orën kur sistemi juaj mori përditësimin.
  • Një referencë për preferencat e komunikimit të klientit.
  • Historikun e njoftimeve dhe çdo rrjedhë aktive pune për përjashtimet.

Ruajeni veçmas orën e ngjarjes nga ora e marrjes. Një skanim që ka ndodhur më herët mund të mbërrijë pas një skanimi më të ri. Nëse aplikacioni juaj rendit vetëm sipas radhës së mbërritjes, mund ta ndryshojë gabimisht një dërgesë të dorëzuar përsëri në transport.

Për porositë e ndara, lidhini njoftimet me paketën e prekur. “Një paketë nga porosia juaj ka mbërritur” është më e saktë se “Porosia juaj ka mbërritur” kur një paketë tjetër është ende në lëvizje.

3. Hartëzoni ngjarjet e gjurmimit me vendimet e klientit

Përshkrimet e transportuesit janë të dhëna operacionale, jo mesazhe të gatshme për klientët. Ndërtoni një shtresë normalizimi që ruan ngjarjen origjinale, ndërsa i cakton asaj një kategori të brendshme që rregullat e njoftimeve mund ta kuptojnë.

Kategoritë e mëposhtme janë koncepte të sugjeruara për aplikacionin, jo një fjalor universal statusesh API:

Kategoria e brendshmeVendimi për njoftiminKufiri i mesazhit
Informacioni i dërgesës u morDërgoni një përditësim për përgatitjen vetëm nëse është i dobishëm.Mos nënkuptoni posedim fizik nga transportuesi vetëm nga krijimi i etiketës.
Në transportMerrni parasysh njoftimin në lëvizjen e parë me rëndësi.Filtroni skanimet rutinë të objekteve, përveç rasteve kur ndryshojnë hapin e ardhshëm të klientit.
Në dalje për dorëzimNjoftoni kur një ngjarje e mbështetur tregon këtë status.Mos e shndërroni statusin në një orar të garantuar mbërritjeje.
Tentativë dorëzimi ose kërkohet tërheqjaDërgoni një njoftim që kërkon veprim.Përfshini afate ose udhëzime tërheqjeje vetëm kur janë verifikuar.
Përjashtim në dorëzimVlerësoni shkakun dhe nëse klienti duhet të veprojë.Mos e përshkruani çdo përjashtim si parcelë të humbur.
DorëzuarDërgoni një konfirmim në nivel pakete.Mos shpikni marrësin, vendndodhjen e dorëzimit ose dëshminë e dorëzimit.

Ruajeni pasigurinë. Një ngjarje e panjohur duhet të kalojë në një rrugë shqyrtimi ose rezervë, në vend që të detyrohet në kategorinë më të afërt të njohur. Mbajeni përshkrimin e papërpunuar të disponueshëm për stafin mbështetës për zgjidhjen e problemeve.

4. Merrni përditësimet pa humbur ose dubluar punën

Endpoint-i juaj webhook duhet të vërtetojë kërkesën, të ruajë në mënyrë të qëndrueshme përditësimin e pranuar dhe të kthejë konfirmimin e kërkuar nga ofruesi. Kryeni gjenerimin e mesazheve në mënyrë asinkrone, në vend që të prisni një shërbim email-i ose SMS-sh gjatë kërkesës së përgjigjes.

Implementoni metodën e dokumentuar të ofruesit për verifikimin e përgjigjeve. Mos shpikni një kokë nënshkrimi dhe mos supozoni se çdo ofrues përdor të njëjtën skemë autentikimi. Zbatoni gjithashtu HTTPS, kufijtë e madhësisë së kërkesës, vërtetimin e ngarkesës dhe kontrollet e përshtatshme të aksesit.

Një rrjedhë e thjeshtuar përpunimi duket kështu. Këto janë operacione në nivel aplikacioni, jo një shembull funksional SDK-je:

merr përgjigjen
  verifiko kërkesën duke përdorur mekanizmin e dokumentuar të ofruesit
  vërteto ngarkesën
  ruaj ngarkesën e pranuar dhe vendose në radhën e përpunimit në mënyrë atomike
  kthe konfirmimin e dokumentuar

përpuno përditësimin në radhë
  gjej dërgesën e brendshme
  normalizo ngjarjet përkatëse
  shpërfill ngjarjet e përpunuara tashmë
  vlerëso kronologjinë dhe kalimin e statusit
  krijo punën e njoftimit nëse politika e lejon
  kryej së bashku statusin dhe punën

dërgo punën e njoftimit
  kontrollo preferencat e marrësit dhe rregullat e filtrimit
  dërgo mesazhin te shërbimi i mesazheve
  regjistro rezultatin dhe provo përsëri vetëm kur është e përshtatshme

Hapat atomikë kanë rëndësi. Nëse aplikacioni juaj ruan një ndryshim statusi, por rrëzohet përpara krijimit të punës së njoftimit, klienti mund të mos e marrë kurrë sinjalizimin. Një outbox transaksional është një mundësi dizajni: ruani ndryshimin e statusit dhe punën në pritje në të njëjtin transaksion të bazës së të dhënave, pastaj lejoni një punonjës ta dërgojë punën.

Trajtojini në mënyrë të qartë referencat e panjohura të dërgesave. Vendosini në karantinë për hetim ose rakordim, në vend që të hamendësoni se cili klient duhet të marrë njoftimin.

5. Shtoni mbrojtjen nga dublikatat dhe kontrollet kronologjike

Dizenjoni marrësin që të tolerojë përgjigjet e përsëritura dhe riprovimet e punonjësve. Preferoni një identifikues të qëndrueshëm të ngjarjes nga ofruesi, kur është i dokumentuar. Përndryshe, krijoni një gjurmë deterministe të ngjarjes nga fusha të përshtatshme, si ID-ja e brendshme e dërgesës, kodi i ngjarjes, ora e ngjarjes dhe vendndodhja. Testojeni atë gjurmë kundrejt ngarkesave reale përpara se të mbështeteni tek ajo.

Eliminimi i dublikatave të ngjarjeve dhe filtrimi i njoftimeve zgjidhin probleme të ndryshme. Eliminimi i dublikatave ndalon përpunimin dy herë të së njëjtës ngjarje. Filtrimi parandalon që disa skanime të ndryshme të gjenerojnë në thelb të njëjtin mesazh për klientin.

Përcaktoni identitetin e njoftimit rreth ngjarjes së biznesit. Një konfirmim dorëzimi mund të përdorë ID-në e dërgesës dhe momentin e dorëzimit. Një tentativë dorëzimi mund të ketë nevojë për një identitet specifik të tentativës, sepse një tentativë e mëvonshme mund të jetë një ngjarje vërtet e re.

Për përditësimet jashtë rendit, krahasoni vulat kohore të ngjarjeve dhe vlerësoni kalimet e lejuara të statusit. Mos supozoni se një përgjigje përmban vetëm një skanim të ri; kontrolloni nëse struktura e dokumentuar përfaqëson një ngjarje individuale, një pamje të momentit ose një histori. Drejtojini përditësimet kontradiktore te rakordimi, në vend që të hidhni në heshtje të gjitha korrigjimet.

6. Shkruani mesazhe që shpjegojnë çfarë ndodh më pas

Çdo njoftim duhet të shënojë paketën përkatëse, ndryshimin e konfirmuar dhe hapin e ardhshëm të klientit. Përfshini një lidhje të sigurt gjurmimi dhe një referencë të dallueshme të porosisë. Shmangni ekspozimin e adresave të plota ose të dhënave personale të panevojshme në mesazhet SMS dhe pamjet paraprake në ekranin e kyçur.

Për shembull:

  • Në dalje për dorëzim: “Paketa juaj për porosinë {order_reference} është në dalje për dorëzim. Ndiqni përparimin e saj këtu: {tracking_link}.”
  • Tentativë dorëzimi: “Transportuesi raportoi një tentativë dorëzimi për paketën tuaj. Kontrolloni faqen e gjurmimit për hapat e ardhshëm të disponueshëm: {tracking_link}.”
  • Dorëzuar: “Transportuesi e shënoi paketën tuaj për porosinë {order_reference} si të dorëzuar. Shikoni detajet e disponueshme të dorëzimit: {tracking_link}.”

Shfaqini vendmbajtësit vetëm nga të dhëna të vërtetuara. Nëse një vlerësim dorëzimi është i disponueshëm dhe i përshtatshëm për t'u shfaqur, etiketojeni si vlerësim. Nëse mungon, hiqeni në vend që të shpikni një datë.

Për përjashtimet, dalloni problemin e dërgesës nga detyra e klientit. Një ndërprerje mund të kërkojë vetëm shpjegim; një problem i verifikuar me adresën mund të kërkojë veprim. Mos i drejtoni klientët te një faqe pagese ose ngarkimi dokumentesh vetëm bazuar në përmbajtje të pabesueshme të gjurmimit në tekst të lirë.

Zgjidhni kanalet duke përdorur preferencat e klientit, lejet e kanalit, urgjencën dhe rregullat në fuqi. Shqyrtoni kërkesat për pëlqimin, çregjistrimin dhe oraret e qeta për juridiksionet dhe kanalet e mesazheve që përdorni. Mbajini njoftimet e shërbimit të dorëzimit të ndara nga fushatat promocionale, në vend që të supozoni se të njëjtat leje i mbulojnë të dyja.

7. Përcaktoni çfarë ndodh kur gjurmimi hesht

Komunikimi proaktiv duhet të mbulojë mungesën e përparimit, si edhe ngjarjet e reja, por vetëm heshtja nuk dëshmon se një dërgesë është vonuar ose humbur.

Krijoni një rregull për gjurmimin e vjetërsuar duke përdorur nivelin e shërbimit, itinerarin, ngjarjen e fundit me rëndësi dhe çdo vlerësim të mbështetur të dorëzimit. Përcaktoni pragjet nga të dhënat tuaja operacionale dhe procesi i mbështetjes, në vend që të zbatoni një periudhë universale pritjeje për çdo dërgesë.

Kur ai rregull aktivizohet, kontrolloni për përpunim të humbur, rakordoni me burimin e gjurmimit kur mbështetet dhe vendosni nëse duhet të hapni një detyrë të brendshme mbështetjeje. Nëse njoftoni klientin, përdorni formulim që pasqyron atë që dini: “Nuk kemi marrë një përditësim të ri gjurmimi” ndryshon nga “Paketa juaj ka humbur.”

Caktoni një përgjegjës për përjashtimet e pazgjidhura. Një sistem njoftimesh që njofton vazhdimisht për një problem pa krijuar një rrugë drejt zgjidhjes mund të rrisë zhgënjimin e klientit.

8. Testoni rrugën e plotë përpara se të aktivizoni dërgimet automatike

Fillimisht ekzekutojeni rrjedhën e punës në modalitet hije: merrni ngjarje reale ose testuese të miratuara, gjeneroni njoftime të propozuara dhe shqyrtoni rezultatet pa kontaktuar klientët.

  • Riluani një përgjigje identike dhe konfirmoni se nuk krijon një mesazh tjetër.
  • Përpunoni një ngjarje më të vjetër transporti pas një ngjarjeje dorëzimi dhe shqyrtoni statusin që rezulton.
  • Testoni vulat kohore që mungojnë, statuset e panjohura dhe ngarkesat e keqformuara.
  • Simuloni një dështim të bazës së të dhënave përpara konfirmimit dhe një dështim të punonjësit pas ruajtjes.
  • Testoni afatet e skaduara të mesazheve, duke përfshirë një përgjigje të pasigurt ku shërbimi mund ta ketë pranuar tashmë mesazhin.
  • Konfirmoni që dërgesat e ndara prodhojnë formulime specifike për paketën.
  • Kontrolloni marrësit e çregjistruar, të dhënat e pavlefshme të kontaktit dhe trajtimin e orareve të qeta.
  • Verifikoni që lidhjet e gjurmimit të mos ekspozojnë informacionin e porosisë së një klienti tjetër.

Monitoroni përgjigjet e pranuara, dështimet e përpunimit, moshën e radhës, punët e njoftimeve, filtrimin e dublikatave dhe rezultatet e mesazheve. Matni vonesën e përpunimit nga ora e marrjes nga sistemi juaj veçmas nga vjetërsia e ngjarjes së transportuesit. Ky dallim ndihmon në identifikimin nëse një njoftim i ngadaltë erdhi nga disponueshmëria e të dhënave në burim apo nga tubacioni juaj.

Filloni me një grup të vogël momentesh të kuptuara mirë. Zgjeroni rregullat vetëm pasi ekipet e mbështetjes dhe operacioneve të bien dakord se mesazhet janë të sakta, të zbatueshme dhe ia vlejnë të merren.

Pyetje të shpeshta

A dërgon automatikisht një API për gjurmimin e dërgesave email-e ose SMS?

Jo domosdoshmërisht. Aksesi te të dhënat e gjurmimit dhe mesazhet për klientët janë aftësi të ndara. Kontrolloni fushëveprimin e dokumentuar të shërbimit. Në një integrim të personalizuar, aplikacioni juaj mund të përpunojë përditësimet e gjurmimit dhe të dërgojë njoftime përmes një shërbimi të veçantë mesazhesh.

A duhet t'i njoftoj klientët për çdo skanim gjurmimi?

Zakonisht jo. Përparësi kanë momentet me rëndësi dhe ngjarjet që kërkojnë veprim. Disa skanime të objekteve mund të përfaqësojnë transport normal pa ndryshuar atë që klienti duhet të dijë. Mbajeni historikun e detajuar në faqen e gjurmimit.

A mund të garantoj njoftime në kohë reale për dorëzimin?

Mund të përcaktoni dhe monitoroni një objektiv përpunimi pasi sistemi juaj të marrë një përditësim. Nuk mund të garantoni se kur transportuesi do të regjistrojë ose publikojë një skanim. Përshkruajeni shërbimin me terma që pasqyrojnë këtë varësi.

Si mund të parandaloj mesazhet e dyfishta për dorëzimin?

Përdorni eliminim të qëndrueshëm të dublikatave të ngjarjeve, një identitet të veçantë njoftimi për çdo moment biznesi dhe krijim transaksional të punës. Kur shërbimi juaj i mesazheve mbështet idempotencën, përdoreni si një masë tjetër mbrojtëse. Një kontroll i dublikatave vetëm në memorie nuk do t'u mbijetojë rinisjeve ose punonjësve të shumtë.

Çfarë duhet të ndodhë nëse transportuesi korrigjon një status të dorëzuar?

Ruajini të dyja ngjarjet dhe rakordoni statusin e dërgesës. Nëse korrigjimi ndikon materialisht te klienti, dërgoni një korrigjim të qartë ose drejtojeni te mbështetja sipas politikës suaj. Mos e bëni statusin e dorëzuar përgjithmonë të pakthyeshëm vetëm për ta thjeshtuar kodin.

Burimet

Burimet zyrtare të mëposhtme janë referencat e implementimit për integrimin me 17TRACK të diskutuar më sipër. Skema e brendshme, rregullat e njoftimeve dhe rrjedha e përpunimit në këtë udhëzues janë rekomandime arkitekturore, jo kontrata API të cituara.