Instagram মেসেজ ওয়েবহুক: DM পেলোড, ইকো এবং ফিল্ড
Instagram-এর মেসেজ ওয়েবহুক ফিল্ডটি প্রফেশনাল অ্যাকাউন্টের DM গুলো আসার সাথে সাথেই পাঠায়: টেক্সট, অ্যাটাচমেন্ট, শেয়ার, Story রিপ্লাই ও মেনশন, ইনলাইন রিপ্লাই এবং মুছে ফেলা মেসেজ। প্রতিটি ইভেন্ট একটি messaging অ্যারেতে থাকে, সাথে প্রেরকের Instagram-স্কোপড আইডি, প্রাপক, timestamp এবং একটি message অবজেক্ট। অ্যাকাউন্ট নিজে যে মেসেজ পাঠায় সেগুলোও একই ফিল্ডে ফিরে আসে, তখন is_echo সেট থাকে true।
easyCoexistence প্রতিটি সংযুক্ত Instagram অ্যাকাউন্টকে messages-এ সাবস্ক্রাইব করে এবং তার DM গুলো, ইকোসহ, আসার সাথে সাথে আপনার HTTPS এন্ডপয়েন্টে ফরওয়ার্ড করে, সেই অ্যাকাউন্টের সিক্রেট দিয়ে স্বাক্ষরিত; ফরওয়ার্ডিং কোনো কপি রাখে না, এবং ডিফল্টভাবে DM সংরক্ষণ করা হয় না।
অ্যাকাউন্টের নিজের পাঠানো মেসেজের জন্য মেসেজ ইভেন্টে এটি true সেট করা থাকে।
বেশিরভাগ ব্যবহারকারী-কর্মের জন্য স্ট্যান্ডার্ড মেসেজিং উইন্ডো, যার মধ্যে অ্যাপ ব্যক্তিকে রিপ্লাই দিতে পারে।
শেয়ার করা পোস্টের অ্যাটাচমেন্ট টাইপ; পুরনো শেয়ার টাইপ শুধু 1 ফেব্রুয়ারি 2026 পর্যন্ত সমর্থিত ছিল।
কেউ Story-তে অ্যাকাউন্টকে মেনশন করলে Meta যে DM ইভেন্ট পাঠায়, তার অ্যাটাচমেন্ট টাইপ।
কোড 200-এর অধীনে ত্রুটির সাবকোড, যখন অ্যাকাউন্টের মালিক Instagram ডাইরেক্ট মেসেজে অ্যাক্সেস বন্ধ করে রেখেছেন।
মেসেজ ফিল্ডটি কখন ট্রিগার হয়?
যখন কোনো ব্যক্তি প্রফেশনাল অ্যাকাউন্টকে DM পাঠান, এবং যখন অ্যাকাউন্ট নিজে একটি পাঠায়। Meta-র উদাহরণ ও রেফারেন্সে এই ক্ষেত্রগুলো তালিকাভুক্ত আছে, প্রতিটি একটি message অবজেক্টসহ একটি messaging ইভেন্ট:
- টেক্সট, এবং মিডিয়া অ্যাটাচমেন্ট হিসেবে: ছবি, ভিডিও, অডিও ও ফাইল।
- একটি শেয়ার করা পোস্ট বা Reel,
ig_post,ig_reelবা reel অ্যাটাচমেন্ট হিসেবে। - অ্যাকাউন্টের Story-তে রিপ্লাই,
reply_to.story সহ, এবং Story যেখানে অ্যাকাউন্টকে মেনশন করে,story_mentionঅ্যাটাচমেন্ট হিসেবে। - আগের মেসেজের ইনলাইন রিপ্লাই,
reply_to.mid সহ, এবং একটি কুইক রিপ্লাই,quick_reply.payload সহ। - ব্যক্তির মুছে ফেলা মেসেজ (
is_deleted), অসমর্থিত মিডিয়া (is_unsupported), এবং Click-to-Direct বিজ্ঞাপনে ক্লিক করা কারো মেসেজ (referral)। - অ্যাকাউন্টের পাঠানো মেসেজ, যা
is_echotrue সহ ফিরে আসে।
মেসেজ নোটিফিকেশন দেখতে কেমন?
একটি POST, যার JSON-এ object সেট থাকে instagram। কমেন্টের মতো নয়, মেসেজ অ্যাকাউন্টের entry-র ভেতরে একটি messaging অ্যারেতে থাকে, এবং প্রতিটি উপাদানে sender, recipient, timestamp ও message থাকে। অ্যাকাউন্টের Story-তে একটি রিপ্লাই দেখতে এমন:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<MESSAGE_TEXT>",
"reply_to": {
"story": {
"url": "<CDN_URL_FOR_THE_STORY>",
"id": "<STORY_ID>"
}
}
}
}
]
}
]
}প্রতিটি ফিল্ডের মানে কী?
Instagram Login-এর অধীনে একটি message ইভেন্টের জন্য Meta যে ফিল্ডগুলো ডকুমেন্ট করে, বাইরে থেকে ভেতরের দিকে:
- entry[].id: প্রফেশনাল অ্যাকাউন্টের আইডি। entry[].time: Meta কখন নোটিফিকেশন পাঠিয়েছে; Meta-র মেসেজিং স্যাম্পলে এটি মিলিসেকেন্ডে দেওয়া থাকে।
- sender.id ও recipient.id: আসা DM-এ ব্যক্তির Instagram-স্কোপড আইডি ও অ্যাকাউন্টের আইডি; ইকোতে ঠিক উল্টো দিকে সেই দুটোই।
- timestamp: মেসেজ কখন পাঠানো হয়েছে, Meta-র স্যাম্পলে মিলিসেকেন্ডে। আগমনের ক্রম নয়, এটি দিয়ে মেসেজ সাজান।
- message.mid: মেসেজের আইডি, ডুপ্লিকেট বাদ দিতে, রিঅ্যাক্ট করতে, এবং
reply_to.mid দিয়ে সেই মেসেজে রিপ্লাই দিতে। - message.text: মেসেজে টেক্সট থাকলে এটি অন্তর্ভুক্ত থাকে।
- message.attachments[]: প্রতিটিতে একটি type ও একটি পেলোড থাকে, সাধারণত একটি url। শেয়ার করা পোস্টের
ig_postপেলোডেig_post_media_idও title যোগ হয়, title হলো তার ক্যাপশন। - message.
reply_to: ইনলাইন রিপ্লাইয়ের জন্য mid, বা Story রিপ্লাইয়ের জন্য story, যাতে Story-র url ও id থাকে। - message.
quick_reply.payload ও message.referral: বেছে নেওয়া কুইক রিপ্লাই, এবং Click-to-Direct বিজ্ঞাপনের ref,ad_id, source, type ওads_context_data। - message.
is_deleted,is_echo,is_selfওis_unsupported: শুধু true হলেই অন্তর্ভুক্ত থাকে। - message.
admin_textওhandoff_reason: যোগ্য অ্যাপে, একটি নোটিশ যে Meta Business Agent-এর মতো একটি Meta অ্যাপ কথোপকথনটি হস্তান্তর করেছে; এতে mid বা text না-ও থাকতে পারে।
ইকো কীভাবে কাজ করে?
অ্যাকাউন্ট যখন একটি মেসেজ পাঠায়, Meta তার জন্য একটি messages ইভেন্টও পাঠায়, যেখানে is_echo true থাকে। তখন sender.id হয় অ্যাকাউন্ট এবং recipient.id হয় ব্যক্তির Instagram-স্কোপড আইডি, এবং অ্যাকাউন্ট নিজেকে যে টেস্ট মেসেজ পাঠায় তাতে is_self-ও থাকে। ইকো রেকর্ড রাখে অ্যাকাউন্ট কী বলেছে, যা একটি কথোপকথন লগের প্রয়োজন, কিন্তু রিপ্লাই দেওয়া হবে কিনা সিদ্ধান্ত নেওয়া হ্যান্ডলারকে ইকো বাদ দিতে হয়। অ্যাকাউন্ট কোনো মেসেজে রিঅ্যাক্ট করলে বা রিঅ্যাকশন সরালে Meta কোনো ইকো পাঠায় না।
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448061203,
"messaging": [
{
"sender": { "id": "<IG_ID>" },
"recipient": { "id": "<IGSID>" },
"timestamp": 1793448060950,
"message": {
"mid": "<MESSAGE_ID>",
"text": "<REPLY_TEXT>",
"is_echo": true
}
}
]
}
]
}কোন আইডিতে রিপ্লাই দেবেন?
sender.id, ব্যক্তির Instagram-স্কোপড আইডি। কেউ অ্যাকাউন্টকে মেসেজ করলে বা তার মিডিয়ায় কমেন্ট করলে Meta এটি তৈরি করে, এবং এটি সেই ব্যক্তি ও সেই অ্যাকাউন্টের জন্য নির্দিষ্ট। recipient.id এটিতে সেট করে POST /<IG_ID>/messages পাঠালে রিপ্লাই যায়। ইভেন্টে কোনো নাম বা ইউজারনেম থাকে না; name ও username-এর মতো ফিল্ডসহ GET /<IGSID> নাম ও ইউজারনেম ফেরত দেয়, কারণ যে ব্যক্তি অ্যাকাউন্টকে মেসেজ করেছে সে সেই লুকআপের প্রয়োজনীয় সম্মতি দিয়েছে।
একটি মেসেজ কীভাবে 24 ঘণ্টার উইন্ডো খোলে?
ব্যক্তি অ্যাকাউন্টকে মেসেজ করার পরেই একটি অ্যাপ তাকে মেসেজ পাঠাতে পারে, এবং যে কর্মটি উইন্ডো খোলে তার স্ট্যান্ডার্ড মেসেজিং উইন্ডোর মধ্যে। বেশিরভাগ কর্মের জন্য এটি 24 ঘণ্টা, এবং Click-to-Direct বিজ্ঞাপনে ক্লিকের পরে পাঠানো প্রথম মেসেজ থেকে সর্বোচ্চ 7 দিন। ব্যক্তির নতুন মেসেজ একটি নতুন উইন্ডো খোলে, তাই তার সর্বশেষ timestamp-টিই ট্র্যাক করতে হবে; ইকো হলো অ্যাকাউন্টের নিজের মেসেজ, তাই এটি কোনো উইন্ডো বাড়ায় না। ব্যক্তির লেখা রিপ্লাইয়ে Meta-র আলাদা 7 দিনের Human Agent উইন্ডো ব্যবহার করা যায়, যা human_agent ট্যাগ দিয়ে চিহ্নিত।
মেসেজ ইভেন্টে কী থাকে না?
Meta-র মেসেজিং রেফারেন্স অনুযায়ী হ্যান্ডলার যা খুঁজতে পারে এমন কিছু জিনিস অনুপস্থিত:
- ব্যক্তির নাম বা ইউজারনেম: শুধু Instagram-স্কোপড আইডি, যা GET /<IGSID> সমাধান করে।
- একবার-দেখার মিডিয়া: এটি URL ছাড়া একটি ক্ষণস্থায়ী অ্যাটাচমেন্ট হিসেবে আসে।
- সঠিক ক্যারোসেল ছবি: ক্যারোসেল পোস্টের একটি ছবিতে রিঅ্যাকশন বা ফরওয়ার্ড করলে প্রথম ছবিটি রিপোর্ট হয়।
- রিঅ্যাকশন, এডিট ও রিড রিসিপ্ট: এগুলো নিজস্ব ফিল্ডে আসে।
- রিড মার্ক: ওয়েবহুকে পৌঁছানো মেসেজ রিপ্লাই না যাওয়া পর্যন্ত Instagram ইনবক্সে অপঠিত থাকে।
Meta আর কোন মেসেজিং ফিল্ড তালিকাভুক্ত করে?
Instagram Login-এর জন্য Meta-র ফিল্ড তালিকা ও উদাহরণে messages ছাড়াও এগুলো আছে, প্রতিটি নিজস্ব একটি messaging ইভেন্ট। easyCoexistence প্রতিটি অ্যাকাউন্টকে শুধু messages, comments ও mentions-এ সাবস্ক্রাইব করে, তাই এগুলোর কোনোটিই এটি ফরওয়ার্ড করে না:
message_reactions: ব্যক্তি একটি মেসেজে রিঅ্যাক্ট করে বা রিঅ্যাকশন সরায়, reaction.mid সহ, action সেট react বা unreact, এবং reaction ও emoji।message_edit: ব্যক্তি একটি মেসেজ এডিট করে,message_edit.mid, নতুন টেক্সট ওnum_editসহ।messaging_postbacks: ব্যক্তি একটি আইসব্রেকার বা টেমপ্লেট বাটনে ট্যাপ করে, postback.mid, title ও পেলোড সহ।messaging_referral: কথোপকথনে থাকা ব্যক্তি ref প্যারামিটারসহ একটি ig.me লিংক খোলে।messaging_seen: ব্যক্তি একটি মেসেজ পড়ে, read.mid সহ।messaging_optins,messaging_handoverও standby: শেষ দুটি Meta-র হ্যান্ডওভার প্রোটোকলের অধীনে কথোপকথন ভাগ করা অ্যাপের জন্য।
অ্যাকাউন্টে কী চালু করতে হবে?
Meta-র নিয়ম অনুযায়ী প্রফেশনাল অ্যাকাউন্টে প্রথমে Allow access to messages চালু করতে হয়, তারপরেই API-র মাধ্যমে তার মেসেজ পরিচালনা করা যায়। Instagram অ্যাপে এটি থাকে Settings, Messages and story replies, Message controls, Connected tools-এর অধীনে। এটি বন্ধ থাকলে পাঠানো ব্যর্থ হয়, কোড 200 ও সাবকোড 2534041 সহ। অ্যাপের instagram_business_basic ও instagram_business_manage_messages দরকার, এবং যে অ্যাকাউন্ট সে মালিক বা পরিচালনা করে না তাতে সেবা দিতে Advanced Access লাগে।
easyCoexistence কীভাবে DM ফরওয়ার্ড করে?
কমেন্টের মতোই: Meta অ্যাকাউন্টের জন্য যে প্রতিটি entry পাঠায়, তা platform, account_id, external_id ও entry-এর একটি এনভেলপে আপনার HTTPS এন্ডপয়েন্টে POST হয়, অ্যাকাউন্টের সিক্রেট দিয়ে X-EC-Signature-এ স্বাক্ষরিত, একবার, এবং কোনো কপি রাখা হয় না। ইকোগুলোও বাকিগুলোর সাথে ফরওয়ার্ড হয়, তাই রিপ্লাই দেওয়ার আগে is_echo যাচাই করুন। রিপ্লাই দিতে, 24 ঘণ্টার উইন্ডোর ভেতরে, account_id এবং ইভেন্টের sender.id-কে recipient_id হিসেবে দিয়ে send_social_dm কল করুন। DM দিয়ে শুরু হওয়া অটোমেশনগুলো একই ইভেন্টে চলে।
{
"platform": "instagram",
"account_id": "<ACCOUNT_ID>",
"external_id": "<IG_ID>",
"entry": {
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"message": {
"mid": "<MESSAGE_ID>",
"attachments": [
{ "type": "image", "payload": { "url": "<URL_FOR_THE_MEDIA>" } }
]
}
}
]
}
}সাধারণ ভুলগুলো
- ইকোতে রিপ্লাই দেওয়া। যে ইভেন্টে is_echo সেট, তা অ্যাকাউন্টের নিজের মেসেজ, এবং তাতে রিপ্লাই দিলে অ্যাকাউন্ট নিজের সাথেই একটি লুপে পড়ে যায়।
- ধরে নেওয়া যে মেসেজে সবসময় টেক্সট থাকে। অ্যাটাচমেন্ট, শেয়ার, Story মেনশন ও মুছে ফেলা মেসেজে কোনো text ফিল্ড থাকে না, তাই message অবজেক্টে যা আছে সেই অনুযায়ী শাখা তৈরি করুন।
- আগমন অনুযায়ী মেসেজ সাজানো। ব্যর্থতার পরে Meta মেসেজ ক্রমের বাইরে পাঠাতে পারে, তাই timestamp অনুযায়ী সাজান।
- time ও timestamp-কে সেকেন্ড ধরে পার্স করা। Meta-র মেসেজিং স্যাম্পলে দুটোই মিলিসেকেন্ডে, সেকেন্ড ধরলে সেগুলো বহু দূরের ভবিষ্যতের তারিখ হয়ে যায়।
send_social_dm 24 ঘণ্টার উইন্ডোর ভেতরে রিপ্লাই দেয়, আর অটোমেশন নিজে থেকে নির্দিষ্ট টেক্সট বা AI দিয়ে রিপ্লাই দিতে পারে। প্রতি সংযোগে মাসে US$ 9 থেকে US$ 0.75 পর্যন্ত, সংযোগ যত বাড়বে তত কমে, প্রথম 3 দিন ফ্রি।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
Instagram মেসেজ ওয়েবহুকের timestamp কি সেকেন্ডে না মিলিসেকেন্ডে?
মিলিসেকেন্ডে, Meta-র মেসেজিং স্যাম্পলে timestamp ও entry time দুটোই। সেকেন্ড ধরে পড়লে সেগুলো বহু দূরের ভবিষ্যতের তারিখ হয়ে যায়।
Instagram DM ওয়েবহুক থেকে প্রেরকের ইউজারনেম কীভাবে পাব?
GET /<IGSID> কল করুন, সাথে name ও username-এর মতো ফিল্ড দিয়ে। ইভেন্টে শুধু ব্যক্তির Instagram-স্কোপড আইডি থাকে।
আমার Instagram DM ওয়েবহুক কেন আসছে না?
যাচাই করুন অ্যাকাউন্টে Allow access to messages চালু আছে কিনা, /subscribed_apps-এর মাধ্যমে messages-এ সাবস্ক্রাইব আছে কিনা, এবং অ্যাপটি Advanced Access সহ Live আছে কিনা, যেসব অ্যাকাউন্ট সে মালিক নয় তাদের জন্য।
easyCoexistence কি Instagram মেসেজের রিঅ্যাকশন ফরওয়ার্ড করে?
না। রিঅ্যাকশন আসে message_reactions-এ, এবং easyCoexistence অ্যাকাউন্টকে শুধু messages, comments ও mentions-এ সাবস্ক্রাইব করে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে