इन्स्टाग्राम messaging_postbacks वेबहुक: आइस ब्रेकर र बटनहरू
इन्स्टाग्रामको messaging_postbacks वेबहुक फिल्डले, व्यावसायिक खातासँगको कुराकानीमा कुनै व्यक्तिले आइस ब्रेकर प्रश्न, टेम्प्लेटमा रहेको postback बटन वा स्थायी मेनु आइटम थिच्दा एपलाई सूचित गर्छ। इभेन्टको postback वस्तुमा title (व्यक्तिले थिचेको पाठ), पेलोड (विकल्पका लागि एपले सेट गरेको स्ट्रिङ) र mid (म्यासेज ID, Graph API v11.0 देखि) हुन्छन्।
easyCoexistence ले कनेक्सन भएका प्रत्येक इन्स्टाग्राम खातालाई टिप्पणी, म्यासेज र उल्लेखमा सदस्यता दिन्छ, र ती इभेन्टहरू, क्विक रिप्लाई थिचाइसहित, आइपुग्दा नै तपाईंको HTTPS एन्डपोइन्टमा पठाउँछ।
खाताले Meta को Ice Breaker API मार्फत सेट गर्न सक्ने आइस ब्रेकर प्रश्नहरूको अधिकतम संख्या।
postback इभेन्टहरूमा mid समावेश हुन थालेको Graph API संस्करण; फिल्ड आफैंलाई v8.0 वा पछिल्लो संस्करण चाहिन्छ।
बटन टेम्प्लेट म्यासेजमा सबैभन्दा धेरै बटनहरू, जुन प्रत्येक postback वा web_url बटन हुन सक्छन्।
व्यक्तिले स्थायी मेनु आइटम थिचेपछि प्रतिक्रिया दिन पाइने समय, जसले मानक म्यासेजिङ विन्डो खोल्छ।
एउटा म्यासेजले प्रस्ताव गर्न सक्ने क्विक रिप्लाईको अधिकतम संख्या; थिचिएको क्विक रिप्लाई messages मा आउँछ, messaging_postbacks मा होइन।
messaging_postbacks कहिले सक्रिय हुन्छ?
कुनै व्यक्तिले कुराकानीमा खाताका संरचित विकल्पहरूमध्ये एउटा थिच्दा, एप र खाता फिल्डमा सदस्यता लिएका भएमा। Meta का गाइडहरूले यी स्रोतहरू सूचीबद्ध गर्छन्:
- आइस ब्रेकर प्रश्न, कुराकानी सुरु हुँदा खाताले दिने अधिकतम 4 मध्ये एउटा। डेस्कटपमा उपलब्ध छैन।
- बटन टेम्प्लेट म्यासेजमा postback बटन, प्रति म्यासेज 3 सम्म, वा जेनेरिक टेम्प्लेटमा प्रति एलिमेन्ट 3 सम्म।
- खाताको स्थायी मेनुमा postback आइटम।
- ref प्यारामिटरसहितको ig.me लिंकबाट खोलिएको नयाँ थ्रेडमा थिचिएको आइस ब्रेकर: त्यसपछि postback ले referral पनि बोक्छ।
- सेल्फ-म्यासेजिङ परीक्षण, जहाँ खाताले आफ्नै बटन थिच्छ: इभेन्टमा
is_selftrue सेट हुन्छ।
postback सूचना कस्तो देखिन्छ?
म्यासेजको ठाउँमा postback वस्तु भएको messaging इभेन्ट, जहाँ DM को म्यासेज हुन्थ्यो। Instagram Login का लागि Meta को उदाहरणमा mid, title र पेलोड हुन्छन्, र यसको आइस ब्रेकर गाइडले mid बिनाको उही वस्तु देखाउँछ। सूचना यस्तो देखिन्छ:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000512,
"messaging": [
{
"sender": { "id": "<IGSID>" },
"recipient": { "id": "<IG_ID>" },
"timestamp": 1793447999874,
"postback": {
"mid": "<MESSAGE_ID>",
"title": "<ICE_BREAKER_QUESTION_OR_BUTTON_TITLE>",
"payload": "<PAYLOAD_SET_FOR_THE_OPTION>"
}
}
]
}
]
}प्रत्येक फिल्डको अर्थ के हो?
Meta ले postback का लागि दस्तावेज गरेका फिल्डहरू, बाहिरदेखि भित्रसम्म:
- sender.id: थिचने व्यक्तिको Instagram-scoped ID, जसलाई प्रतिक्रिया दिइन्छ। recipient.id र entry[].id: व्यावसायिक खाता।
- timestamp: व्यक्तिले कहिले थिचेको, Meta को आइस ब्रेकर गाइड अनुसार।
- postback.title: व्यक्तिले देखेको आइस ब्रेकर प्रश्न वा बटनको शीर्षक।
- postback.payload: त्यो विकल्प सिर्जना गर्दा सेट गरिएको स्ट्रिङ, जुन एपले छनोट गर्छ।
- postback.mid: थिचाइले खातामा पठाएको म्यासेजको ID, Graph API v11.0 देखि।
- postback.referral: ref, source र type, जब थ्रेड ref प्यारामिटरसहितको ig.me लिंकबाट खोलियो।
is_self: postback सँगै, सेट भएको true, जब खाताले सेल्फ-म्यासेजिङ परीक्षणमा आफ्नै बटन थिच्छ।
आइस ब्रेकर कसरी सेट गरिन्छ?
graph.instagram.com मा POST /<IG_ID>/messenger_profile मार्फत: platform लाई instagram सेट गरेर, र ice_breakers array सहित, जसको call_to_actions मा प्रश्न र payload का जोडीहरू 4 सम्म हुन्छन्, र प्रत्येक अनुवादित सेटको लागि locale। GET /me/messenger_profile?fields=ice_breakers ले तिनीहरूको सूची देखाउँछ, र fields लाई ice_breakers सेट गरेर DELETE गर्दा तिनीहरू हटाइन्छन्। यहाँ छनोट गरिएको पेलोड नै प्रश्न थिचिँदा messaging_postbacks ले फर्काउने मान हो।
POST https://graph.instagram.com/<IG_ID>/messenger_profile?access_token=<INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"platform": "instagram",
"ice_breakers": [
{
"call_to_actions": [
{ "question": "<QUESTION_1>", "payload": "<PAYLOAD_1>" },
{ "question": "<QUESTION_2>", "payload": "<PAYLOAD_2>" }
]
}
]
}postback बटनहरू कसरी पठाइन्छन्?
POST /<IG_ID>/messages मार्फत खाताले पठाउने म्यासेज भित्र। बटन टेम्प्लेटमा 640 अक्षरसम्मको text र 1 देखि 3 बटन हुन्छन्; जेनेरिक टेम्प्लेटमा 10 एलिमेन्टसम्म, प्रत्येकमा 3 बटनसम्म। postback प्रकारको बटन थिचिँदा त्यसको पेलोड messaging_postbacks मा फर्कन्छ, जबकि web_url बटनले इन-एप ब्राउजरमा पेज खोल्छ। messenger_profile मा सेट गरिने स्थायी मेनुमा पनि यही दुई प्रकार हुन्छन्।
क्विक रिप्लाईले messaging_postbacks प्रयोग गर्छन् कि?
गर्दैनन्: तिनीहरू messages मा आउँछन्। थिचिएको क्विक रिप्लाईको शीर्षक कुराकानीमा म्यासेजको रूपमा पोस्ट हुन्छ, र messages इभेन्टमा text त्यही शीर्षकमा र quick_reply.payload त्यो विकल्पको पेलोडमा सेट हुन्छ। एउटा म्यासेजले 20 अक्षरसम्मका 13 क्विक रिप्लाईसम्म दिन सक्छ, केवल सादा पाठ। Meta को Instagram Messaging गाइडले आइस ब्रेकर र जेनेरिक टेम्प्लेट चयनलाई पनि messages ले रिपोर्ट गर्ने कुरामा सूचीबद्ध गर्छ, तर नमुना पेलोड बिना।
थिचाइले म्यासेज विन्डो खोल्छ कि?
स्थायी मेनुका लागि Meta ले यो भन्छ: मेनु आइटम थिचेमा मानक म्यासेजिङ विन्डो खुल्छ, र खातासँग प्रतिक्रिया दिनका लागि 24 घण्टा हुन्छ। postback को sender.id लाई recipient.id मा राखेर POST /<IG_ID>/messages बाट प्रतिक्रिया दिनुहोस्। खाताको प्रतिक्रिया messages मा is_echo true सहित echo को रूपमा फर्कन्छ।
easyCoexistence ले postback फर्वार्ड गर्छ कि?
केवल क्विक रिप्लाई थिचाइहरू। यिनीहरू messages मा आउँछन्, जसमा easyCoexistence को एप र प्रत्येक जडान गरिएको खाता सब्स्क्राइब छन्, त्यसैले quick_reply.payload सहित तपाईंको एन्डपोइन्टमा पुग्छन्। आइस ब्रेकर, बटन र मेनु थिचाइहरू messaging_postbacks मा आउँछन्, जसमा easyCoexistence सब्स्क्राइब गर्दैन, त्यसैले तिनीहरू फर्वार्ड हुँदैनन्।
सामान्य गल्तीहरू
- क्विक रिप्लाईको लागि messaging_postbacks मा पर्खनु। क्विक रिप्लाई messages मा आउँछ, थिचिएको विकल्पको text र quick_reply.payload सहित।
- postback.title मा रुट गर्नु। title व्यक्तिले देखेको पाठ हो र भाषा अनुसार फरक हुन सक्छ; एपले सेट गरेको पेलोडमा रुट गर्नुहोस्।
- पुरानो API संस्करणमा mid अपेक्षा गर्नु। Meta ले postback.mid Graph API v11.0 देखि मात्र समावेश गर्छ।
- 4 भन्दा बढी आइस ब्रेकर सेट गर्नु, वा तिनलाई डेस्कटपमा परीक्षण गर्नु। Meta को Ice Breaker API ले अधिकतम 4 प्रश्न लिन्छ, र यो सुविधा डेस्कटपमा उपलब्ध छैन।
प्रत्येक इभेन्ट त्यस खाताको गोप्य कुञ्जीले साइन गरिएको हुन्छ र कुनै प्रतिलिपि राखिँदैन। send_social_dm ले 24 घण्टाको विन्डो भित्र व्यक्तिलाई जवाफ दिन्छ। प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थपिँदै जाँदा घट्दै, र पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
कुन webhook फिल्डले इन्स्टाग्रामका आइस ब्रेकर थिचाइहरू रिपोर्ट गर्छ?
messaging_postbacks। postback वस्तुमा प्रश्न title को रूपमा र त्यसका लागि सेट गरिएको पेलोड, साथै Graph API v11.0 देखि mid हुन्छ।
इन्स्टाग्राम खातामा कति आइस ब्रेकर हुन सक्छन्?
अधिकतम 4 प्रश्न, POST /<IG_ID>/messenger_profile मार्फत र platform लाई instagram सेट गरेर, वैकल्पिक रूपमा प्रति locale।
इन्स्टाग्राम postback को प्रतिक्रिया कसरी दिने?
POST /<IG_ID>/messages मार्फत, recipient.id लाई postback को sender.id सेट गरेर, जुन थिच्ने व्यक्तिको Instagram-scoped ID हो। स्थायी मेनु थिचेपछि Meta ले खातालाई प्रतिक्रिया दिन 24 घण्टा दिन्छ।
इन्स्टाग्राम postback लाई title वा पेलोडमा रुट गर्नुपर्छ?
पेलोडमा, जुन एपले विकल्पका लागि सेट गरेको स्ट्रिङ हो। title व्यक्तिले देखेको पाठ हो, जुन भाषा अनुसार फरक हुन सक्छ।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको