What is a webhook: কিছু ঘটার সঙ্গে সঙ্গে এক অ্যাপ অন্য অ্যাপকে যে বার্তা পাঠায়। জানুন webhook কীভাবে কাজ করে, কীভাবে যাচাই করবেন আর sona.to কী পাঠায়।
Webhook হলো এমন একটি বার্তা, যা কিছু ঘটার মুহূর্তে এক অ্যাপ অন্য অ্যাপকে পাঠায়, যাতে দ্বিতীয় অ্যাপটিকে বারবার জিজ্ঞেস করতে না হয়। আপনি প্রথম অ্যাপটিকে একটি ঠিকানা দেন, আর প্রতিটি ঘটনা ঘটার সঙ্গে সঙ্গে সেটি সেখানে ঘটনার বিস্তারিত পাঠায়। এই গাইডে আছে webhooks কীভাবে কাজ করে, একটি webhook আসল কি না কীভাবে যাচাই করবেন আর sona.to কী পাঠায়, যার সারসংক্ষেপ webhooks পেজেও আছে।
Webhook কী?
বেশির ভাগ অ্যাপ দুইভাবে ডেটা ভাগ করে। API-তে আপনার সিস্টেম জিজ্ঞেস করে: "পোস্টটি কি প্রকাশ হয়েছে?", আর উত্তর না হলে পরে আবার জিজ্ঞেস করে। Webhook-এ অ্যাপ আপনাকে জানায়: পোস্ট প্রকাশ হলেই সেটি আপনার বাছাই করা ঠিকানায় পোস্টের বিস্তারিতসহ একটি রিকোয়েস্ট পাঠায়।
তাই webhook হলো একটি HTTP রিকোয়েস্ট, সাধারণত JSON বডিসহ একটি POST, যা আপনার নিয়ন্ত্রণে থাকা একটি URL-এ পাঠানো হয়। সেই URL আপনার নিজের সার্ভার হতে পারে, অথবা n8n, Zapier, Make, Slack বা অন্য কোনো সেবার দেওয়া webhook ঠিকানা, যা রিকোয়েস্ট এলেই একটি ওয়ার্কফ্লো শুরু করে।
Webhook আর API-র পার্থক্য
API জিজ্ঞেস করা আর বদলানোর জন্য: পোস্টের তালিকা নেওয়া, পোস্ট তৈরি করা, পরিসংখ্যান পড়া। Webhook খবর পাওয়ার জন্য। বেশির ভাগ ইন্টিগ্রেশন দুটোই ব্যবহার করে: পোস্ট তৈরি করতে API আর সেটি কখন প্রকাশ হলো বা ব্যর্থ হলো তা জানতে webhook। API-কে বারবার জিজ্ঞেস করলে রিকোয়েস্ট নষ্ট হয় আর তবু দেরিতে জানা যায়, অথচ webhook ঘটনা ঘটার সঙ্গে সঙ্গে পৌঁছায়।
Webhook কীভাবে যাচাই করবেন
আপনার webhook ঠিকানা যে-ই জানে, সে সেখানে ভুয়া রিকোয়েস্ট পাঠাতে পারে, তাই ভালোভাবে বানানো webhook সাইন করা থাকে। প্রেরক বডি আর একটি শেয়ার করা secret থেকে একটি সিগনেচার বের করে, সাধারণত HMAC SHA-256 দিয়ে, আর সেটি একটি হেডারে রাখে। আপনার দিকে একই secret দিয়ে একই সিগনেচার বের করা হয় আর constant-time comparison দিয়ে দুটি মেলানো হয়। আলাদা হলে রিকোয়েস্টটি উপেক্ষা করা হয়।
সাইন করা ডেটায় একটি টাইমস্ট্যাম্প রাখলে রিপ্লেও বন্ধ হয়: একবার ধরা পড়া রিকোয়েস্ট পরে আবার পাঠানো যায় না, কারণ তার টাইমস্ট্যাম্প অনেক পুরোনো।
sona.to-তে webhooks
sona.to চারটি ঘটনার জন্য webhooks পাঠায়: একটি পোস্ট প্রকাশ হয়েছে, একটি পোস্ট ব্যর্থ হয়েছে, একটি সাইট অডিট শেষ হয়েছে আর একটি সাইট অডিট ব্যর্থ হয়েছে। আপনি বেছে নেন প্রতিটি webhook কোন ঘটনাগুলো পাবে, তাই একটি চ্যাট নোটিফায়ার কেবল ব্যর্থতার খবর শুনতে পারে, আর একটি রিপোর্টিং শিট সবকিছু নিতে পারে। Payload-এ সেই একই ফিল্ডের নাম থাকে যা sona.to API-তে আছে।
সেট আপ করা। আপনার ড্যাশবোর্ডের API পেজে ঠিকানাটি পেস্ট করুন, ঘটনাগুলোতে টিক দিন আর সংরক্ষণ করুন। সাইনিং secret সেই মুহূর্তে একবারই দেখানো হয়, তাই তখনই কপি করে নিন।
সিগনেচার। প্রতিটি ডেলিভারিতে একটি হেডার থাকে, যাতে আছে একটি টাইমস্ট্যাম্প আর আপনার secret দিয়ে বানানো টাইমস্ট্যাম্প ও বডির HMAC SHA-256। যে রিকোয়েস্টের টাইমস্ট্যাম্প কয়েক মিনিটের বেশি পুরোনো, সেগুলো বাতিল করুন।
পুনরায় চেষ্টা। আপনার ঠিকানা বন্ধ থাকলে বা এরর ফেরত দিলে ডেলিভারি আবার চেষ্টা করা হয় ৬০ সেকেন্ড, ৫ মিনিট আর ৩০ মিনিট পরে। প্রতিটি চেষ্টা তার স্ট্যাটাস কোড আর সময়কালসহ লগ হয়। যে ঠিকানা বারবার ব্যর্থ হয় তা বন্ধ করে দেওয়া হয়, আর ঠিক হয়ে গেলে আপনি আবার চালু করতে পারেন।
নিরাপত্তা। ঠিকানায় https থাকতে হবে আর সেটি একটি পাবলিক সার্ভারের দিকে নির্দেশ করতে হবে। প্রাইভেট নেটওয়ার্কের ঠিকানা সংরক্ষণের সময় আর আবার ডেলিভারির সময় বাতিল করা হয়, আর রিডাইরেক্ট অনুসরণ করা হয় না।
n8n, Zapier ও Make-এর সঙ্গে webhooks
n8n, Zapier আর Make-এর জন্য sona.to অ্যাপে এই চারটি ঘটনার জন্য তৈরি ট্রিগার আছে, তাই আপনাকে নিজে ঠিকানা পেস্ট করতে হয় না: ট্রিগার যোগ করুন আর অ্যাপ webhook সেট আপ করে দেয়। দেখুন n8n, Zapier ও Make দিয়ে social media automation।
সিগনেচার যাচাইয়ের উদাহরণসহ পুরো বিবরণ আছে API ডকুমেন্টেশনে।
প্রায়ই জিজ্ঞাসিত প্রশ্ন
Webhook আর API কি একই জিনিস?
না। API উত্তর দেয় যখন আপনি জিজ্ঞেস করেন। Webhook কিছু ঘটলে আপনাকে বার্তা পাঠায়।
sona.to webhooks কি বিনামূল্যে?
Webhooks, API-র সঙ্গে, সব প্ল্যানে আছে।
আমার সার্ভার বন্ধ থাকলে কী হয়?
sona.to প্রায় আধা ঘণ্টার মধ্যে আরও তিনবার চেষ্টা করে। ডেলিভারি বারবার ব্যর্থ হলে webhook বন্ধ থাকে, যতক্ষণ না আপনি আবার চালু করেন।
চেষ্টা করে দেখতে প্রস্তুত?
শুরু করা বিনামূল্যে, ক্রেডিট কার্ড লাগবে না।
