Webhook hufanya nini
Webhook hutuma maelezo ya tukio katika duka lako kwenda mahali pengine mara tu linapotokea. Unachagua tukio na linakokwenda:
- API: Storeep hutuma data ya tukio kwenye anwani ya wavuti (URL) ya seva yako, CRM, hali ya Zapier au Make, au zana ya kufuatilia matangazo.
- Barua pepe: Storeep hutuma data ya tukio kwenye anwani ya barua pepe, kwa mfano ili kupata barua pepe kwa kila agizo jipya.
Fungua Mipangilio > Webhooks. Unahitaji ruhusa ya Mipangilio.
Zana nyingi tayari zina programu iliyo tayari, ambayo ni rahisi zaidi: Google Sheets, mitandao ya usafirishaji, na pixels za matangazo. Angalia soko la Programu kwanza.
Kuunda webhook
Bofya Ongeza webhook mpya, jaza fomu, na ubofye Ongeza.
- Amilisha: imewekewa alama kwa chaguo-msingi. Ikiwa imewekewa alama, matukio hutumwa mara moja. Iondoe alama ili kubaki na webhook lakini kuisitisha.
- Jina: lebo ya orodha yako, kwa mfano "CRM maagizo mapya".
- Aina: API au Barua pepe.
- Tukio:
- Agizo limeundwa: mteja anaweka agizo jipya.
- Agizo limesasishwa: hali au maelezo ya agizo yanabadilika.
- Kipindi kimeundwa: mgeni mpya anafika kwenye duka lako. Kwa aina ya API tu.
- Umbizo: Json.
- URL (aina ya API): anwani ya kutuma. Sehemu ya
https://huongezwa kwa ajili yako, kwa hivyo andika sehemu iliyobaki, kamaapi.example.com/orders. - Anwani ya barua pepe (aina ya Barua pepe): mahali barua pepe inakokwenda.
Webhook ya Barua pepe hutuma matukio ya maagizo tu. Ukichagua Barua pepe pamoja na Kipindi kimeundwa, hakuna kinachotumwa.
Kuweka data ya agizo kwenye URL
Unaweza kuweka sehemu yoyote ya data ya tukio ndani ya URL kwa mabano mawili, {{field_name}}. Kwa mfano:
example.com/postback?cid={{fbclid}}&payout={{order_total}}
Hii hutuma kitambulisho cha kubofya cha Facebook na jumla ya agizo kwenye jukwaa la kufuatilia matangazo au la washirika, bila seva ya ziada. Sehemu isiyokuwepo huwa tupu. Ili kuona majina ya sehemu, unda webhook ya Barua pepe kwa tukio lile lile na uangalie data unayopokea.
Orodha ya webhooks
Kila safu inaonyesha Jina, URL / Barua pepe, Aina, Tukio, Umbizo, na Hali (Imewashwa au Imezimwa). Bofya safu ili kuihariri. Weka alama kwenye safu na uchague Futa webhooks ili kuziondoa kabisa. Kuna idadi ya juu ya webhooks kwa kila duka, na utaona ujumbe ukiifikia.
Unaweza kuunda webhooks kadhaa kwa tukio lile lile, kwa mfano moja kwa CRM yako na moja kwa kifuatiliaji chako cha matangazo.
Utumaji unaposhindwa
- Seva yako inapaswa kujibu haraka kwa msimbo wa mafanikio (2xx). Jibu la polepole huhesabiwa kama kushindwa.
- Ikiwa seva yako haifanyi kazi au ina shughuli nyingi (jibu la 5xx au 429, au hakuna jibu), Storeep hujaribu tena mara kadhaa katika dakika chache zinazofuata. Webhooks zilizoshindwa pekee ndizo hujaribiwa upya, kwa hivyo nyingine hazipati nakala mbili.
- Ikiwa seva yako inakataa ombi (jibu la 4xx kama 404 au 403), Storeep haijaribu tena, kwa sababu anwani au usalama wake si sahihi.
- Webhook ikishindwa mara kadhaa mfululizo, mmiliki wa duka hupata barua pepe moja: "Action needed: your Storeep webhook is failing" (Hatua inahitajika: webhook yako ya Storeep inashindwa), pamoja na jina la webhook, anwani, tukio, na msimbo wa hitilafu wa mwisho. Baada ya webhook kufanya kazi tena, tatizo la baadaye linaweza kutuma onyo jipya. Unaweza kuzima barua pepe hii katika Arifa.
- Webhooks za Barua pepe hutumwa mara moja, bila kujaribu tena.
Webhooks zilizositishwa na salio ambalo halijalipwa
Ikiwa duka lako lina kiasi kinachodaiwa ambacho hakijalipwa na pochi yako haiwezi kukilipa, webhooks husubiri. Hutumwa baada ya kuongeza pesa na kiasi kulipwa. Angalia Pochi na malipo.
Vidokezo
- Ikiwa seva yako inahitaji nenosiri au ufunguo, uweke kwenye query ya URL, kwa mfano
?key=yoursecret. - Kipindi kimeundwa hutumwa kwa kila mgeni, jambo linaloweza kuwa jingi kwenye duka lenye shughuli nyingi. Litumie tu ikiwa seva yako inaweza kulimudu.
- Ili kuruhusu zana isome maagizo na bidhaa zako wakati wowote inapotaka, tumia tokeni ya ufikiaji badala yake.