Beta. Automations API बीटा में है और हम सक्रिय रूप से फीडबैक एकत्र कर रहे हैं। एंडपॉइंट, पेलोड और सीमाएँ हमारे विकसित होने के साथ बदल सकती हैं। कृपया सपोर्ट को फीडबैक और बग रिपोर्ट भेजें ताकि हम सही सुधारों को प्राथमिकता दे सकें।
sent का अर्थ है कि Meta ने संदेश स्वीकार किया, यह नहीं कि प्राप्तकर्ता को यह मिला। डिलीवरी अंततः प्राप्तकर्ता की Instagram Message requests सेटिंग द्वारा तय होती है: यदि वे सभी से मैसेज रिक्वेस्ट की अनुमति नहीं देते हैं, तो Meta सफलता प्रतिक्रिया लौटाता है और संदेश को चुपचाप छोड़ देता है, और यह हर API परत पर अदृश्य है। यहाँ तक कि एक डिलीवर्ड टिप्पणी-ट्रिगर्ड DM भी एक मैसेज रिक्वेस्ट के रूप में पहुँचता है जिसे प्राप्तकर्ता को स्वीकार करना होगा (जब तक कि दोनों खातों के बीच पहले से कोई बातचीत मौजूद न हो)। पूर्ण विवरण के लिए देखें Automation DM Sent but Not Delivered।यह कैसे काम करता है
1
एक ऑटोमेशन बनाएँ
POST /automations उन ट्रिगर्स और क्रियाओं के साथ जो आप चाहते हैं। ऑटोमेशन तुरंत सक्रिय हो जाता है।2
एक अंतिम उपयोगकर्ता एंगेज करता है
कोई आपकी पोस्ट पर टिप्पणी करता है, आपकी स्टोरी का जवाब देता है, DM भेजता है, या DM पर प्रतिक्रिया देता है। Meta वेबहुक को Ayrshare को डिलीवर करता है।
3
Ayrshare मिलाता है और भेजता है
इंजन घटना से मेल खाने वाले प्रत्येक नियम को खोजता है, प्रति-क्रिया डुप्लीकेशन हटाने और आपकी दैनिक DM सीमा की जाँच करता है, फिर प्रत्येक क्रिया चलाता है। Instagram के एंटी-स्पैम हेयुरिस्टिक्स के भीतर रहने के लिए DM भेजने पर 20–60 सेकंड का जिटर लागू किया जाता है।
4
निरीक्षण करें कि क्या फ़ायर हुआ
GET /automations/:id/activity ऑडिट लॉग लौटाता है — प्रत्येक डिस्पैच प्रयास, प्रति-क्रिया परिणाम और कोई भी त्रुटियाँ।Triggers
आप एक ऑटोमेशन में 50 ट्रिगर्स तक जोड़ सकते हैं। प्रत्येक ट्रिगरtype फ़ील्ड पर एक विवेकाधीन यूनियन है; टाइप-विशिष्ट फ़ील्ड्स एक ही स्तर पर होते हैं। v1 में सभी ट्रिगर्स केवल Instagram-only हैं।
कीवर्ड मिलान case-insensitive और पूर्ण-शब्द है। यदि किसी घटना में कॉन्फ़िगर किए गए कीवर्ड में से कोई एक शामिल है तो यह एक कीवर्ड-फ़िल्टर्ड ट्रिगर को संतुष्ट करता है। कनेक्टेड खाते की प्रत्येक स्टोरी पर फ़ायर करने के लिए स्टोरी ट्रिगर पर
storyId छोड़ें।
Actions
आप एक ऑटोमेशन में 50 क्रियाएँ तक जोड़ सकते हैं। वे क्रमिक रूप से चलती हैं; प्रत्येक परिणाम गतिविधि रो पर दर्ज किया जाता है।प्रति-क्रिया डेडअप विंडो
प्रत्येक क्रिया — प्रकार की परवाह किए बिना — अतिरिक्त रूप से एक वैकल्पिक शीर्ष-स्तरीयdedupWindowMinutes फ़ील्ड स्वीकार करती है जो केवल उस क्रिया के लिए डिफ़ॉल्ट 7-दिन प्रति-प्राप्तकर्ता डेडअप विंडो को ओवरराइड करती है।
- उस क्रिया के लिए डेडअप को पूरी तरह से अक्षम करने के लिए
0सेट करें (आमतौर परfire_webhook/send_emailके लिए जहाँ प्राप्तकर्ता प्रत्येक घटना की अपेक्षा करता है)। 525600(एक वर्ष) पर सीमित।
Action with a 24h dedup override
fire_webhook पेलोड
जब fire_webhook चलता है तो यह आपके खाता-स्तर वेबहुक URL पर एक JSON बॉडी POST करता है:
recipientUsername और keyword null होते हैं (जैसे dm_keyword Meta के पेलोड पर यूज़रनेम नहीं ले जाता; story_reply में कीवर्ड नहीं होता)।
टेम्प्लेट वेरिएबल्स
send_dm.message, send_email.subject, और send_email.message {{placeholder}} प्रतिस्थापन का समर्थन करते हैं। अज्ञात प्लेसहोल्डर्स को क्रिएट/अपडेट समय पर अस्वीकार कर दिया जाता है (एक 473 सत्यापन त्रुटि के रूप में) ताकि टाइपो कभी भी अक्षरशः {{foo}} को ग्राहक-सामने वाले संदेश में चुपचाप लीक न करे।
कोई
sender_email / recipient_email नहीं। ये जानबूझकर सामने नहीं लाए गए हैं — किसी अजनबी को DM में आपकी बिलिंग ईमेल का कोई वैध स्थान नहीं है, और Meta किसी भी IG वेबहुक पर प्राप्तकर्ता की ईमेल प्रदान नहीं करता है। प्लेसहोल्डर्स से बचना आकस्मिक प्रकटीकरण को रोकता है।दर सीमाएँ और कैप्स
सक्रिय-ऑटोमेशन कैप को प्रति User Profile गिना जाता है, प्रति मूल खाता नहीं। आपके खाते के अंतर्गत प्रत्येक प्रोफ़ाइल को अपना खुद का Business 10 / Enterprise 50 मिलता है, इसलिए कई प्रोफाइल वाला खाता प्रत्येक पर उतने ही ऑटोमेशन चला सकता है। यह सक्रिय ऑटोमेशन गिनता है और
POST (क्रिएट) और PUT पुन:-सक्रियण (active: false → true) दोनों पर लागू किया जाता है, प्रत्येक त्रुटि कोड 470 उत्पन्न करता है। प्रति-प्रोफ़ाइल उच्च सीमा चाहिए? इसे अपने खाते के लिए बढ़ाने के लिए सपोर्ट से संपर्क करें।
दैनिक DM कैप प्रति मूल Ayrshare खाते पर लागू होता है, आपके सभी प्रोफाइल में साझा किया जाता है, प्रति-प्रोफ़ाइल सब-कैप के साथ ताकि एक व्यस्त प्रोफ़ाइल पूरे खाते के कोटा को नष्ट न कर सके। जब DM कैप हिट हो जाता है, तो गतिविधि रो स्थिति rate_limited दर्ज करती है और कोई DM नहीं भेजा जाता।
एक ऑटोमेशन पर संरचनात्मक कैप्स: 1–50 ट्रिगर्स, 1–50 क्रियाएँ।
Instagram स्वयं प्रति खाता लगभग 200/घंटा पर DM को सीमित करता है। इसके नीचे सुरक्षित रूप से रहने के लिए इंजन 20–60 सेकंड जिटर के साथ डिस्पैच को गति देता है।
गतिविधि स्थितियाँ
GET /automations/:id/activity में एक रो एक शीर्ष-स्तरीय status और actionResults[] के अंदर एक प्रति-क्रिया status ले जाता है:
pending और in_flight क्षणिक हैं; बाकी सब कुछ अंतिम है।
sent एक प्लेटफ़ॉर्म-स्वीकृति रसीद है, डिलीवरी रसीद नहीं। Instagram किसी भी API पर संदेश डिलीवरी उजागर नहीं करता। एक send_dm क्रिया को उस क्षण sent के रूप में चिह्नित किया जाता है जब Instagram संदेश स्वीकार करता है; प्राप्तकर्ता को यह वास्तव में मिलता है या नहीं, यह उनकी Instagram Message requests सेटिंग पर निर्भर करता है, जिसे Ayrshare पढ़ या प्रभावित नहीं कर सकता। देखें Automation DM Sent but Not Delivered।त्रुटि कोड
API दो आकार की त्रुटियाँ लौटाता है:- व्यवसाय-नियम त्रुटियाँ एक नंबरित ऑटोमेशन
codeले जाती हैं (जैसे{ "action": "automation", "code": 469, ... })। - सत्यापन त्रुटियाँ — कोई भी विकृत अनुरोध बॉडी (गुम या अमान्य फ़ील्ड, अज्ञात टेम्प्लेट वेरिएबल, अनजान कुंजियाँ) — एक
detailsऑब्जेक्ट के साथ एकल473प्रतिक्रिया के रूप में लौटाई जाती हैं जो आपत्तिजनक फ़ील्ड सूचीबद्ध करती हैं।detailsसत्यापनकर्ता का आउटपुट है (formErrorsप्लसfieldErrors). प्रति-शर्त कोड पर नहीं,detailsपर ब्रांच करें।fieldErrorsमें, कुंजियाँ शीर्ष-स्तरीय अनुरोध फ़ील्ड हैं (triggers,actions): किसी विशिष्ट प्रविष्टि के भीतर एक समस्या, जैसे कि एक ट्रिगर जिसमें अपनेkeywordsगायब हैं, उस फ़ील्ड (जैसेtriggers) के तहत रिपोर्ट की जाती है, जबकिformErrorsअनजान कुंजियों जैसे ऑब्जेक्ट-स्तरीय मुद्दे रखता है।
Meta क्या अनुमति नहीं देता
कुछ सामान्य रूप से अनुरोधित क्षमताएँ समर्थित नहीं हैं क्योंकि Meta उन्हें सार्वजनिक Instagram API पर अनुमति नहीं देता है:- नए फ़ॉलोअर्स पर ऑटो-DM. Instagram एक फ़ॉलो वेबहुक प्रकाशित नहीं करता है।
- अजनबियों को पहला-संदेश DM. Meta को व्यवसाय खाते द्वारा उन्हें संदेश भेजने से पहले प्राप्तकर्ता के पहले एंगेज करने की आवश्यकता होती है (टिप्पणी, उत्तर, DM, प्रतिक्रिया)। हर समर्थित ट्रिगर ऐसे एंगेजमेंट पर एंकर्ड है — लेकिन ध्यान दें कि भेजने की अनुमति होना संदेश के डिलीवर होने के समान नहीं है: प्राप्तकर्ता की Instagram Message requests सेटिंग अभी भी Meta को संदेश स्वीकार करने और फिर उसे चुपचाप छोड़ देने का कारण बन सकती है (देखें Automation DM Sent but Not Delivered)।
- बल्क आउटबाउंड कैंपेन. प्रति घंटा DM कैप्स और एंटी-दुरुपयोग हेयुरिस्टिक्स प्लेटफ़ॉर्म स्तर पर लागू होते हैं।
मल्टी-प्रोफ़ाइल उपयोग
एंडपॉइंटprofileKey हेडर का सम्मान करते हैं। एक चाइल्ड प्रोफ़ाइल की कुंजी पास करें और ऑटोमेशन उस प्रोफ़ाइल के तहत बनाया/प्रबंधित किया जाता है। दर सीमाएँ प्रति-प्रोफ़ाइल सब-कैप के माध्यम से प्रोफाइल में विभाजित होती हैं ताकि एक चैटर प्रोफ़ाइल मूल खाते के कोटा को नष्ट न करे।
अक्सर पूछे जाने वाले प्रश्न
क्या मैं नए फ़ॉलोअर पर ट्रिगर कर सकता हूँ?
क्या मैं नए फ़ॉलोअर पर ट्रिगर कर सकता हूँ?
नहीं। Instagram एक फ़ॉलो वेबहुक प्रकाशित नहीं करता है, और Meta तीसरे-पक्ष के ऐप्स को उस उपयोगकर्ता को DM भेजने की अनुमति नहीं देता है जिसने पहले एंगेज नहीं किया है। हर समर्थित ट्रिगर (
comment_keyword, story_reply, dm_reaction, dm_keyword) ऐसे एंगेजमेंट पर एंकर्ड है, जो भेजने को अनुमेय बनाता है।कोई गतिविधि `sent` कहती है लेकिन प्राप्तकर्ता को DM कभी नहीं मिला — ऐसा क्यों?
कोई गतिविधि `sent` कहती है लेकिन प्राप्तकर्ता को DM कभी नहीं मिला — ऐसा क्यों?
sent का अर्थ है कि Instagram ने संदेश स्वीकार किया, यह नहीं कि यह डिलीवर हुआ। डिलीवरी प्राप्तकर्ता की Instagram Message requests सेटिंग पर निर्भर करती है — यदि वे सभी से मैसेज रिक्वेस्ट की अनुमति नहीं देते हैं, तो Meta सफलता प्रतिक्रिया लौटाता है और संदेश को चुपचाप छोड़ देता है, बिना किसी त्रुटि, वेबहुक, या किसी भी API सतह पर अन्य संकेत के। एक सफल टिप्पणी-ट्रिगर्ड DM भी एक मैसेज रिक्वेस्ट के रूप में पहुँचता है जिसे प्राप्तकर्ता को स्वीकार करना होगा (जब तक कि पहले से कोई बातचीत मौजूद न हो)। यह एक स्थायी Instagram प्लेटफ़ॉर्म सीमा है। देखें Automation DM Sent but Not Delivered।जब ऑटोमेशन फ़ायर होता है और मेरा एक्सेस टोकन अमान्य होता है तो क्या होता है?
जब ऑटोमेशन फ़ायर होता है और मेरा एक्सेस टोकन अमान्य होता है तो क्या होता है?
गतिविधि रो स्थिति
auth_error दर्ज करती है और DM का पुनः प्रयास नहीं किया जाता है। खाते को फिर से लिंक करें, फिर अगला मिलान करने वाला एंगेजमेंट सामान्य रूप से फ़ायर होगा।DM भेजे जाने से पहले देरी क्यों है?
DM भेजे जाने से पहले देरी क्यों है?
Instagram के एंटी-स्पैम सिस्टम को ऑर्गैनिक लगने के लिए प्रत्येक
send_dm डिस्पैच एंगेजमेंट के 20–60 सेकंड बाद शेड्यूल किया जाता है। fire_webhook और send_email क्रियाओं में जिटर नहीं होता है। गतिविधि रो का created टाइमस्टैम्प तब होता है जब ट्रिगर मिला; completedAt तब होता है जब डिस्पैच समाप्त हुआ।क्या गतिविधि रो हमेशा के लिए रखे जाते हैं?
क्या गतिविधि रो हमेशा के लिए रखे जाते हैं?
ट्रेस और एनालिटिक्स के लिए गतिविधि रो अनिश्चितकालीन रूप से बनाए रखे जाते हैं। प्रदर्शन के लिए
GET /automations/:id/activity एंडपॉइंट पिछले 30 दिनों के रो लौटाता है। (डेडअप गार्ड अपनी खुद की प्रति-क्रिया विंडो का उपयोग करता है — डिफ़ॉल्ट 7 दिन — जो गतिविधि लुकबैक से असंबंधित है।)क्या ऑटोमेशन हटाने से इसकी गतिविधि इतिहास हट जाता है?
क्या ऑटोमेशन हटाने से इसकी गतिविधि इतिहास हट जाता है?
नहीं। हटाना एक सॉफ्ट-डिलीट है: मास्टर रो को
deleted के रूप में चिह्नित किया जाता है, कोई नई डिस्पैच नहीं होती है, लेकिन ऐतिहासिक गतिविधि रो गतिविधि एंडपॉइंट के माध्यम से पठनीय रहती हैं।एंडपॉइंट
POST /automations— एक नया ऑटोमेशन बनाएँGET /automations— अपने ऑटोमेशन सूचीबद्ध करेंGET /automations/:id— इसके ट्रिगर और क्रियाओं के साथ एक ऑटोमेशन प्राप्त करेंPUT /automations/:id— आंशिक अपडेट;active: falseके माध्यम से रोकेंDELETE /automations/:id— सॉफ्ट-डिलीटGET /automations/:id/activity— कर्सर-पेजिनेटेड डिस्पैच ऑडिट लॉग