Mipangilio ya duka

Ninawezaje kuweka webhooks za kutuma matukio ya oda na vipindi kwa API au barua pepe?

Tengeneza na simamia webhooks za duka kwenye Settings: chagua API au E-mail, chagua tukio la session-created, order-created, au order-updated, tumia URL za {{placeholder}}, na ujifunze kikomo cha 20, backoff ya kujaribu tena, na barua pepe ya hitilafu baada ya kushindwa mara 5 mfululizo.

Webhooks hufanya nini

Webhook hujiandikisha kwa tukio mahususi la duka. Tukio hilo linapotokea, Storeep hutuma mara moja data ya tukio kwa URL unayobainisha (aina ya API) au kwa anwani ya barua pepe unayobainisha (aina ya E-mail). Webhooks hutumika sana kwa miunganisho ya ufuatiliaji wa oda, ulinganishaji wa CRM, ubadilishaji wa majukwaa ya matangazo, na arifa za kiotomatiki.

Kusimamia webhooks, nenda Settings → Webhooks. Unahitaji ruhusa ya settings ili kuona au kubadilisha webhooks.

Vikomo vya webhook

Kiwango cha juu ni webhooks 20 kwa kila duka. Kujaribu kuongeza ya 21 hurudisha hitilafu "You have reached the maximum of 20 webhooks per store".
Orodha huonyesha webhooks mpya kwanza, zikigawanywa kwa kurasa 40 kwa ukurasa.

Kutengeneza webhook

Bofya Add new webhook, jaza sehemu zilizo hapa chini, kisha bofya Add.

Activate

Imechaguliwa kwa chaguomsingi. Ikiwa imechaguliwa, webhook inafanya kazi mara unapoihifadhi na matukio yanayolingana hutumwa. Iondoe alama ili kuhifadhi webhook katika hali iliyozimwa isiyopokea chochote. Unaweza kubadilisha hili wakati wowote kwa kuhariri webhook.

Name

Inahitajika. Kiwango cha juu ni herufi 50.
Lebo ya maelezo inayoonyeshwa kwenye orodha, kwa mfano Facebook CAPI order created.

Type

API: Storeep hutuma ombi la HTTP POST lenye data ya tukio kwa URL yako.
E-mail: Storeep hutuma barua pepe yenye data ya tukio kwa anwani yako.

Event

Tukio la duka linalochochea webhook. Kuna matukio matatu:

Session created: kipindi kipya cha mgeni kinatengenezwa kwenye duka lako.
Order created: oda mpya inawekwa.
Order updated: hali au data ya oda iliyopo inabadilika.

Muhimu: aina ya E-mail hutoa Order created na Order updated pekee. Ukichagua E-mail na Session created, webhook huhifadhiwa lakini haitumii chochote kamwe. Tumia aina ya API ikiwa unahitaji tukio la kipindi.

Format

Chaguo moja tu, Json: mzigo hutumwa kama hati ya JSON.

URL (aina ya API pekee)

Inahitajika wakati aina ni API. Kiwango cha juu ni herufi 500.
Sehemu huonyesha kiambishi awali cha https:// kwa ajili yako, hivyo weka mwenyeji na njia pekee, kwa mfano api.example.com/events/order. Ukibandika anwani kamili ya https:// au http://, kiambishi awali huondolewa kabla ya kuhifadhi.
Vibandiko vinavyobadilika: ingiza sehemu yoyote kutoka data ya tukio ndani ya URL kwa sintaksia ya mabano mawili {{field_name}}. Mfano: example.com/postback?cid={{fbclid}}&payout={{order_total}}. Thamani huwekewa msimbo wa URL, na kibandiko ambacho sehemu yake haipo hutatuliwa kuwa thamani tupu. Hii hukuruhusu kutuma data ya ubadilishaji moja kwa moja kwa jukwaa la matangazo bila proksi.
Anwani huthibitishwa baada ya vibandiko kuondolewa, hivyo URL isiyo sahihi hurudisha "The url you have entered is incorrect".

Anwani ya barua pepe (aina ya E-mail pekee)

Inahitajika wakati aina ni E-mail. Lazima iwe anwani halali, kiwango cha juu cha herufi 127.

Kuhariri webhook

Bofya safu yoyote ili kufungua kihariri. Kila sehemu inaweza kuhaririwa. Sehemu ya URL hujazwa awali pekee wakati aina iliyohifadhiwa ni API, na sehemu ya barua pepe hujazwa awali pekee wakati aina iliyohifadhiwa ni E-mail. Bofya Save ili kutumia. Kuhifadhi huku Activate haijachaguliwa huzima webhook bila kuifuta.

Safu wima za orodha ya webhooks

Name: lebo pamoja na tarehe yake ya kutengeneza.
URL / E-mail: marudio.
Type: API au E-mail.
Event: Session created, Order created, au Order updated.
Format: Json.
Status: Activated au Deactivated.

Kufuta webhook

Chagua safu moja au zaidi kisha bofya Delete webhooks. Ufutaji ni wa kudumu na husimamisha utumaji wote wa baadaye kwa usajili huo.

Utumaji, kujaribu tena, na barua pepe za hitilafu

Sehemu hii inahusu webhooks za API. Webhooks za E-mail ni za kutuma na kusahau: hutumwa mara moja bila kujaribu tena na bila kufuatilia hitilafu.

Tabia ya kujaribu tena

Kila ombi lina muda wa kuisha wa sekunde 5. Ikiwa lengo hurudisha hitilafu ya 5xx, 429 (kikomo cha kiwango), au haliwezi kufikiwa (hitilafu ya muunganisho), utumaji huchukuliwa kama kushindwa kwa muda na kujaribiwa tena.
Baada ya utumaji wa kwanza kushindwa, Storeep hujaribu tena kwa backoff ya kielelezo hadi majaribio 5: takriban 30s, 60s, 120s, 240s, kisha 480s baadaye. Baada ya jaribio la mwisho tukio huachwa.
Jibu la 4xx lisilo 429 (kwa mfano 404 au 403) huchukuliwa kama kushindwa kwa kudumu. Storeep haijaribu tena, kwa sababu mwisho usio sahihi au unaokataa hautajirekebisha wenyewe.
Unapokuwa na webhooks kadhaa kwenye tukio lilelile, jaribio tena hutuma upya kwa zile zilizoshindwa pekee. Mwisho ulioshakuwa umerudisha mafanikio huachwa, hivyo hupati utumaji wa marudufu.

Barua pepe ya arifa ya kushindwa

Storeep huhesabu utumaji uliofeli mfululizo kwa kila webhook. Baada ya kushindwa mara 5 mfululizo, mmiliki wa duka hupata barua pepe moja yenye kichwa "Action needed: your Storeep webhook is failing", kwa lugha ya mmiliki, ikiorodhesha jina la webhook, marudio, tukio, na msimbo wa hivi karibuni wa hali ya HTTP.
Unapata barua pepe moja tu kwa kila mfululizo wa kushindwa. Hakuna barua pepe nyingine zinazotumwa hadi webhook hiyo ipone.
Mara tu utumaji unapofanikiwa tena, kihesabu cha kushindwa hurejea sufuri na arifa hujiandaa upya, hivyo mfululizo wa baadaye wa kuvunjika unaweza kukutumia barua pepe tena.

Vidokezo na mitego

Unaweza kutengeneza webhooks nyingi kwa tukio lilelile, kwa mfano tuma Order created kwa CRM na jukwaa la matangazo kama maingizo mawili tofauti.
Ikiwa mwisho wako unahitaji uthibitishaji, weka tokeni kwenye mfuatano wa swali wa URL, ama uliopachikwa au kupitia {{placeholder}} kutoka data ya tukio, au utangulize kwa proksi inayoongeza uthibitisho kabla ya kusambaza.
Session created hutoka kwa kila kipindi cha kipekee cha mgeni na kinaweza kuwa cha kiasi kikubwa kwenye maduka yenye shughuli nyingi. Jiandikishe tu ikiwa mwisho wako unaweza kushughulikia kiwango hicho, na kumbuka hufanya kazi na aina ya API pekee.