Instagram messages वेबहुक: DM पेलोड, इको र फिल्डहरू
Instagram को messages वेबहुक फिल्डले व्यावसायिक खाताको DM हरू आउनासाथ पठाउँछ: टेक्स्ट, एट्याचमेन्ट, शेयर, Story जवाफ र उल्लेख, इनलाइन जवाफ र मेटाइएका म्यासेज। प्रत्येक इभेन्ट messaging array भित्र बस्छ, जसमा प्रेषकको Instagram-scoped ID, प्राप्तकर्ता, टाइमस्ट्याम्प र message object हुन्छन्, र खाताले आफैँ पठाएका म्यासेज उही फिल्डमा is_echo true सेट भएर फर्किन्छन्।
easyCoexistence ले जडान गरिएको प्रत्येक Instagram खातालाई messages मा सब्स्क्राइब गर्छ र त्यसका DM हरू, इकोसहित, आउनासाथ तपाईंको HTTPS एन्डपोइन्टमा फर्वार्ड गर्छ, खाताको गोप्य कुञ्जीले हस्ताक्षर गरिएको; फर्वार्डिङले कुनै प्रतिलिपि राख्दैन, र DM हरू पूर्वनिर्धारित रूपमा भण्डारण हुँदैनन्।
खाताले आफैँले पठाएको म्यासेजको इभेन्टमा यो true सेट गरिन्छ।
अधिकांश प्रयोगकर्ता कार्यका लागि मानक म्यासेजिङ विन्डो, जसभित्र एपले व्यक्तिलाई जवाफ दिन सक्छ।
साझा पोस्टका लागि एट्याचमेन्ट प्रकार; पुरानो share प्रकार 2026 फेब्रुअरी 1 सम्म मात्र समर्थित थियो।
कसैले Story मा खाताको उल्लेख गर्दा Meta ले पठाउने DM इभेन्टको एट्याचमेन्ट प्रकार।
खाताका मालिकले Instagram direct messages को पहुँच बन्द गर्दा देखिने त्रुटि सबकोड, कोड 200 अन्तर्गत।
messages फिल्ड कहिले सक्रिय हुन्छ?
कसैले व्यावसायिक खातालाई DM पठाउँदा, र खाताले DM पठाउँदा। Meta का उदाहरण र सन्दर्भहरूमा यी अवस्थाहरू सूचीबद्ध छन्, जसमध्ये प्रत्येक message object सहितको messaging इभेन्ट हो:
- टेक्स्ट, र मिडिया एट्याचमेन्टका रूपमा: तस्बिर, भिडियो, अडियो र फाइलहरू।
- साझा गरिएको पोस्ट वा Reel, एट्याचमेन्ट प्रकार
ig_post,ig_reelवा reel मा। - खाताको Story मा दिइएको जवाफ (
reply_to.story सहित) र खातालाई उल्लेख गर्ने Story,story_mentionएट्याचमेन्टका रूपमा। - पहिलेको म्यासेजमा इनलाइन जवाफ,
reply_to.mid सहित, र quick reply,quick_reply.payload सहित। - व्यक्तिले मेटाएको म्यासेज (
is_deleted), असमर्थित मिडिया (is_unsupported), र Click-to-Direct विज्ञापनमा क्लिक गरेको व्यक्तिको म्यासेज (referral)। - खाताले पठाएको म्यासेज, जुन
is_echotrue सेट भएर फर्किन्छ।
messages सूचना कस्तो देखिन्छ?
JSON मा object instagram सेट भएको POST। टिप्पणीभन्दा फरक, म्यासेज खाताको entry भित्रको messaging array मा बस्छ, र प्रत्येक तत्वमा 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 अन्तर्गत Meta ले म्यासेज इभेन्टका लागि दस्तावेज गरेका फिल्डहरू, बाहिरबाट भित्रतिर:
- entry[].id: व्यावसायिक खाताको ID हो। entry[].time: Meta ले सूचना पठाएको समय, जुन Meta को messaging नमूनाहरूमा मिलिसेकेन्डमा दिइन्छ।
- sender.id र recipient.id: आउने DM मा व्यक्तिको Instagram-scoped ID र खाताको ID; इकोमा उही दुई उल्टो क्रममा।
- timestamp: म्यासेज पठाइएको समय, Meta का नमूनाहरूमा मिलिसेकेन्डमा। म्यासेजहरू आगमनको क्रमले होइन, यसैबाट क्रमबद्ध गर्नुहोस्।
- message.mid: म्यासेज ID, डुप्लिकेट हटाउन, प्रतिक्रिया दिन र
reply_to.mid सँग त्यही म्यासेजमा जवाफ दिन। - message.text: म्यासेजमा टेक्स्ट भएमा मात्र समावेश हुन्छ।
- message.attachments[]: प्रत्येकमा प्रकार र पेलोड हुन्छ, जसमा सामान्यतया url हुन्छ। साझा पोस्टको
ig_postपेलोडमाig_post_media_idर title थपिन्छ; title यसको क्याप्सन हो। - message.
reply_to: इनलाइन जवाफका लागि mid, वा Story जवाफका लागि Story को url र id सहितको story फिल्ड। - message.
quick_reply.payload र message.referral: चयन गरिएको quick reply, र 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 वा टेक्स्ट बिना पनि आउन सक्छ।
इकोहरू कसरी काम गर्छन्?
खाताले म्यासेज पठाउँदा, Meta ले त्यसको लागि पनि messages इभेन्ट पठाउँछ, is_echo true सेट गरेर। त्यसपछि sender.id खाता हुन्छ र recipient.id व्यक्तिको Instagram-scoped ID, र खाताले आफैलाई पठाएको परीक्षण म्यासेजमा 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
}
}
]
}
]
}कुन ID मा जवाफ दिनुहुन्छ?
sender.id, व्यक्तिको Instagram-scoped ID हो। कसैले खातालाई म्यासेज पठाउँदा वा त्यसको मिडियामा टिप्पणी गर्दा Meta ले यो बनाउँछ, र यो त्यो व्यक्ति र त्यो खातासँग मात्र सम्बन्धित हुन्छ। recipient.id मा यसलाई राखेर POST /<IG_ID>/messages गर्दा जवाफ पठाइन्छ। इभेन्टमा नाम वा username हुँदैन; name र username जस्ता फिल्डसहित GET /<IGSID> ले ती फर्काउँछ, किनभने खातालाई म्यासेज पठाएको व्यक्तिले त्यो खोजका लागि आवश्यक सहमति दिएको हुन्छ।
म्यासेजले 24 घण्टाको विन्डो कसरी खोल्छ?
एपले व्यक्तिलाई म्यासेज तब मात्र पठाउन सक्छ, जब उसले खातालाई म्यासेज पठाएको हुन्छ, र उसको कार्रवाईले खोल्ने मानक म्यासेजिङ विन्डोभित्र मात्र। अधिकांश कार्रवाईका लागि यो 24 घण्टा रहन्छ, र Click-to-Direct विज्ञापनमा क्लिक गरेपछि पठाइएको पहिलो म्यासेजबाट 7 दिनसम्म। व्यक्तिबाट नयाँ म्यासेज आए नयाँ विन्डो खुल्छ, त्यसैले तिनको सबैभन्दा पछिल्लो timestamp नै ट्र्याक गर्नुपर्छ; इको भनेको खाताको आफ्नै म्यासेज हो र त्यसले कुनै पनि विन्डो बढाउँदैन। व्यक्तिले लेखेका जवाफमा Meta को छुट्टै 7 दिनको Human Agent विन्डो प्रयोग गर्न सकिन्छ, human_agent ट्याग लगाएर।
messages इभेन्टमा कुन कुरा हुँदैन?
Meta को messaging सन्दर्भ अनुसार ह्यान्डलरले खोज्न सक्ने केही कुरा हुँदैनन्:
- व्यक्तिको नाम वा username: केवल Instagram-scoped ID, जसलाई GET /<IGSID> ले समाधान गर्छ।
- एकपटक हेर्ने मिडिया: यो URL बिना अस्थायी एट्याचमेन्टको रूपमा आउँछ।
- क्यारोसेलको सटीक तस्बिर: क्यारोसेल पोस्टको एउटा तस्बिरमा प्रतिक्रिया वा त्यसको फर्वार्ड भए पनि पहिलो तस्बिर मात्र रिपोर्ट हुन्छ।
- प्रतिक्रिया, सम्पादन र पढिएको सूचना, जुन आफ्नै फिल्डहरूमा आउँछन्।
- पढिएको चिह्न: वेबहुकबाट आएको म्यासेज जवाफ नपठाउन्जेल Instagram इनबक्समा नपढिएको रहन्छ।
Meta ले अरू कुन messaging फिल्डहरू सूचीबद्ध गर्छ?
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 र payload सहित।messaging_referral: कुराकानीमा रहेको व्यक्तिले ref प्यारामिटरसहितको ig.me लिंक खोल्छ।messaging_seen: कुनै व्यक्तिले म्यासेज पढ्छ, read.mid सहित।messaging_optins,messaging_handoverर standby: अन्तिम दुई Meta को ह्यान्डओभर प्रोटोकल अन्तर्गत कुराकानी साझा गर्ने एपहरूका लागि।
खाताले के सक्रिय गर्नुपर्छ?
“Allow access to messages” सक्रिय गर्नुहोस्। Meta ले व्यावसायिक खातालाई 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 घण्टाको विन्डोभित्र, recipient_id का रूपमा खाता account_id र इभेन्टको sender.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 उल्लेख र मेटाइएका म्यासेज टेक्स्ट फिल्डबिना आउँछन्, त्यसैले message object मा के छ त्यसअनुसार शाखा बनाउनुहोस्।
- म्यासेजलाई आगमनको क्रमले मिलाउनु। विफलतापछि Meta ले म्यासेज क्रमभन्दा बाहिर पठाउन सक्छ, त्यसैले timestamp अनुसार क्रमबद्ध गर्नुहोस्।
- समय र timestamp लाई सेकेन्डका रूपमा पार्स गर्नु। Meta को messaging नमूनाहरूले दुवै मिलिसेकेन्डमा दिन्छन्, र सेकेन्डका रूपमा पढ्दा तिनीहरू धेरै टाढाको भविष्यका मितिमा बदलिन्छन्।
send_social_dm ले 24 घण्टाको विन्डोभित्र जवाफ दिन्छ, र स्वचालनले निश्चित पाठ वा AI सँग आफैँ जवाफ दिन सक्छ। प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थप्दै जाँदा घट्दै, पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
Instagram म्यासेज वेबहुकको timestamp सेकेन्डमा हो कि मिलिसेकेन्डमा?
Meta को messaging नमूनाहरूमा timestamp र entry समय दुवै मिलिसेकेन्डमा हुन्छन्। सेकेन्डका रूपमा पढ्दा तिनीहरू धेरै टाढाको भविष्यका मितिमा बदलिन्छन्।
Instagram DM वेबहुकबाट प्रेषकको username कसरी प्राप्त गर्ने?
name र username जस्ता फिल्डसहित GET /<IGSID> कल गर्नुहोस्। इभेन्टमा व्यक्तिको Instagram-scoped ID मात्र हुन्छ।
मेरा 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 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको