Customer webhook কনফিগার করুন
সমর্থিত event-এর জন্য HTTPS receiver নিবন্ধন করুন, signing secret সুরক্ষিত রাখুন এবং delivery history থেকে failure নির্ণয় করুন।
- Receiver প্রস্তুত করুনJSON নিতে পারে এমন public HTTPS endpoint ব্যবহার করুন।
- Event subscribe করুনEndpoint name, URL ও event type দিন।
- Signature সুরক্ষিত করুনএকবারের secret রেখে incoming request যাচাই করুন।
- Delivery দেখুনত্রুটি মেটাতে status ও response তথ্য নিন।
- Endpoint বজায় রাখুনSecret rotate করুন বা অপ্রয়োজনীয় destination revoke করুন।
সমর্থিত customer event
Customer form-এ job finished, invoice issued ও quota threshold event পাওয়া যায়। শুধু receiver সামলাতে পারে এমন event নিন। Endpoint আপনার personal বা নির্বাচিত organisation context-এর। Organisation owner ও administrator তা পরিচালনা করতে পারেন; member দেখতে পারেন, বদলাতে পারেন না। Webhook notification পাঠায়, order বা invoice নিজে বদলায় না।
- লক্ষ্য organisation context-এ Webhooks খুলুন।
- Receiver সমর্থন করে এমন অন্তত একটি event বাছুন।
- ভিন্ন environment-এর জন্য আলাদা endpoint রাখুন।
Public destination নিবন্ধন করুন
২–১২০ অক্ষরের নাম, বৈধ URL এবং অন্তত একটি তালিকাভুক্ত event দিয়ে endpoint তৈরি করুন। HTTPS ও public hostname আবশ্যক। Local, internal ও private IP destination প্রত্যাখ্যাত হয়, তাই local development URL চলবে না। Receiver JSON নিতে ও সফল HTTP response দিতে প্রস্তুত হলে submit করুন।
- স্থিতিশীল public HTTPS address-এ receiver deploy করুন।
- URL, স্পষ্ট নাম ও event নির্বাচন দিন।
- একবার submit করে দেখানো validation error ঠিক করুন।
Signed message যাচাই করুন
তৈরির সময় signing secret একবার দেখানো হয়। Request-এ event, delivery, timestamp ও HMAC signature header এবং event ID, type, creation time ও data-সহ JSON থাকে। Timestamp ও হুবহু raw body-র ওপর signature যাচাই করুন, যুক্তিসঙ্গত timestamp window মানুন এবং duplicate ID idempotently সামলান। Log বা support message-এ secret রাখবেন না।
- সুরক্ষিত receiver configuration-এ secret রাখুন।
- অপরিবর্তিত request body দিয়ে signature যাচাই করুন।
- Duplicate business action ঠেকাতে event ID রেকর্ড করুন।
Delivery history পড়ুন
আপনার endpoint-গুলোর সর্বশেষ ৫০টি delivery page-এ দেখা যায়। সফল HTTP response succeeded হয়। Server error ও rate limit retry হতে পারে; অন্য unsuccessful response সঙ্গে সঙ্গে fail হতে পারে এবং retry limit-এ চেষ্টা থামে। History-তে response status ও সীমিত response body বা error থাকে। Event না ঘটলে বা endpoint subscribe না করলে তা দেখা নাও যেতে পারে।
- Event, attempt count, status ও শেষ error দেখুন।
- Receiver-এর availability, response বা rate limit ঠিক করুন।
- পরের delivery succeeded হয়েছে কি না যাচাই করুন।
Signing secret rotate করুন
Rotation endpoint-এর secret বদলে সেটিকে আবার সক্রিয় করে। শুধু পুরোনো value ব্যবহার করা receiver নতুন request প্রত্যাখ্যান করবে। Receiver configuration update প্রস্তুত করুন, সঠিক endpoint row থেকে rotate করে নতুন value নিন এবং দ্রুত deploy করুন। Secret ফাঁস হলে সঙ্গে সঙ্গে rotate করে অপ্রত্যাশিত activity-এর জন্য delivery history দেখুন।
- Receiver instance শনাক্ত করে নিরাপদ deployment প্রস্তুত করুন।
- Endpoint rotate করে একবারের secret সংরক্ষণ করুন।
- পরের প্রত্যাশিত delivery সফল হয়েছে নিশ্চিত করুন।
Endpoint বদল বা revoke করুন
Customer endpoint create, rotate ও revoke করতে পারে; URL বা event নির্বাচন edit করার action নেই। পরিবর্তনে replacement তৈরি করুন, সঠিক event পাচ্ছে যাচাই করুন, তারপর পুরোনো endpoint revoke করুন। Revocation ভবিষ্যৎ delivery থামিয়ে একে inactive করে। অবসর নেওয়া destination বা compromised secret-এর জন্য এটি ব্যবহার করে action-এর পর তালিকা যাচাই করুন।
- সংশোধিত URL বা event set দিয়ে replacement তৈরি করুন।
- Replacement delivery সফল হয় নিশ্চিত করুন।
- পুরোনো endpoint revoke করে inactive হয়েছে যাচাই করুন।
সাধারণ জিজ্ঞাসা
কোন event offer করা হয়?
Job finished, invoice issued ও quota threshold।
সাধারণ HTTP ব্যবহার করা যাবে?
না। Public HTTPS URL আবশ্যক।
Secret আবার দেখা যাবে?
না। নতুন secret পেতে endpoint rotate করুন।
Delivery pending কেন?
সাময়িক server error বা rate limit-এ retry হতে পারে।
Delivery ব্যর্থ হলো কেন?
কারণ জানতে response ও retry history দেখুন।
Endpoint edit করা যায়?
না। নতুনটি তৈরি ও যাচাই করে পুরোনোটি revoke করুন।