Instagram কমেন্ট ওয়েবহুক: পেলোড, প্রতিটি ফিল্ড ধরে ধরে
Instagram-এর কমেন্ট ওয়েবহুক ফিল্ড একটি অ্যাপকে জানায় যখন কেউ কোনো পেশাদার অ্যাকাউন্টের মিডিয়ায় কমেন্ট করে, অথবা কোনো কমেন্টের রিপ্লাই দেয়, রিলও এর অন্তর্ভুক্ত। Meta একটি চেঞ্জ পাঠায় যার field-এর মান comments, যার value-তে থাকে কমেন্টের id ও লেখা, from-এ লেখকের Instagram-scoped ID ও ইউজারনেম, মিডিয়ার id ও product type, এবং কমেন্টটি রিপ্লাই হলে parent_id।
easyCoexistence প্রতিটি সংযুক্ত Instagram অ্যাকাউন্টকে কমেন্টে সাবস্ক্রাইব করে এবং Meta সেটির জন্য যে comments ইভেন্ট পাঠায় তা আসামাত্র আপনার HTTPS এন্ডপয়েন্টে ফরওয়ার্ড করে, সেই অ্যাকাউন্টের সিক্রেট দিয়ে স্বাক্ষরিত, কোনো কপি না রেখে।
উপস্থিত থাকে যখন কমেন্টটি একটি রিপ্লাই, এবং যে কমেন্টের উত্তর দেওয়া হয়েছে তার ID ধরে রাখে।
অ্যাকাউন্ট নিজের মিডিয়ায় কমেন্ট করলে from-এর সাথে যুক্ত হয়, অ্যাকাউন্টের নিজস্ব ID-এর পাশে।
লাইভ সম্প্রচারের কমেন্টের জন্য আলাদা ফিল্ড; সম্প্রচার শেষ হলে এর নোটিফিকেশন বন্ধ হয়ে যায়।
comments ও live_comments নোটিফিকেশনের জন্য প্রয়োজন; ব্যক্তিগত অ্যাকাউন্টের মিডিয়ায় কোনো নোটিফিকেশন আসে না।
কমেন্টকারীকে একটি ব্যক্তিগত রিপ্লাই পাঠানোর বাকি সময়, যা কমেন্টের ID দিয়ে ঠিকানা দেওয়া হয়।
comments ফিল্ড কখন চালু হয়?
যখন কেউ পেশাদার অ্যাকাউন্টের মালিকানাধীন মিডিয়ায় কমেন্ট করে, অথবা অ্যাকাউন্টকে উল্লেখ করে, এবং অ্যাপ ও অ্যাকাউন্ট দুটোই এই ফিল্ডে সাবস্ক্রাইব করা থাকে। প্রতিটি কমেন্ট নোটিফিকেশনে একটি চেঞ্জ, এবং এই ক্ষেত্রগুলো একই কাঠামো ভাগ করে নেয়:
- একটি পোস্ট, রিল, স্টোরি বা বিজ্ঞাপনে নতুন কমেন্ট, সাথে media.
media_product_type, যা বলে মিডিয়াটি কোন জায়গায় আছে। - বিদ্যমান একটি কমেন্টের নিচে রিপ্লাই, যাতে
parent_idথাকে, যা যে কমেন্টের উত্তর দেওয়া হয়েছে তার ID। - অ্যাকাউন্ট নিজের মিডিয়ায় যে কমেন্ট করে, তার রিপ্লাইসহ: from.id হলো অ্যাকাউন্টের নিজস্ব ID, আর from-এ যোগ হয়
self_ig_scoped_id। - অ্যাকাউন্টের @মেনশন: Instagram Login-এর সাথে Meta মেনশনগুলোকে কমেন্ট নোটিফিকেশনের ভেতরেই রাখে, আলাদা ফিল্ড হিসেবে নয়।
- লাইভ সম্প্রচারের সময় কমেন্ট আসে আলাদা
live_commentsফিল্ডে, একই মানের আকৃতিসহ, এবং সম্প্রচার শেষ হলে থেমে যায়।
কমেন্ট নোটিফিকেশন কেমন দেখায়?
একটি POST, যার JSON-এ object থাকে instagram, আর একটি entry অ্যারে। প্রতিটি entry একটি পেশাদার অ্যাকাউন্ট: তার ID, Meta নোটিফিকেশন পাঠানোর সময়, এবং একটি changes অ্যারে যাতে প্রতি কমেন্টের জন্য একটি চেঞ্জ থাকে। রিলের একটি রিপ্লাই এমন দেখায়:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"parent_id": "<PARENT_COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<MEDIA_ID>",
"media_product_type": "REELS"
}
}
}
]
}
]
}প্রতিটি ফিল্ডের মানে কী?
Meta-র ওয়েবহুক রেফারেন্স কমেন্টের জন্য যে ফিল্ডগুলো তালিকা করে, বাইরে থেকে ভেতরের দিকে:
- entry[].id: পেশাদার অ্যাকাউন্টের ID, অর্থাৎ /me যে
user_idফেরত দেয় সেটি। এর থেকে বোঝা যায় কমেন্টটি কোন অ্যাকাউন্টের। - entry[].time: Meta কখন নোটিফিকেশন পাঠাল, Unix timestamp হিসেবে। কমেন্টটি কখন লেখা হয়েছিল তা এটি নয়।
- changes[].field: comments, বা লাইভ সম্প্রচারের জন্য
live_comments। value পড়ার আগে এটি যাচাই করুন। - value.id: কমেন্টের ID, যেটি দিয়ে প্রকাশ্যে বা ব্যক্তিগতভাবে রিপ্লাই, লুকানো বা মুছে ফেলা হয়।
- value.text: কমেন্টের লেখা, যখন কমেন্টে লেখা থাকে।
- value.from.id ও value.from.username: লেখকের Instagram-scoped ID ও ইউজারনেম। অ্যাকাউন্ট নিজে কমেন্ট লিখলে value.from.
self_ig_scoped_idআসে। - value.media.id ও value.media.
media_product_type: যে মিডিয়ায় কমেন্ট হয়েছে এবং তার জায়গা; Meta-র মিডিয়া রেফারেন্স AD, FEED, STORY ও REELS নাম দেয়। - value.
parent_id: রিপ্লাইয়ের ক্ষেত্রে, যে কমেন্টের উত্তর দেওয়া হয়েছে তার ID। সর্বোচ্চ স্তরের কমেন্টে এটি থাকে না। - value.media.
ad_id,ad_titleওoriginal_media_id: রেফারেন্সে বিজ্ঞাপনে করা কমেন্টের জন্য তালিকাভুক্ত।
comments ফিল্ড কী রিপোর্ট করে না?
একটি হ্যান্ডলার যা আশা করতে পারে তার কিছু জিনিস ইভেন্টে বাদ থাকে, অথবা কখনো পাঠানোই হয় না, Meta-র সেটআপ গাইড ও রেফারেন্স অনুযায়ী:
- ব্যক্তিগত অ্যাকাউন্টের মালিকানাধীন মিডিয়ায় কমেন্ট: এগুলোর জন্য Meta কোনো কমেন্ট বা মেনশন নোটিফিকেশন পাঠায় না।
- অ্যালবাম ID: ইভেন্টে এগুলো থাকে না, এবং Meta বলে কমেন্ট ID দিয়ে অ্যালবাম খুঁজতে হবে।
- ডাইনামিক বিজ্ঞাপনে ব্যবহৃত মিডিয়ার জন্য বিজ্ঞাপনের ID।
- কমেন্টের তৈরির সময়: GET /<
COMMENT_ID>?fields=timestamp ISO 8601 ফরম্যাটে এটি ফেরত দেয়। - সম্প্রচার শেষ হওয়ার পর লাইভ কমেন্ট, যখন লাইভ মিডিয়ার নোটিফিকেশন বন্ধ হয়ে যায়।
- স্টোরি মেনশন, যা Meta-র মেনশন API সমর্থন করে না; এগুলো বরং DM হিসেবে অ্যাকাউন্টে পৌঁছায়।
- অতীতের ইভেন্ট: Meta কোনো নোটিফিকেশন ইতিহাস রাখে না যে কোয়েরি করা যাবে, তাই প্রতিটি আসার সাথে প্রয়োজনীয় তথ্য সংরক্ষণ করুন।
comments ফিল্ডের কী দরকার?
Instagram Login-এর সাথে permission-গুলো instagram_business_basic ও instagram_business_manage_comments, এবং Advanced Access, যা Meta comments ও live_comments নোটিফিকেশনের জন্য বাধ্যতামূলক করে। অ্যাপকে App Dashboard-এ Live থাকতে হবে এবং comments-এ সাবস্ক্রাইব করা থাকতে হবে, আর প্রতিটি অ্যাকাউন্টকে POST /<IG_ID>/subscribed_apps-এর মাধ্যমে সাবস্ক্রাইব করতে হবে, যার subscribed_fields-এ comments থাকে। কমেন্টের জন্য Meta এই ওয়েবহুক-কে পোলিংয়ের চেয়ে জোরালোভাবে সুপারিশ করে, কারণ এতে রেট লিমিট বাঁচে।
ইভেন্ট থেকে কমেন্টের রিপ্লাই কীভাবে দেবেন?
এটি যে ID-গুলো বহন করে সেগুলো দিয়ে। POST /<COMMENT_ID>/replies-এ message ফিল্ড সহ value.id ব্যবহার করে কমেন্টের নিচে প্রকাশ্য রিপ্লাই যায়। POST /<IG_ID>/messages-এ recipient.comment_id-কে value.id-তে সেট করলে লেখককে একটি ব্যক্তিগত রিপ্লাই যায়, কমেন্টের 7 দিনের মধ্যে, অথবা লাইভ চলাকালীন সম্প্রচার থাকা পর্যন্ত। from.id একটি Instagram-scoped ID, কিন্তু সরাসরি সেটিতে DM পাঠালে তা ব্যর্থ হয়, যতক্ষণ না ব্যক্তিটি অ্যাকাউন্টে মেসেজ না পাঠায়; তাই ব্যক্তিগত রিপ্লাই হলো DM-এ তাদের কাছে পৌঁছানোর উপায়।
easyCoexistence কীভাবে কমেন্ট ফরওয়ার্ড করে?
একবার Claude বা ChatGPT থেকে set_social_webhook_destination দিয়ে, অথবা Partner API-তে PUT /channels/:id/webhook দিয়ে অ্যাকাউন্টের জন্য একটি এন্ডপয়েন্ট সেট করা হলে, তা আসার সঙ্গে সঙ্গে। easyCoexistence প্রতিটি সংযুক্ত অ্যাকাউন্টকে সেই ফিল্ডগুলোতে সাবস্ক্রাইব করে যেগুলো তার কমেন্ট, মেনশন ও DM বহন করে, প্রতিটি ডেলিভারিতে Meta-র সিগনেচার যাচাই করে, সাথে সাথে Meta-কে উত্তর দেয়, এবং সেই অ্যাকাউন্টের প্রতিটি entry একটি envelope-এর ভেতরে আপনার HTTPS URL-এ POST করে:
- platform ও
external_id: instagram, এবং অ্যাকাউন্টের Instagram ID, যা entry.id-র সমান। account_id: easyCoexistence-এ সংযোগের ID, যেটিlist_social_accountsফেরত দেয় এবং MCP টুলগুলো নেয়।- entry: অ্যাকাউন্টের জন্য Meta-র entry, অপরিবর্তিত, তাই একটি ব্যাচ ডেলিভারি প্রতি entry-র জন্য একটি POST হয়ে যায়। Meta-র object ফিল্ড ও X-Hub-Signature-256 পাঠানো হয় না।
- ডেলিভারি: একবারের চেষ্টা, সর্বোচ্চ 8 সেকেন্ড অপেক্ষা, কোনো redirect অনুসরণ ছাড়া, এমন একটি HTTPS ঠিকানায় যা একটি পাবলিক IP-তে রেজলভ হয়। কোনো কপি রাখা হয় না এবং কিছু আবার চেষ্টা করা হয় না।
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793448001,v1=<HEX_HMAC_SHA256>
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": { "id": "<INSTAGRAM_SCOPED_ID>", "username": "<USERNAME>" },
"media": { "id": "<MEDIA_ID>", "media_product_type": "FEED" }
}
}
]
}
}কমেন্ট-থেকে-DM নিয়ম একই ইভেন্টে কী করে?
এগুলো ফরওয়ার্ডের সাথে একসাথে পড়ে। একটি নিয়ম মেলে যখন কমেন্টে তার কোনো কীওয়ার্ড থাকে, বড় হাতের বা ছোট হাতের হিসাব না করে, একটি বেছে নেওয়া পোস্টে বা সবগুলোতে, এবং নিয়মের DM লেখককে তার ব্যক্তিগত রিপ্লাই হিসেবে পাঠায়, নিয়মে প্রকাশ্য রিপ্লাই থাকলে তাও যোগ হয়। অ্যাকাউন্ট নিজের কমেন্ট বাদ দেওয়া হয়, কমেন্ট থেকে শুরু হওয়া অটোমেশন সেগুলো নেয় যেগুলোতে কোনো নিয়ম উত্তর দেয়নি, এবং যে কমেন্টের উত্তর কোনো নিয়ম দিয়েছে তাও আপনার এন্ডপয়েন্টে পৌঁছায়। নিয়মের প্রকাশ্য রিপ্লাই অ্যাকাউন্ট থেকে একটি নতুন comments ইভেন্ট হিসেবে ফিরে আসতে পারে।
সাধারণ ভুলগুলো
- comment_id খোঁজা। Instagram Login-এর অধীনে কমেন্টের ID থাকে value.id-তে; comment_id হলো Meta-র অন্য লগইন সেটআপের পেলোডের অংশ।
- অ্যাকাউন্টের নিজের কমেন্টে রিপ্লাই দেওয়া। সেগুলোর রিপ্লাই comments ইভেন্ট হয়ে ফিরে আসে যেখানে from.id হয় entry.id-র সমান, এবং যে অটোমেশন সেগুলোতে রিপ্লাই দেয় সে নিজের সাথেই কথা বলে যায়।
- entry.time-কে কমেন্টের সময় ধরা। এটি রেকর্ড করে কখন Meta নোটিফিকেশন পাঠাল; কমেন্টের নিজস্ব timestamp ফিল্ড বলে কখন লেখা হয়েছিল।
- comments ফিল্ডে লাইভ কমেন্টের অপেক্ষা। সেগুলো আসে live_comments-এ, যার নিজস্ব সাবস্ক্রিপশন দরকার এবং সম্প্রচার শেষ হলে নীরব হয়ে যায়।
কমেন্ট-থেকে-DM নিয়ম ও অটোমেশন একই কমেন্টগুলোতে দিনরাত রিপ্লাই দেয়। প্রতি সংযোগে, প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ যত যোগ হবে তত কমে যায়, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
Instagram কমেন্ট ওয়েবহুকে কি কমেন্টের রিপ্লাইও থাকে?
হ্যাঁ। একটি রিপ্লাই নিজস্ব comments ইভেন্ট হিসেবে আসে, যাতে parent_id থাকে, যে কমেন্টের উত্তর দেওয়া হয়েছে তার ID।
রিলের কমেন্ট কি Instagram কমেন্ট ওয়েবহুক চালু করে?
হ্যাঁ। রিলের কমেন্ট পোস্টের কমেন্টের মতোই comments ফিল্ডে আসে, এবং media.media_product_type দুটোকে আলাদা করে।
আমার Instagram কমেন্ট ওয়েবহুক কেন চালু হচ্ছে না?
বেশিরভাগ সময় অ্যাপ Live নয় বা Advanced Access নেই, অ্যাকাউন্টটি কখনো /subscribed_apps দিয়ে সাবস্ক্রাইব হয়নি, মিডিয়াটি ব্যক্তিগত অ্যাকাউন্টের, অথবা কমেন্টটি লাইভ সম্প্রচারে ছিল, যা live_comments ব্যবহার করে।
কমেন্ট ওয়েবহুক কি কমেন্টকারীর ইউজারনেম অন্তর্ভুক্ত করে?
হ্যাঁ। value.from-এ ব্যক্তির ইউজারনেমের পাশে তার Instagram-scoped ID থাকে, তাই কে কমেন্ট করেছে তা দেখাতে অতিরিক্ত কল লাগে না।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে