මෙම පුවතේ අඩංගු දෑ
ස්ථානය: Settings → Advanced → Connect other apps
මෙම පිටුව විවෘත කරන්න: admin.<your-site>/settings/integrations/webhooks (<your-site> වෙනුවට ඔබගේ වෙබ් අඩවියේ ලිපිනය යොදන්න). ඔබට එය මෙනුවේ නොපෙනේ නම්, Settings පිටුවේ ඇති සියලු සැකසීම් පෙන්වන්න ක්රියාත්මක කරන්න.
ආරම්භ කිරීමට පෙර
- Webhooks එක් කළ හැක්කේ වෙබ් අඩවියේ හිමිකරුට (site owner) පමණි.
- ලබාගන්නා ලිපිනය (receiving address) https:// මඟින් ආරම්භ විය යුතු අතර එය පොදු අන්තර්ජාලය (public internet) තුළ තිබිය යුතුය.
පියවර
- සැකසීම් → උසස් සැකසුම් → වෙනත් app සම්බන්ධ කරන්න → Webhooks විවෘත කරන්න.
- webhook එක් කරන්න ඔබන්න.
- නම (උදාහරණයක් ලෙස Zapier) සහ පණිවිඩ ලැබෙන ලිපිනය ඇතුළත් කරන්න.
- මට මෙවිට පණිවිඩයක් එවන්න යටතේ සිදුවීම් තෝරන්න: පුවතක් සජීවී වේ, සජීවී පුවතක් වෙනස් කර ඇත, පුවතක් ඉවත් කර ඇත, නිවැරදි කිරීමක් එක් කර ඇත, පුවතක් ඉල්ලා අස්කර ගන්නා ලදී, නව අදහසක්, දායකත්වය වෙනස් වේ.
- webhook එක් කරන්න ඔබන්න.
- Signing secret එක පිටපත් කරගන්න. එය ඔබට පෙනෙන්නේ එක් වරක් පමණි. ඉන්පසු මම එය සුරැකුවා ඔබන්න.
- පරීක්ෂණ පණිවිඩයක් එවන්න උත්සාහ කර බලන්න.
දැනගැනීම වැදගත්
- සෑම පණිවිඩයක්ම අත්සන් කර ඇත (signed). එය ඔබගේ වෙබ් අඩවියෙන්ම පැමිණි බව තහවුරු කර ගැනීමට "Keynate-Signature" header එක පරීක්ෂා කරන්න.
- පණිවිඩය ලැබුණු බව තහවුරු කිරීමට ඔබගේ පද්ධතිය ඕනෑම 2xx status එකක් මඟින් පිළිතුරු දිය යුතුය.
- අසාර්ථක වූ පණිවිඩ පැය 24ක් දක්වා නැවත උත්සාහ කරනු ලැබේ. දින 3ක් පුරා අසාර්ථක වන webhook එකක් ක්රියාවිරහිත කෙරේ. ලබාගන්නා පද්ධතිය නිවැරදි කර, පසුව නැවත අරඹන්න ඔබන්න.
- ඔබට විරාම කරන්න, නැවත අරඹන්න, හෝ නව secret එකක් එකක් කළ හැක. ඔබ තෝරාගන්නා කාලය දක්වා පැරණි secret එක හරහා අත්සන් කිරීම දිගටම සිදුවේ.
- ලැයිස්තුවේ සෑම webhook එකකම තත්ත්වය පෙන්වයි: ක්රියාත්මක වෙමින්, තවම භාවිතා කර නැත, ක්රියා නොකරයි, විරාම කර ඇත, අක්රියයි.
- උත්සාහ කළ වාර ගණන බැලීමට යවන ලද පණිවිඩයක් විවෘත කර නැවත යවන්න ඔබන්න.
පොදු ගැටලු
- "The address must start with https://."
- "webhook සඳහා නමක් ලබා දෙන්න."
- "අවම වශයෙන් එක් සිදුවීමක්වත් තෝරන්න."
- "ඔබට ලබාගත හැකි උපරිම webhooks ගණනට ළඟා වී ඇත. පළමුව ඔබ තවදුරටත් භාවිත නොකරන එකක් මකා දමන්න."
ප්රශ්න
නිතර අසන ප්රශ්න
පණිවිඩයක් දිස්වන්නේ කෙසේද?
සිදුවීමේ වර්ගය සහ අදාළ ලිපිය ඇතුළත් කුඩා JSON පෙළක් ලෙසයි.
මගේ ලබාගන්නා පද්ධතිය ක්රියාවිරහිත වී ඇත්නම් කුමක් සිදුවේද?
අසාර්ථක වූ පණිවිඩ පැය 24ක් යනතුරු නැවත නැවත උත්සාහ කරනු ලැබේ.