Навруишӣ ба Webhooks (v2)

ЭТО АГАР: Диққат доред, ки ин хусусият ё мақола барои корбарони пешрафта аст.

Webhook — ин равиш аст, ки барномае ё намуди иловагӣ, мисли Ultimate Multisite, имконият медиҳад, ки иттилооти воқеии (real-time) ба барномаҳои дигари пешниҳод кунад. Webhook маълумот ё payload-ҳоро вақте ки кор меравад, ба барномаҳои дигар мефирмояд, яъне шумо дар лаҳзаи он маълумот мегиред.

Ин афзали аст, агар шумо лозим бошед, ки маълумотнома ё маълумоти муайянро аз Ultimate Multisite ба CRM ё системаи дигари равона кунед ҳар вақте як воқеа (event) фаъол мешавад. Масалан, шумо бояд ҳар вақте ки корбараи нав сохта мешавад, номи ва почтаи онро ба рӯйхати почта фиристонед.

Чӣ тавр webhook сохтан?

Барои сохтани webhook, ба дашбори администратори шабакаи худ равед. Ба Ultimate Multisite > Webhooks > Add New Webhook клик кунед.

Баъд шумо метавонед тасвири конфигурасияи webhook-ро тағйир диҳед:

Вақте ки шумо webhook нависоед, аз шумо маълумоти чуно Name (Ном), URL ва Event (Воқеа) хоҳиш карда мешавад. Шумо метавонед номи дигарро барои webhook худро истифода баред. Муҳимтарин сохторҳо URL ва Event-ган ҳастанд.

URL — ин endpoint ё мақсади он аст, ки Ultimate Multisite payload ё маълумотномаро ба он фиристода мерасонад. Ин барномаест, ки маълумот қабул мекунад.

Zapier маъмункун тавсияшавандаи мувофиқ барои корбарон аст, ки пайвастшавии бо барномаҳои касбии (3rd party) ба осонӣ мерасонад. Агар шумо платформаи монанди Zapier надошта бошед, бояд худро функсияи хосиятӣ созед, ки маълумотро ба даст мегирад ва онро таҳлил мекунад. Ба ин мақола дар таври истифодаи webhook-и Ultimate Multisite бо Zapier бинед.

Ин ин мақола моме ба тасвири муҳталлифи асосии коркардаи webhook ва рӯйдидотҳое ки дар Ultimate Multisite мавҷуданд, назар мерасем. Мо аз сайтҳои гурӯҳӣ номи requestbin.com истифода мебарем. Ин сайт ба мо имкон медиҳад, ки як endpoint созеем ва payload-ро бигирем бе он ки код нависем. Эътироз: ҳамаи он ки он намкун кунад ин аст, ки ба мо нишон диҳад, ки маълумот гирифта шудааст. Ҳеҷ коркард ё амалиёти ба payload намуда намешавад.

Ба requestbin.com равед ва дар бораи "Create Request Bin" клик кунед.

Баъди клики дарун ин аз шумо хоҳиш мекунад, ки агар ҳисобкунанда дошта бошед, ворид шавед ё қайд шавед. Агар шумо ҳисобкунанда дошта бошед, он ба таври мустақим ба дашбор онҳо мерасонад. Дар дашбори онҳо, шумо дар як навбати фаврӣ endpoint ё URL-ро мебинед, ки метавонед барои сохтани webhook-и Ultimate Multisite-и худ истифода баред.

Ин URL-ро нусхабардор кунед ва ба Ultimate Multisite бора баргардонед. Endpoint-ро дар майдони URL ва рӯйдидот аз менюи чопӣ интихоб намоед. Дар ин мисол, мо Payment Received (Малия гирифта шуд) -ро интихоб мекунем.

Ин рӯйдидот ҳар вақте ки корбар маориф месозад. Ҳамаи рӯйдидотҳо, тавсифи онҳо ва payload-ҳо дар паёлои постсаҳиба ҷойгир шудаанд. Барои сақлани webhook клики ба дафтори Add New Webhook (Дохили вебхук нав) кунед.

Ин ҳоло мо метавонем як рӯйдидоти тестро ба endpoint фиристонем, то бигӯем ки webhook-и сохташуда мо кор мекунад ё не. Мо инро бо клик кардани Send Test Event (Фиристодани рӯйдидоти тест) дар паси webhook-и сохташуда иҷро менамоем.

Ин як ҷониши тасдиқро нишон медиҳад, ки тест муваффақ буд.

Ҳарчанд ба сайти Requestbin бора мегӯем, дида меҷӯем, ки ин payload (маводи мувофиқ) қабул шудааст ва он дар он маълумоти тестоӣ мавҷуд аст.

Ин принсипи асосии кор кардани webhook ва endpoint-ҳост. Агар шумо хоҳед, ки endpoint махсус созед, бояд функсияи махсусе созед, ки маълумоти баргасторандашуда аз Ultimate Multisite-ро таҳлил (process) кунад.