লগ ইনফ্রি ট্রায়াল শুরু করুন
easyCoexistence অফিসিয়াল API

Instagram ওয়েবহুক ইভেন্ট: কমেন্ট, মেনশন ও DM

Instagram ওয়েবহুক ইভেন্ট প্রফেশনাল অ্যাকাউন্টের কার্যকলাপ ঘটার সঙ্গে সঙ্গে জানায়: নতুন কমেন্ট, @মেনশন ও DM। Meta প্রতিটি ইভেন্ট JSON হিসেবে সংযুক্ত অ্যাপের HTTPS এন্ডপয়েন্টে POST করে এবং সেই এন্ডপয়েন্টে ব্যর্থ ডেলিভারি সর্বোচ্চ 36 ঘণ্টা পর্যন্ত আবার চেষ্টা করে। easyCoexistence প্রতিটি ইভেন্ট একবারই আপনার এন্ডপয়েন্টে পাঠায়, প্রতিটি অ্যাকাউন্টের জন্য আলাদা স্বাক্ষরসহ, এবং কোনো পুনরায় চেষ্টা করে না। Instagram Login ব্যবহার করলে মেনশন কমেন্ট নোটিফিকেশনের ভেতরেই আসে।

36 hours

ব্যর্থ ডেলিভারি অ্যাপের এন্ডপয়েন্টে পাঠাতে Meta কতক্ষণ আবার চেষ্টা করে, তারপর সেটি বাদ দেওয়া হয়।

1,000

বেশিরভাগ আপডেট Meta একটি ওয়েবহুক ডেলিভারিতে একসঙ্গে পাঠায়, যদিও ব্যাচিং নিশ্চিত করে না।

is_echo

অ্যাকাউন্ট নিজে যে মেসেজ পাঠিয়েছে, সেই মেসেজ-ইভেন্টে Meta একটি ফ্ল্যাগ বসায়।

Public

কেবল পাবলিক অ্যাকাউন্টের মিডিয়াই কমেন্ট ও মেনশনের নোটিফিকেশন চালু করে।

কোন কোন ইভেন্ট আছে?

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। নতুন কমেন্ট দেখতে এমন:

A forwarded comment event
{
  "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 মিনিটের চেয়ে পুরনো টাইমস্ট্যাম্প বাতিল করুন।

Node.js: verifying X-EC-Signature
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_echo true থাকা মেসেজ ইভেন্ট অ্যাকাউন্ট নিজেই পাঠিয়েছে, তাই উত্তর দেওয়ার দরকার নেই।
  • 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 দিয়ে এটি করা

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 মেনশনগুলো কমেন্ট নোটিফিকেশনের ভেতরে পাঠায়, তাই সেগুলো কমেন্টের একই পথে আসে।

আরও পড়ুন

API-এর মাধ্যমে Instagram কমেন্ট মডারেশনInstagram-এর API কমেন্ট পড়ে, উত্তর দেয়, লুকায় ও মুছে: প্রকাশ্যে উত্তর, প্রতি কমেন্টে 7 দিনের মধ্যে একটি ব্যক্তিগত উত্তর এবং নিয়মগুলো।API-এর মাধ্যমে Instagram DM এবং 24 ঘণ্টার উইন্ডোAPI-এর মাধ্যমে Instagram DM কীভাবে কাজ করে: কে মেসেজ পাঠাতে পারে, 24 ঘণ্টার উইন্ডো, প্রাইভেট রিপ্লাই এবং Allow access to messages সেটিংস।Instagram API ত্রুটি: সাধারণ কোডগুলোর মানে কীInstagram API-এর সাধারণ ত্রুটি ও তাদের অর্থ: মেয়াদোত্তীর্ণ টোকেন, রেট লিমিট, Meta আনতে পারে না এমন মিডিয়া, প্রকাশের সীমা এবং বন্ধ DM উইন্ডো।কোন Instagram অ্যাকাউন্ট API-এর সাথে কাজ করে: ব্যবসায়িক, ক্রিয়েটর বা ব্যক্তিগতInstagram API পেশাদার অ্যাকাউন্টে কাজ করে: ব্যবসায়িক বা ক্রিয়েটর। কোনটি বেছে নেবেন, পরিবর্তনে কী বদলায় এবং অ্যাপে কীভাবে পাল্টাবেন।Instagram কমেন্ট ওয়েবহুক: পেলোড, প্রতিটি ফিল্ড ধরে ধরেInstagram-এর কমেন্ট ওয়েবহুক কী পাঠায় যখন কেউ পোস্ট বা রিলসে কমেন্ট করে: প্রতিটি ফিল্ডসহ পেলোড, কী বাদ থাকে এবং সতর্কতা।Instagram মেসেজ ওয়েবহুক: DM পেলোড, ইকো এবং ফিল্ডInstagram-এর মেসেজ ওয়েবহুক DM-এর জন্য কী পাঠায়: প্রেরকের আইডি, টেক্সট, অ্যাটাচমেন্ট, Story রিপ্লাই ও ইকো, এবং 24 ঘণ্টার উইন্ডো।

দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।

প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।

  • 3 দিন ফ্রি
  • যেকোনো সময় বাতিল করুন
  • শুধুমাত্র অফিশিয়াল API
  • 24/7 পর্যবেক্ষণ

যাচাই করা হয়েছে