Webhooks

Webhooks hufanya nini

Webhook ni usajili wa tukio maalum la duka. Tukio hilo linapotokea, Storeep inatuma mara moja data ya tukio kwenye URL unayobainisha (aina ya API) au anwani ya barua pepe unayobainisha (aina ya Barua pepe). Webhooks kwa kawaida hutumika kwa muunganiko wa ufuatiliaji wa maagizo, usawazishaji wa CRM, ubadilishaji wa jukwaa la matangazo, na arifa za kiotomatiki.

Kusimamia webhooks, nenda kwenye Mipangilio → Webhooks.

Mipaka ya webhook

• Kiwango cha juu cha webhooks 20 kwa kila duka. Kujaribu kuongeza ya 21 kunarudi hitilafu.
• Webhooks zimeorodheshwa mpya kwanza, zimepaginwa kwa 40 kwa ukurasa.

Kuunda webhook

Bonyeza Ongeza webhook mpya.

Kitufe cha Washa

Kikichaguliwa (default), webhook iko hai tangu dakika inapohifadhiwa. Matukio yanatumwa mara moja. Toa chaguo kuhifadhi webhook katika hali iliyozimwa bila kupokea matukio. Unaweza kuwezesha au kuzima webhook wakati wowote kwa kuihariri.

Jina

• Inahitajika.
• Urefu wa juu zaidi ni herufi 50.
• Lebo ya kuelezea inayoonyeshwa kwenye orodha ya webhooks. Mfano: Facebook CAPI, agizo limeundwa.

Aina

Inasimamia jinsi mzigo wa tukio unavyowasilishwa. Chaguzi mbili:

• API: Storeep inatuma ombi la HTTP POST linaloibeba data ya tukio kwenye URL unayobainisha.
• Barua pepe: Storeep inatuma barua pepe iliyo na data ya tukio kwenye anwani unayobainisha.

Tukio

Tukio la duka ambalo linaanzisha webhook hii. Matukio matatu yanapatikana:

• Kikao kimeundwa: inafyatuka wakati kikao kipya cha mgeni kinaundwa kwenye duka lako.
• Agizo limeundwa: inafyatuka wakati agizo jipya linawekwa.
• Agizo limesasishwa: inafyatuka wakati hali au data ya agizo lililopo inabadilika.

Muundo

Muundo wa data wa mzigo wa tukio. Kwa sasa chaguo moja:

• Json: mzigo unatumwa kama hati ya JSON.

URL (aina ya API tu)

• Inahitajika aina ikuwa API.
• Urefu wa juu zaidi ni herufi 500. Mipaka ya juu inajumuisha URL zinazojumuisha sehemu nyingi za kibali.
• Weka URL ya kiendeshi bila kiambishi cha https://. Inaongezwa kiotomatiki. Mfano: api.example.com/events/order.
• Vibali vya URL vya nguvu: sehemu yoyote kutoka kwenye mzigo wa tukio inaweza kuingizwa kwenye URL kwa kutumia sintaksia ya mabano maradufu: {{field_name}}. Kwa mfano:
  https://example.com/postback?cid={{fbclid}}&payout={{order_total}}
  Hii hukuruhusu kutuma data ya ubadilishaji kwenye majukwaa ya matangazo moja kwa moja kutoka kwenye URL ya webhook bila seva ya wakala tofauti.
• Muundo wa URL ukiwa batili baada ya vibali kusuluhishwa, utapokea hitilafu ya uthibitisho.

Anwani ya barua pepe (aina ya barua pepe tu)

• Inahitajika aina ikuwa Barua pepe.
• Lazima iwe anwani halali ya barua pepe, urefu wa juu zaidi ni herufi 127.

Kuhariri webhook

Bonyeza safu yoyote ya webhook kufungua kihariri. Sehemu zote zinaweza kuhaririwa. Sehemu ya URL inajaza awali tu ikiwa aina ya sasa ni API; sehemu ya barua pepe inajaza awali tu ikiwa aina ya sasa ni Barua pepe. Kubadilisha aina kunasafisha sehemu nyingine.

Kuwezesha na kuzima webhooks

Kisanduku cha Washa juu ya kihariri kinasimamia kama webhook inafyatuka. Hali kwenye orodha inaonyesha Imewashwa au Imezimwa. Webhook iliyozimwa haiandiki utoaji lakini haifutiwi, kwa hivyo unaweza kuiwezesha tena baadaye bila kuisanidi upya.

Safu za orodha ya webhooks

• Jina: lebo ya webhook na tarehe ya uundaji.
• URL / Barua pepe: anwani ya marudio.
• Aina: API au Barua pepe.
• Tukio: jina la tukio (Kikao kimeundwa, Agizo limeundwa, au Agizo limesasishwa).
• Muundo: Json.
• Hali: Imewashwa au Imezimwa.

Kufuta webhook

Chagua webhooks moja au zaidi na bonyeza Futa webhooks. Hii ni ya kudumu na inasimamia utoaji wote wa baadaye kwa usajili huo.

Vidokezo na mambo ya kukagua

• Unaweza kuunda webhooks nyingi kwa tukio moja, kwa mfano, tuma Agizo limeundwa kwa CRM na jukwaa la matangazo, kila moja kama ingizo tofauti la webhook.
• Kiendeshi chako kikihitaji uthibitisho, ongeza vitambulisho kwenye mfuatano wa ombi la URL kwa kutumia {{kibali}} kilichotoka kwa data ya tukio, au sanidi seva ya wakala inayoshughulikia uthibitisho kabla ya kupeleka kwa kiendeshi halisi.
• Tukio la Kikao kimeundwa linafyatuka kwa kila kikao cha mgeni wa kipekee, ambalo linaweza kuwa kwa kiasi kikubwa kwenye maduka maarufu. Jiandikishe nalo tu ikiwa kiendeshi chako kinaweza kushughulikia uzito wa trafiki.