Instagram ওয়েবহুক ইভেন্ট: কমেন্ট, মেনশন ও DM
Instagram ওয়েবহুক ইভেন্ট প্রফেশনাল অ্যাকাউন্টের কার্যকলাপ ঘটার সঙ্গে সঙ্গে জানায়: নতুন কমেন্ট, @মেনশন ও DM। Meta প্রতিটি ইভেন্ট JSON হিসেবে সংযুক্ত অ্যাপের HTTPS এন্ডপয়েন্টে POST করে এবং সেই এন্ডপয়েন্টে ব্যর্থ ডেলিভারি সর্বোচ্চ 36 ঘণ্টা পর্যন্ত আবার চেষ্টা করে। easyCoexistence প্রতিটি ইভেন্ট একবারই আপনার এন্ডপয়েন্টে পাঠায়, প্রতিটি অ্যাকাউন্টের জন্য আলাদা স্বাক্ষরসহ, এবং কোনো পুনরায় চেষ্টা করে না। Instagram Login ব্যবহার করলে মেনশন কমেন্ট নোটিফিকেশনের ভেতরেই আসে।
ব্যর্থ ডেলিভারি অ্যাপের এন্ডপয়েন্টে পাঠাতে Meta কতক্ষণ আবার চেষ্টা করে, তারপর সেটি বাদ দেওয়া হয়।
বেশিরভাগ আপডেট Meta একটি ওয়েবহুক ডেলিভারিতে একসঙ্গে পাঠায়, যদিও ব্যাচিং নিশ্চিত করে না।
অ্যাকাউন্ট নিজে যে মেসেজ পাঠিয়েছে, সেই মেসেজ-ইভেন্টে Meta একটি ফ্ল্যাগ বসায়।
কেবল পাবলিক অ্যাকাউন্টের মিডিয়াই কমেন্ট ও মেনশনের নোটিফিকেশন চালু করে।
কোন কোন ইভেন্ট আছে?
Instagram Login দিয়ে সংযুক্ত একটি প্রফেশনাল অ্যাকাউন্টের জন্য তিন ধরনের কার্যকলাপ ইভেন্ট হিসেবে আসে:
- কমেন্ট: অ্যাকাউন্টের মিডিয়ায় নতুন কমেন্ট, কমেন্ট ID, লেখকের Instagram-এর জন্য নির্দিষ্ট ID ও ইউজারনেম, টেক্সট, এবং মিডিয়া ID ও টাইপসহ।
- মেনশন: Instagram Login ব্যবহার করলে এগুলো আলাদা ফিল্ডে নয়, কমেন্ট নোটিফিকেশনের ভেতরে আসে।
- মেসেজ: অ্যাকাউন্টে পাঠানো DM, যাতে প্রেরক, প্রাপক, টাইমস্ট্যাম্প ও মেসেজটি থাকে, টেক্সট, অ্যাটাচমেন্ট ও Story reply সহ।
ইভেন্টগুলো আপনার এন্ডপয়েন্টে কীভাবে পৌঁছায়?
Meta Instagram ওয়েবহুক সেই অ্যাপে পাঠায় যার সঙ্গে অ্যাকাউন্টটি সংযুক্ত। easyCoexistence সেগুলো গ্রহণ করে এবং প্রতিটি ইভেন্ট আসামাত্রই সেই অ্যাকাউন্টের জন্য সেট করা HTTPS এন্ডপয়েন্টে পাঠায়, অ্যাকাউন্টের নিজস্ব গোপন কী দিয়ে স্বাক্ষরিত করে।
Claude বা ChatGPT থেকে set_social_webhook_destination দিয়ে, অথবা Partner API দিয়ে PUT /channels/:id/webhook ব্যবহার করে এন্ডপয়েন্ট সেট করুন। স্বাক্ষর কী একবারই দেখানো হয়। এন্ডপয়েন্ট আবার সেট করলে নতুন একটি কী দেওয়া হয়, আর URL হিসেবে null পাঠালে ফরওয়ার্ডিং বন্ধ হয়।
একটি ডেলিভারি কেমন দেখায়?
একটি POST, যার JSON বডিতে থাকে platform, list_social_accounts যে সংযোগের ID দেয় সেই account_id, Instagram অ্যাকাউন্টের external_id, এবং entry: ইভেন্টের জন্য Meta-র ওয়েবহুক entry, অপরিবর্তিত। DM একইভাবে আসে, তবে changes-এর জায়গায় থাকে messaging array। নতুন কমেন্ট দেখতে এমন:
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<INSTAGRAM_ACCOUNT_ID>",
"entry": {
"id": "<INSTAGRAM_ACCOUNT_ID>",
"time": 1793318400,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"text": "<COMMENT_TEXT>",
"media": { "id": "<MEDIA_ID>", "media_product_type": "<MEDIA_PRODUCT_TYPE>" }
}
}
]
}
}ডেলিভারি কীভাবে যাচাই করবেন?
প্রতিটি ডেলিভারিতে X-EC-Signature হেডার থাকে, t=<unix>,v1=<hex> আকারে। v1 হলো টাইমস্ট্যাম্প, একটি ডট ও কাঁচা রিকোয়েস্ট বডির HMAC-SHA256, যার কী হলো অ্যাকাউন্টের স্বাক্ষর কী। যেভাবে পেয়েছেন ঠিক সেভাবে কাঁচা বডির ওপর হিসাব করুন, constant-time পদ্ধতিতে তুলনা করুন, এবং 5 মিনিটের চেয়ে পুরনো টাইমস্ট্যাম্প বাতিল করুন।
import crypto from "node:crypto";
// rawBody: the request body exactly as received, as a string
export function verify(rawBody, header, secret) {
const sig = Object.fromEntries(header.split(",").map((part) => part.split("=")));
if (!sig.t || !sig.v1) return false;
if (Math.abs(Date.now() / 1000 - Number(sig.t)) > 300) return false;
const expected = crypto
.createHmac("sha256", secret)
.update(sig.t + "." + rawBody)
.digest("hex");
return expected.length === sig.v1.length &&
crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(sig.v1));
}ডেলিভারি কি আবার চেষ্টা করা হয়?
easyCoexistence নিজে আবার চেষ্টা করে না: ফরওয়ার্ডিং প্রতিটি ইভেন্ট একবার, মেমরিতে পাঠায়, এবং আবার চেষ্টা করার জন্য কোনো কপি রাখে না। দ্রুত 2xx দিয়ে সাড়া দিন এবং কাজ পরে করুন। ইভেন্ট আসার সময়ই যা দরকার সংরক্ষণ করুন, কারণ Meta-ও আগের নোটিফিকেশনের এমন কোনো ইতিহাস রাখে না যা কোয়েরি করা যায়।
তবে Meta নিজে ব্যর্থ ডেলিভারি অ্যাপে সর্বোচ্চ 36 ঘণ্টা ধরে আবার চেষ্টা করে, তাই একই ইভেন্ট কখনো কখনো দুবার পৌঁছাতে পারে। কমেন্ট ID বা মেসেজের mid ধরে ডুপ্লিকেট বাদ দিন।
হ্যান্ডলার আর কী যাচাই করবে?
Meta-র পেলোডের কয়েকটি বিষয় যা প্রথম হ্যান্ডলারকে বিভ্রান্ত করে:
is_echo:is_echotrue থাকা মেসেজ ইভেন্ট অ্যাকাউন্ট নিজেই পাঠিয়েছে, তাই উত্তর দেওয়ার দরকার নেই।- Story reply: Story-র উত্তর হিসেবে আসা DM-এ Story-র ID ও URL সহ
reply_toথাকে। - Story mention: attachment type
story_mentionথাকা মেসেজ হিসেবে আসে। - time: Meta নোটিফিকেশন কখন পাঠিয়েছে সেই সময়, কমেন্ট বা মেসেজ কখন করা হয়েছিল সেটি নয়। মেসেজের নিজস্ব টাইমস্ট্যাম্প তার messaging entry-তে থাকে।
- Album ID: কমেন্ট ইভেন্টে এগুলো থাকে না; কমেন্ট ID দিয়ে অ্যালবাম খুঁজুন।
সাধারণ ভুলগুলো
- উত্তর দেওয়ার আগে কাজ করা। ফরওয়ার্ডিং আবার চেষ্টা করে না, তাই সঙ্গে সঙ্গে 2xx ফেরত দিন এবং ইভেন্টটি পরে প্রক্রিয়া করুন।
- পার্স করা JSON-এর ওপর স্বাক্ষর যাচাই। যেভাবে এসেছে ঠিক সেভাবে কাঁচা বডির ওপর HMAC হিসাব করুন।
- echo-র উত্তর দেওয়া। is_echo থাকা মেসেজ ইভেন্ট অ্যাকাউন্টের নিজের পাঠানো, আর তার উত্তর দিলে একটি লুপ শুরু হয়।
- ডুপ্লিকেট বাদ না দেওয়া। ব্যর্থতার পর Meta একই ইভেন্ট আবার পাঠাতে পারে, তাই কমেন্ট ID বা মেসেজের mid ধরে বাদ দিন।
easyCoexistence Instagram অ্যাকাউন্টের কমেন্ট, মেনশন ও DM আসামাত্র আপনার HTTPS এন্ডপয়েন্টে পাঠায়, সেই অ্যাকাউন্টের গোপন কী দিয়ে স্বাক্ষরিত করে, এবং পথে কোনো কপি রাখে না। Claude বা ChatGPT থেকে set_social_webhook_destination দিয়ে, অথবা Partner API দিয়ে চালু করুন। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে সঙ্গে কমে, এবং প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
Instagram ওয়েবহুকের time ফিল্ডের মানে কী?
Meta নোটিফিকেশন কখন পাঠিয়েছে সেই সময়, কমেন্ট বা মেসেজ কখন করা হয়েছিল তা নয়। DM-এর নিজস্ব টাইমস্ট্যাম্প তার messaging entry-তে থাকে।
Meta কি ব্যর্থ Instagram ওয়েবহুক ডেলিভারি আবার চেষ্টা করে?
হ্যাঁ। Meta ব্যর্থ ডেলিভারি অ্যাপে সর্বোচ্চ 36 ঘণ্টা ধরে আবার চেষ্টা করে, তাই একই ইভেন্ট কখনো কখনো দুবার আসতে পারে। কমেন্ট ID বা মেসেজের mid ধরে ডুপ্লিকেট বাদ দিন। easyCoexistence প্রতিটি ইভেন্ট আপনার এন্ডপয়েন্টে একবার পাঠায়, তাই দ্রুত 2xx দিয়ে সাড়া দিন।
একটি Instagram ওয়েবহুক ডেলিভারিতে কতগুলো আপডেট থাকতে পারে?
Meta ব্যাচ করলে সর্বোচ্চ 1,000টি থাকতে পারে, যদিও Meta ব্যাচিং নিশ্চিত করে না। শুধু প্রথম আইটেম না পড়ে পুরো entry array-র ওপর লুপ চালান।
মেনশনের কি আলাদা ইভেন্ট আছে?
Instagram Login দিয়ে নেই। Meta মেনশনগুলো কমেন্ট নোটিফিকেশনের ভেতরে পাঠায়, তাই সেগুলো কমেন্টের একই পথে আসে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে