messages ওয়েবহুকে Instagram DM অ্যাটাচমেন্ট
Instagram-এর messages ওয়েবহুক DM মিডিয়া বহন করে message.attachments-এ: প্রতিটি টাইপ ও পেলোড সহ অবজেক্টের একটি অ্যারে, যেখানে সাধারণত CDN URL থাকে। Meta-র Instagram Login তালিকায় image, video, audio, file, ig_post, ig_reel, reel, story_mention, media, story, ig_story এবং পুরনো share উল্লেখ আছে, আর একবার দেখার মিডিয়া একটি ক্ষণস্থায়ী অ্যাটাচমেন্ট হিসেবে আসে যার কোনো URL নেই।
easyCoexistence প্রতিটি সংযুক্ত Instagram অ্যাকাউন্টকে messages-এ সাবস্ক্রাইব করে এবং অ্যাটাচমেন্টসহ DM গুলো Meta যেভাবে পাঠায় সেভাবে আপনার HTTPS এন্ডপয়েন্টে ফরওয়ার্ড করে, সেই অ্যাকাউন্টের গোপন কী দিয়ে স্বাক্ষরিত, এবং কোনো কপি রাখা হয় না, তাই আপনার এজেন্ট বা কোড প্রয়োজনীয় মিডিয়া নিজে আনে।
শেয়ার করা পোস্টের অ্যাটাচমেন্ট ধরন; এর পেলোডে ig_post_media_id ও title, অর্থাৎ পোস্টের ক্যাপশন, url-এর পাশে যোগ হয়।
কবে থেকে পুরনো share অ্যাটাচমেন্ট ধরনটি Instagram পোস্ট শেয়ারের জন্য আর সমর্থিত নয়।
স্বয়ংক্রিয়ভাবে মুছে যাওয়া, একবার দেখার মিডিয়ার অ্যাটাচমেন্ট ধরন, যা কোনো URL ছাড়া আসে।
মেসেজ ইভেন্টে true সেট হয়, যখন মেসেজে অসমর্থিত মিডিয়া থাকে।
কেউ ক্যারোসেল পোস্টের একটি ছবিতে রিঅ্যাকশন দিলে বা ফরওয়ার্ড করলে বিজ্ঞপ্তিতে কী জানানো হয়।
কোন কোন অ্যাটাচমেন্ট ধরন একটি DM ইভেন্ট বহন করতে পারে?
Meta-র Instagram Login উদাহরণ message.attachments[].type-এর এই মানগুলো তালিকাভুক্ত করে, প্রতিটির সঙ্গে একটি পেলোড অবজেক্ট। বেশিরভাগ পেলোডে Meta-র CDN-এ মিডিয়ার একটি url থাকে, আর Meta শুধু ig_post-এর জন্য অতিরিক্ত পেলোড ফিল্ড নথিভুক্ত করেছে, তাই পেলোড পড়ার আগে টাইপটি পড়ুন।
অ্যাটাচমেন্টসহ একটি DM কেমন দেখায়?
একটি messages ইভেন্ট, যার message অবজেক্টে টেক্সটের বদলে বা টেক্সটের পাশে attachments থাকে। Meta-র নমুনায় একটি মেসেজে দুটি মিডিয়া আইটেম আসে, প্রতিটির নিজস্ব type ও payload.url আছে, তাই হ্যান্ডলারকে প্রথম এলিমেন্ট না পড়ে অ্যারেটি লুপ করতে হবে:
{
"object": "instagram",
"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": "<CDN_URL>" } },
{ "type": "video", "payload": { "url": "<CDN_URL>" } }
]
}
}
]
}
]
}শেয়ার করা পোস্ট কেমন দেখায়?
একটি ig_post অ্যাটাচমেন্ট। 3 নভেম্বর 2025 থেকে Meta পোস্ট শেয়ার পাঠাতে শুরু করে, যেখানে share ও ig_post দুটি অ্যাটাচমেন্টই থাকে; পোস্টের জন্য share 1 ফেব্রুয়ারি 2026 পর্যন্ত সমর্থিত ছিল, এবং Meta বলছে নতুন ইন্টিগ্রেশনকে অবশ্যই ig_post সমর্থন করতে হবে। এর পেলোডে পোস্টের মিডিয়া আইডি এবং ক্যাপশন title হিসেবে যোগ হয়:
"attachments": [
{
"type": "ig_post",
"payload": {
"ig_post_media_id": "<MEDIA_ID>",
"title": "<POST_CAPTION>",
"url": "<CDN_URL>"
}
}
]প্রতিটি ফিল্ড কী বোঝায়?
একটি DM ইভেন্টের জন্য Meta যে অ্যাটাচমেন্ট ফিল্ডগুলো নথিভুক্ত করেছে, অ্যারে থেকে নিচের দিকে:
- message.attachments[]: প্রতিটি মিডিয়া আইটেমের জন্য একটি অবজেক্ট; Meta-র নমুনায় একটি মেসেজে দুটি থাকে।
- type: আইটেমটি কী, উপরের তালিকা অনুযায়ী। পেলোড পড়ার আগে এর ভিত্তিতে কাজ আলাদা করুন।
- payload.url: মিডিয়ার জন্য একটি CDN URL। Meta-র ওভারভিউ এই URLগুলোকে গোপনীয়তা-সচেতন বলে, কনটেন্ট মুছে গেলে বা মেয়াদ শেষ হলে এগুলো আর কিছু ফেরত দেয় না।
- payload.
ig_post_media_idও payload.title: শুধুig_post-এ, শেয়ার করা পোস্টের মিডিয়া আইডি ও তার ক্যাপশন। - message.text: শুধু তখনই থাকে যখন মেসেজে টেক্সটও থাকে।
- message.
is_unsupported: true, যখন মেসেজে এমন মিডিয়া থাকে যা ওয়েবহুক সমর্থন করে না।
অ্যাটাচমেন্টের URL কতদিন কাজ করে?
Meta এগুলোকে কনটেন্টের সঙ্গে বেঁধে রাখে। ওভারভিউ বলে Instagram-এর CDN URLগুলো গোপনীয়তা-সচেতন, কনটেন্ট মুছে গেলে বা মেয়াদ শেষ হলে মিডিয়া ফেরত দেওয়া বন্ধ করে; আর স্টোরি মেনশন গাইড বলে Story-র URL Story মেয়াদ শেষ বা মুছে গেলে রেন্ডার হওয়া বন্ধ করে। যে অ্যাপের একটি ফাইল দরকার, তাকে ইভেন্ট আসার সময়ই Meta-র নিয়মের মধ্যে থেকে সেটি আনতে হবে: বিশেষ করে Story-র মিডিয়া জমা বা ক্যাশ করা যাবে না।
ওয়েবহুক কোন মিডিয়া বাদ দেয়?
Meta-র Instagram Messaging গাইড এই ফাঁকগুলোর নাম দেয়, যেগুলো হ্যান্ডলারের প্রত্যাশা করা উচিত, ত্রুটি হিসেবে না ধরে:
- মুছে যাওয়া মিডিয়া, একবার দেখার বা পুনরায় চালানোর অনুমতিসহ: ephemeral টাইপের অ্যাটাচমেন্ট, যার কোনো URL নেই।
- অসমর্থিত মিডিয়া: মেসেজ আসে
is_unsupportedtrue সেট করে। - GIF ও স্টিকার: ওই গাইড বলে এগুলো কোনো ওয়েবহুক ট্রিগার করে না, অথচ Meta-র Instagram Login উদাহরণে এগুলো image-এর অধীনে তালিকাভুক্ত।
- বেছে নেওয়া ক্যারোসেল ছবি: ক্যারোসেল পোস্টের একটি ছবিতে রিঅ্যাকশন বা ফরওয়ার্ড প্রথম ছবি হিসেবে রিপোর্ট হয়।
- সাধারণভাবে শেয়ার: Meta-র মেসেজিং গাইডগুলো এখনও বলে শুধু শেয়ার করা মিডিয়ার URL অন্তর্ভুক্ত থাকে, যদিও
ig_postএখন মিডিয়া আইডি ও ক্যাপশন যোগ করে।
easyCoexistence অ্যাটাচমেন্ট কীভাবে ফরওয়ার্ড করে?
entry-র ভেতরে অপরিবর্তিত: মিডিয়াসহ একটি DM আপনার এন্ডপয়েন্টে পৌঁছায় Meta-র attachments অ্যারে সহ, Meta যেভাবে পাঠিয়েছে ঠিক সেভাবে, platform, account_id, external_id ও entry-র একটি এনভেলপে, X-EC-Signature দিয়ে স্বাক্ষরিত। অ্যাটাচমেন্ট ডাউনলোড করা হয় না, এবং ডিফল্টভাবে ইভেন্ট সংরক্ষণ করা হয় না: কোনো অটোমেশন চালু থাকলে অ্যাকাউন্ট DM-এর টেক্সট 7 দিন রাখে, মিডিয়া নয়। ইভেন্ট আসার সময় দরকারি মিডিয়া payload.url থেকে আনুন, এবং Story-র মিডিয়া সংরক্ষণ না করে রাখুন।
সাধারণ ভুলগুলো
- শুধু প্রথম অ্যাটাচমেন্ট পড়া। message.attachments একটি অ্যারে, আর Meta-র নমুনায় একটি মেসেজে দুটি আইটেম থাকে, তাই এটি লুপ করুন।
- শেয়ার করা পোস্টের জন্য এখনও share টাইপ মেলানো। Meta পোস্টের জন্য 1 ফেব্রুয়ারি 2026 পর্যন্ত এটি সমর্থন করেছে; ig_post পড়ুন, যার পেলোডে মিডিয়া আইডি ও ক্যাপশন থাকে।
- পরে আনার জন্য payload.url সংরক্ষণ করা। কনটেন্ট মুছে গেলে বা মেয়াদ শেষ হলে এটি আর মিডিয়া ফেরত দেয় না, তাই আসার সময়ই দরকারি জিনিস ডাউনলোড করুন, Story-র মিডিয়া ছাড়া।
- type না দেখে payload.url পড়া। একবার দেখার মিডিয়া ক্ষণস্থায়ী টাইপে আসে যার কোনো URL নেই, আর অসমর্থিত মিডিয়া is_unsupported সেট করে।
send_social_dm 24 ঘণ্টার উইন্ডোর ভেতরে উত্তর দেয়। প্রতি সংযোগে প্রতি মাসে US$ 9 থেকে US$ 0.75, সংযোগ বাড়ার সঙ্গে কমে, প্রথম 3 দিন ফ্রি ট্রায়াল।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
Instagram DM অ্যাটাচমেন্টের মিডিয়া কি সংরক্ষণ করা যায়?
ইভেন্ট আসার সময় যা দরকার ডাউনলোড করুন, কারণ কনটেন্ট মুছে গেলে বা মেয়াদ শেষ হলে payload.url মিডিয়া ফেরত দেওয়া বন্ধ করে। Story-র মিডিয়া ব্যতিক্রম: Meta-র নিয়ম অনুযায়ী এটি সংরক্ষণ বা ক্যাশ করা যাবে না।
কেন Instagram DM-এর ওয়েবহুকে মিডিয়া URL থাকে না?
সাধারণত মিডিয়াটি একবার দেখার, যা ক্ষণস্থায়ী অ্যাটাচমেন্ট হিসেবে URL ছাড়া আসে, অথবা অসমর্থিত, যার ফলে is_unsupported true সেট হয়।
Instagram-এর GIF ও স্টিকার কি messages ওয়েবহুক ট্রিগার করে?
Meta-র ডকুমেন্ট পরস্পরবিরোধী: Instagram Login উদাহরণে GIF ও স্টিকার image-এর অধীনে তালিকাভুক্ত, অথচ Instagram Messaging গাইড বলে এগুলো কোনো ওয়েবহুক ট্রিগার করে না। একটি আসল অ্যাকাউন্ট দিয়ে পরীক্ষা করুন।
একটি Instagram DM ইভেন্টে কি একাধিক অ্যাটাচমেন্ট থাকতে পারে?
হ্যাঁ। message.attachments একটি অ্যারে, আর Meta-র নমুনায় একটি মেসেজে দুটি মিডিয়া আইটেম দেখানো হয়েছে।
আরও পড়ুন
দুই মিনিটে আপনার প্রথম চ্যানেল সংযুক্ত করুন।
প্ল্যাটফর্মের রিভিউয়ের জন্য অপেক্ষা করতে হবে না। WhatsApp, Instagram, TikTok বা অন্য কোনো চ্যানেল সংযুক্ত করুন, তারপর আপনার AI-কে পোস্ট করতে, রিপ্লাই দিতে বা রিপোর্ট দিতে বলুন, আর নিজের চোখে দেখুন কীভাবে কাজ করে।
- 3 দিন ফ্রি
- যেকোনো সময় বাতিল করুন
- শুধুমাত্র অফিশিয়াল API
- 24/7 পর্যবেক্ষণ
যাচাই করা হয়েছে