Webhook Actions

Action प्रकार द्वारा वर्गीकृत कई प्रकार के webhooks उपलब्ध हैं। उदाहरण के लिए, एक scheduled पोस्ट scheduled action webhook को ट्रिगर करेगी। अधिक विवरण के लिए कृपया webhook overview देखें। एक webhook URL रजिस्टर करने के बाद, जब कोई event होगा तो आपको अपने URL पर एक POST request मिलेगी। POST request में event विवरण के साथ एक JSON payload शामिल होगा।

Scheduled Action

जब एक scheduled पोस्ट संसाधित होती है — चाहे वह सफल हो या विफल — और चयनित सोशल नेटवर्क्स पर प्रकाशित होती है, तब आपको यह webhook notification मिलेगा। उदाहरण के लिए, यदि आप 1 अगस्त, 2026 को दोपहर 12:00 बजे के लिए एक पोस्ट schedule करते हैं, तो webhook उसी सटीक समय पर भेजा जाएगा जब पोस्ट प्रकाशित होगी। Webhook notifications केवल /post endpoint में scheduleDate फील्ड का उपयोग करके भविष्य में scheduled पोस्ट के लिए भेजे जाते हैं।

Scheduled Event

{
  "action": "scheduled", // The action taken
  "subAction": "tikTokPublished", // Only present when TikTok video publishing complete
  "created": "2023-01-05T01:18:47Z",
  "code": 200, // HTTP response code
  "refId": "140b8700bd6ade089b242d845e268fb886130c53", // User Reference ID
  "status": "success", // success or error
  "id": "TBAAAqAMMpoweA9wKHUp", // Ayrshare id of post
  "errors": [], // List of errors if any occurred
  "postIds": [
    // Individual successful posts status
    {
      "postUrl": "https://www.facebook.com/102775127855689_361718068618052",
      "platform": "facebook",
      "status": "success",
      "id": "102775127855689_361718068618052"
    }
  ],
  "url": "https://mysite.com/webhook" // Your webhook URL
}

तत्काल पोस्ट के लिए आपको webhook notification नहीं मिलेगा, क्योंकि API JSON reply में सफलता या विफलता की response तुरंत लौटाता है। Webhook notifications केवल scheduled पोस्ट के लिए भेजे जाते हैं, क्योंकि इन्हें asynchronously संसाधित किया जाता है और आपको उनकी स्थिति की सूचना देने के लिए एक अलग notification की आवश्यकता होती है।

TikTok Publishing Webhook

Ayrshare के माध्यम से TikTok के साथ काम करते समय, आपको एक scheduled पोस्ट के लिए दो अलग-अलग webhooks मिल सकते हैं। यदि आपकी पोस्ट तत्काल के बजाय scheduled थी, तो आपको पहले मानक Scheduled Action webhook मिलेगा। यह इंगित करता है कि मीडिया को processing और पोस्टिंग के लिए TikTok पर सफलतापूर्वक भेजा गया है। इसके बाद, आपको subAction: tikTokPublished webhook मिलेगा। यह तब ट्रिगर होता है जब TikTok ने मीडिया processing पूरी कर ली है और मीडिया को सार्वजनिक कर दिया गया है। यह webhook तत्काल पोस्ट और scheduled पोस्ट दोनों के लिए सक्रिय होता है। Ayrshare डैशबोर्ड में, इस event को tikTok (pub) के रूप में लेबल किया जाता है।

tikTokPublished webhook तब तक नहीं भेजा जाता जब तक मीडिया को सार्वजनिक नहीं किया जाता। यदि मीडिया को private, followers, या friends पर सेट किया गया है, तो webhook नहीं भेजा जाएगा।यदि आपको tikTokPublished webhook नहीं मिलता है और पोस्ट स्थिति pending बनी रहती है, तो यह सुनिश्चित करने के लिए TikTok मोबाइल ऐप की जांच करें कि मीडिया को TikTok द्वारा स्वीकार किया गया है।

जब एक उपयोगकर्ता की प्रोफ़ाइल एक सोशल नेटवर्क को link या unlink करती है तो notification।

{
  "action": "social", // The action taken
  "created": "2023-01-05T01:18:47Z",
  "code": 200, // HTTP response code
  "details": {
    // Optional: if details available
    "status": "error",
    "code": 349,
    "message": "Account locked"
  },
  "displayName": "Instagram Title", // If a user account name is present at the social network
  "hookId": "TKLc30192HLGw5UeJ46",
  "platform": "instagram", // The social platform the action occured
  "refId": "140b8700bd6ade089b242d845e268fb886130c53", // User Reference ID
  "refreshBy": "2022-11-05T12:21:29Z", // Optional: If type is refresh, the date the social network authorization must be refreshed on the social account linkage page
  "source": "system", // Initiated by "system" or "user".
  "title": "User Profile Name", // The user profile's account title
  "type": "link", // Type of action: link, unlink, or refresh
  "url": "https://mysite.com/webhook" // Your webhook URL
}

system का source का मतलब है कि Ayrshare ने अकाउंट को स्वचालित रूप से unlink कर दिया, जैसे कि जब सोशल नेटवर्क कनेक्शन अब मान्य नहीं है। हम अनुशंसा करते हैं कि आप अपने उपयोगकर्ता को सूचित करें ताकि वे पोस्ट करना जारी रख सकें। Unlinking के विवरण details फील्ड में पाए जाते हैं। Primary Account ईमेल पते, या alt emails पर एक ईमेल भी भेजा जाएगा यदि वे सेट अप हैं। user का source का मतलब है कि उपयोगकर्ता ने स्वयं action शुरू किया, जैसे कि उन्होंने मैन्युअल रूप से एक अकाउंट को unlink किया। जब उपयोगकर्ता द्वारा शुरू किया गया action होता है तो ईमेल नहीं भेजा जाएगा।

Messages Action

सभी messages endpoints और webhooks तक पहुँच के लिए Messaging Add-On आवश्यक है। Facebook और Instagram के लिए, तब notifications प्राप्त करें जब कोई direct message आता है, पढ़ा जाता है, या उस पर एक प्रतिक्रिया बनाई या हटाई जाती है। WhatsApp वर्तमान में आपके पंजीकृत webhook URL पर केवल तभी notification भेजता है जब एक नया इनकमिंग संदेश संग्रहीत होता है। X/Twitter webhooks Enterprise क्लाइंट्स के लिए एक विकल्प के रूप में उपलब्ध हैं। Enterprise क्लाइंट बनने के बारे में अधिक जानकारी के लिए कृपया अपने अकाउंट प्रतिनिधि से संपर्क करें। WhatsApp आज आपके पंजीकृत URL पर reaction या delivery-status webhooks उत्सर्जित नहीं करता। संग्रहीत outbound संदेशों में sent, delivered, read, या failed का status मान हो सकता है — नीचे WhatsApp Message Status देखें।

एकाधिक ऐप्स वाले Facebook Pages के लिए Standby कवरेज

Ayrshare मानक messaging फील्ड्स के अलावा Facebook के standby webhook फील्ड को subscribe करता है। इसका मतलब है कि Messenger events आपके webhook पर वितरित होते हैं तब भी जब उसी Facebook Page पर कोई अन्य ऐप वर्तमान में thread control रखता है — उदाहरण के लिए, जब एक chatbot प्लेटफ़ॉर्म आपके Page के primary receiver के रूप में सेट है, या जब Meta का Page Inbox सक्रिय रूप से एक बातचीत को handle कर रहा है। इन events के लिए कोई schema परिवर्तन नहीं है। वे नीचे के sections में documented समान messageCreated / messageRead / reactionCreated / messageEdited payloads के रूप में आते हैं। एक competing Messenger ऐप स्थापित वाले Pages के लिए दो बातों से अवगत होना चाहिए:

Inbound message volume बढ़ सकता है पिछले व्यवहार की तुलना में, जहाँ standby events subscribe करने से पहले चुपचाप drop हो जाते थे। नया ट्रैफ़िक उन messages का प्रतिनिधित्व करता है जो आपके Page को प्राप्त हुए थे और अन्य ऐप द्वारा handle किए जा रहे थे।
आपको type: "sent" के साथ messageCreated events प्राप्त हो सकते हैं जो उन messages के अनुरूप नहीं हैं जिन्हें आपने Ayrshare के माध्यम से भेजा था। ये आपके Page पर अन्य Messenger ऐप द्वारा भेजे गए messages के echoes हैं (Meta प्रत्येक send की एक कॉपी प्रत्येक subscribed ऐप को वितरित करता है)। यदि आपका integration अपने स्वयं के send इतिहास के विरुद्ध outbound ट्रैफ़िक को reconcile करता है, तो आप अपने sends को एक competing ऐप के sends से अलग करने के लिए उस इतिहास का उपयोग कर सकते हैं।

केवल Ayrshare स्थापित वाले Pages (कोई competing Messenger ऐप नहीं) के लिए, एकमात्र दृश्यमान परिवर्तन नया Message Edit Event है — बाकी सब कुछ पिछले व्यवहार के समान दिखता है।

New Message Events

जब एक नया message भेजा या प्राप्त किया जाता है तब notification।

{
  "action": "messages",
  "conversationId": "t_10161117434308936",
  "created": "2024-06-07T11:58:44Z",
  "hookId": "JC6IgqFjvDliTJ8MLqzE",
  "id": "m_aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDUyMjEyNzA",
  "message": "This is an amazing message",
  "platform": "facebook",
  "recipientId": "7270633706358444",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "scheduleDate": "2024-06-07T11:58:44Z",
  "senderDetails": {
    // recipientDetails if type is sent
    "id": "7270633706358444",
    "picture": "https://scontent-ord5-2.cdninstagram.com/v/t51.jpg",
    "username": "SweetMessage",
    "name": "Sweet"
  },
  "senderId": "17841452212707444",
  "subAction": "messageCreated",
  "timeStamp": 1735189325, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "received", // received, sent, or deleted
  "url": "https://mysite.com/webhook" // Your webhook URL
}

{
  "action": "messages",
  "conversationId": "aWdfZAG06MTpJR01lc3NhZA2VUaHJlYWQ6MTc4",
  "created": "2024-06-07T11:58:44Z",
  "hookId": "JC6IgqFjvDliTJ8MLqzE",
  "id": "aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEOjE3ODQxNDUyMjEyNzA",
  "message": "This is an amazing message",
  "platform": "instagram",
  "recipientId": "7270633706358444",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "scheduleDate": "2024-06-07T11:58:44Z",
  "senderDetails": {
    // recipientDetails if type is sent
    "id": "7270633706358444",
    "picture": "https://scontent-ord5-2.cdninstagram.com/v/t51.jpg",
    "username": "SweetMessage",
    "name": "Sweet"
  },
  "senderId": "17841452212707444",
  "subAction": "messageCreated",
  "timeStamp": 1735189325, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "received", // received, sent, or deleted
  "url": "https://mysite.com/webhook" // Your webhook URL
}

{
  "action": "messages",
  "attachments": [
    {
      "type": "image",
      "url": "https://images.ayrshare.com/abc123/whatsapp_image_x9aB2pK7.jpg"
    }
  ],
  "conversationId": "14155551234",
  "created": "2026-05-18T17:08:41Z",
  "hookId": "JC6IgqFjvDliTJ8MLqzE",
  "id": "wamid.HBgLMTQxNTU1NTEyMzQVAgARGBI4OUYxRkExNzE0M0EwQTYwM0EA",
  "message": "Here's the photo you asked for.",
  "platform": "whatsapp",
  "recipientId": "123456789012345",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "senderDetails": {
    "id": "14155551234",
    "name": "Jane Customer"
  },
  "senderId": "14155551234",
  "timeStamp": 1747588121,
  "title": "Primary Profile",
  "url": "https://mysite.com/webhook"
}

WhatsApp के लिए, conversationId और senderId E.164 केवल-अंक प्रारूप में correspondent का फ़ोन नंबर हैं। recipientId आपके लिंक किए गए WhatsApp account के लिए Meta का फ़ोन-नंबर ID है। timeStamp तब मौजूद होता है जब Webhook Security सक्षम हो। Media संदेश mediaUrls के बजाय attachments का उपयोग करते हैं; attachment प्रकार image, video, audio, document, या sticker हो सकते हैं।

Message Read Event

जब एक message को प्राप्तकर्ता द्वारा पढ़ा जाता है तब notification।

{
  "action": "messages",
  "conversationId": "t_10161117434308936",
  "created": "2024-06-08T23:33:30Z",
  "hookId": "CviPBMXEy3cdJnK0EESd",
  "platform": "facebook",
  "read": 1717889607802,  // UNIX timestamp of when the message was read
  "readerDetails": {
    "name": "John Smith",
    "id": "7101149746568444",
    "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic"
  },
  "recipientId": "106638148652329",
  "refId": "9abf1426d6ce9122ef11c8932",
  "scheduleDate": "2024-06-08T23:33:30Z",
  "senderId": "7101149746568522",
  "subAction": "messageRead",
  "timeStamp": 1717889610, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "read",
  "url": "https://mysite.com/webhook" // Your webhook URL
}

{
  "action": "messages",
  "conversationId": "t_10161117434308938",
  "created": "2024-06-08T23:33:30Z",
  "hookId": "CviPBMXEy3cdJnK0EESd",
  "platform": "instagram",
  "read": {
    "mid": "aWdfZAG1faXRlbToxOkl" // Instagram message ID
  },
  "readerDetails": {
    "name": "John Smith",
    "id": "7101149746568444",
    "picture": "https://platform-lookaside.fbsbx.com/platform/profilepic",
    "username": "johnsmith"
  },
  "recipientId": "106638148652329",
  "refId": "9abf1426d6ce9122ef11c8932",
  "scheduleDate": "2024-06-08T23:33:30Z",
  "senderId": "7101149746568522",
  "subAction": "messageRead",
  "timeStamp": 1717889610, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "read",
  "url": "https://mysite.com/webhook" // Your webhook URL
}

जब Instagram पर एक message पढ़ा जाता है, तो webhook payload में एक mid फील्ड शामिल होता है जो अद्वितीय रूप से पहचानता है कि कौन सा विशिष्ट message पढ़ा गया था। Facebook messages के लिए, message reads को conversationId का उपयोग करके conversation स्तर पर track किया जाता है। जब एक read event होता है, तो created (या read) timestamp से पहले timestamps वाले उस conversation में सभी messages को उपयोगकर्ता द्वारा पढ़ा गया माना जाना चाहिए।

Reaction Created और Deleted Events

जब एक message पर एक प्रतिक्रिया, जैसे कि एक like, बनाई या हटाई जाती है तब notification।

{
  "action": "messages",
  "conversationId": "t_10161117434308936",
  "created": "2024-06-06T00:49:18Z",
  "hookId": "LcgLuXzZki15lqBNt69h",
  "platform": "facebook",
  "reaction": "😮",
  "recipientId": "106638148652444",
  "refId": "9abf1426d6ce9432",
  "scheduleDate": "2024-06-06T00:49:18Z",
  "senderId": "7101149746568444",
  "subAction": "reactionCreated", // reactionDeleted if deleted
  "timeStamp": 1717634958, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "reaction",
  "url": "https://mysite.com/webhook" // Your webhook URL
}

{
  "action": "messages",
  "conversationId": "aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEO",
  "created": "2024-06-06T00:49:18Z",
  "hookId": "LcgLuXzZki15lqBNt69h",
  "platform": "instagram",
  "reaction": "😮",
  "recipientId": "106638148652444",
  "refId": "9abf1426d6ce9432",
  "scheduleDate": "2024-06-06T00:49:18Z",
  "senderId": "7101149746568444",
  "subAction": "reactionCreated", // reactionDeleted if deleted
  "timeStamp": 1717634958, // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "reaction",
  "url": "https://mysite.com/webhook" // Your webhook URL
}

Message Edit Event

जब एक उपयोगकर्ता पहले भेजे गए message को संपादित करता है तब notification। Facebook और Instagram direct messages के लिए उपलब्ध। messageEdit.mid फील्ड मूल messageCreated event के id से मेल खाता है, इसलिए consumers edit को मूल message के साथ correlate कर सकते हैं। messageEdit.text फील्ड नया, संपादित message टेक्स्ट ले जाता है।

{
  "action": "messages",
  "conversationId": "t_10161117434308936",
  "created": "2024-06-06T00:49:18Z",
  "hookId": "LcgLuXzZki15lqBNt69h",
  "id": "m_xyz...",                    // Message ID — matches the original messageCreated event
  "messageEdit": {
    "mid": "m_xyz...",
    "text": "the edited message text"
  },
  "platform": "facebook",
  "recipientId": "106638148652444",
  "refId": "9abf1426d6ce9432",
  "senderId": "7101149746568444",
  "subAction": "messageEdited",
  "timeStamp": 1717634958,              // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "edit",
  "url": "https://mysite.com/webhook"   // Your webhook URL
}

{
  "action": "messages",
  "conversationId": "aWdfZAG1faXRlbToxOklHTWVzc2FnZAUlEO",
  "created": "2024-06-06T00:49:18Z",
  "hookId": "LcgLuXzZki15lqBNt69h",
  "id": "aWdfZAG1faXRlbToxOkl",
  "messageEdit": {
    "mid": "aWdfZAG1faXRlbToxOkl",
    "text": "the edited message text"
  },
  "platform": "instagram",
  "recipientId": "106638148652444",
  "refId": "9abf1426d6ce9432",
  "senderId": "7101149746568444",
  "subAction": "messageEdited",
  "timeStamp": 1717634958,              // Present if Webhook Security enabled
  "title": "Primary Profile",
  "type": "edit",
  "url": "https://mysite.com/webhook"   // Your webhook URL
}

WhatsApp Message Status

WhatsApp एक status field का उपयोग करके संग्रहीत outbound संदेशों पर प्रति-संदेश डिलीवरी स्थिति ट्रैक करता है: sent, delivered, read, या failed। ये अपडेट वर्तमान में आपके पंजीकृत webhook URL पर अलग events के रूप में वितरित नहीं किए जाते। यदि आपको वास्तविक-समय डिलीवरी स्थिति की आवश्यकता है, तो कृपया अपने Ayrshare account प्रतिनिधि से संपर्क करें।

Batch Action

जब एक batch ने processing पूरी कर ली है और फ़ाइल उपलब्ध है, जैसे कि सभी user profiles प्राप्त करें, तब notification। आप url फील्ड में pre-signed URL के साथ फ़ाइल तक पहुँच सकते हैं।

Batch Event

{
  "action": "batch",
  "batchType": "users",
  "created": "2024-01-11T22:00:30Z",
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",
  "source": "user",
  "timeStamp": 1705010424, // Present with Webhook Security
  "title": "Primary Profile",
  "type": "batch",
  "url": "https://storage.googleapis.com/batch.ayrshare.com/users/dfdf92jskd933r/users-batch-2024-01-11-22-00.json",
  "urlExpires": "2024-01-18T22:00:04Z",
  "userCount": 73
}

Feed Action

जब पंजीकृत RSS feeds के लिए एक नया RSS feed आइटम पाया जाता है तब notification। नोट: यदि Webhook सक्रिय है, तो नए RSS आइटम स्वचालित रूप से सोशल नेटवर्क्स पर पोस्ट नहीं किए जाएंगे।

Feed Event

{
    "action": "feed",
    "created": "2023-01-05T01:18:47Z",
    "code": 200,                                          // HTTP response code
    "refId": "140b8700bd6ade089b242d845e268fb886130c53",  // User Reference ID
    "title": "Title of profile if available",             // optional, only if available
    "data": { ... },
    "url": "https://api.myapp.com/Webhook/Ayrshare/Feed"  // Your webhook URL
}

Mentions Action

जब आपके connected अकाउंट का उल्लेख किया जाता है तब notification। Instagram के लिए उपलब्ध।

Instagram के लिए, mention events प्राप्त करने के लिए mentions webhook रजिस्टर करना ही पर्याप्त है। Messaging Add-On, messaging enablement, और सोशल अकाउंट को फिर से लिंक करने की आवश्यकता नहीं है।

Ayrshare Meta के native mention payload को अपरिवर्तित रिले करता है, केवल मानक envelope फील्ड्स (action, refId, hookId, url, और Webhook Security के साथ timeStamp), subAction, platform, और postId जोड़ता है। नीचे दिया गया उदाहरण Instagram shape है: media_id, प्लस comment_id जब mention एक comment में हो। Facebook Page mention इवेंट फ़िलहाल डिलीवर नहीं होते — Ayrshare उन्हें Meta से स्वीकार करता है और आपके webhook पर आगे नहीं भेजता। आज केवल Instagram mentions डिलीवर होते हैं, इसलिए इस action पर platform हमेशा instagram होता है।

Mention Event (Instagram)

{
  "action": "mentions",
  "subAction": "mention",
  "platform": "instagram",            // The social network the mention came from
  "postId": "TBAAAqAMMpoweA9wKHUp",   // Ayrshare post id; absent unless you published the post
  "media_id": "17900000000000000",    // Meta media the mention occurred on
  "comment_id": "17900000000000001",  // Present when the mention is in a comment
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1705010424,             // Present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Mentions"  // Your webhook URL
}

Comments Action

जब आपके connected content पर एक comment बनाया जाता है तब notification। Facebook और Instagram के लिए उपलब्ध।

Instagram के लिए, comment events प्राप्त करने के लिए comments webhook रजिस्टर करना ही पर्याप्त है। Messaging Add-On, messaging enablement, और सोशल अकाउंट को फिर से लिंक करने की आवश्यकता नहीं है।

Ayrshare Meta के native comment payload को अपरिवर्तित रिले करता है, केवल मानक envelope फील्ड्स (action, refId, hookId, url, और Webhook Security के साथ timeStamp), subAction, platform, और postId जोड़ता है। नीचे दिया गया उदाहरण Instagram shape है। Facebook comments विभिन्न फील्ड नामों (उदाहरण के लिए comment_id, post_id, message, और from.name) के साथ एक Page feed change के रूप में आते हैं; Facebook फील्ड सेट के लिए Meta की webhooks reference देखें। चूँकि दोनों networks एक ही comments endpoint पर डिलीवर करते हैं, फील्ड नामों की उपस्थिति से network का अनुमान लगाने के बजाय platform — instagram या facebook — के आधार पर branch करें।

Comment Event (Instagram)

{
  "action": "comments",
  "subAction": "comment",
  "platform": "instagram",             // The social network the comment came from
  "postId": "TBAAAqAMMpoweA9wKHUp",    // Ayrshare post id; absent unless you published the post
  "id": "17900000000000002",           // Comment ID
  "text": "Great post!",
  "from": {
    "id": "1234567890",
    "username": "alice"
  },
  "media": {
    "id": "17900000000000000",         // ID of the commented media
    "media_product_type": "FEED"       // e.g. FEED, REELS, STORY
  },
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1705010424,             // Present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Comments"  // Your webhook URL
}

Automations Action

जब एक automation एक उपयोगकर्ता के लिए एक webhook action को fire करता है, जैसे कि एक comment या DM auto-reply trigger, तब notification।

Automation Event

{
  "action": "automations",
  "automationId": "a1B2c3D4",
  "triggerId": "t9X8y7Z6",
  "trigger": "comment_keyword",        // The trigger type that fired the automation (varies by automation)
  "platform": "instagram",
  "recipientId": "17841400000000000",
  "recipientUsername": "alice",        // null if unavailable
  "keyword": "INFO",                   // null if not keyword-triggered
  "timestamp": "2026-05-27T22:00:30Z", // When the automation fired (ISO 8601)
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1705010424,             // Unix timestamp, present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Automations"  // Your webhook URL
}

Demo Action

Demo User Profile जीवनचक्र events के लिए notification। Demo User Profiles Enterprise plan पर उपलब्ध हैं; यदि आप अधिक जानना चाहते हैं तो कृपया हमसे संपर्क करें। demo action पर दो event प्रकार भेजे जाते हैं, जिन्हें type फील्ड द्वारा अलग किया जाता है:

upgradeWarning — Demo User Profile के स्वचालित रूप से एक standard User Profile में परिवर्तित होने से दो दिन पहले भेजा जाता है, ताकि आप अपने user को जारी रखने या profile को हटाने के लिए prompt कर सकें।
upgrade — conversion होने पर भेजा जाता है।

Demo Upgrade Warning Event

{
  "action": "demo",
  "type": "upgradeWarning",
  "demoExpires": "2026-08-27T09:57:00.000Z",  // When the profile converts (ISO 8601)
  "daysUntilUpgrade": 2,
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1787734624,             // Unix timestamp (2026-08-26), present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Demo"  // Your webhook URL
}

Demo Upgrade Event

{
  "action": "demo",
  "type": "upgrade",
  "upgradedAt": "2026-08-28T08:57:04.000Z",  // When the profile converted (ISO 8601)
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1787907424,             // Unix timestamp (2026-08-28), present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Demo"  // Your webhook URL
}

Suspended Action

जब कोई User Profile निलंबित (suspended) या पुनः सक्रिय (reactivated) किया जाता है, तब की notification। निलंबन किसी सोशल नेटवर्क के अपने प्रवर्तन से (उदाहरण के लिए, Facebook की identity verification आवश्यकता), rate limit protection से, या billing समस्याओं से उत्पन्न हो सकते हैं। जब कोई profile निलंबित होती है, तो उस profile के लिए API calls HTTP 403 लौटाते हैं। suspended action पर दो event प्रकार भेजे जाते हैं, जिन्हें type फील्ड द्वारा अलग किया जाता है:

suspend — profile के निलंबित होने पर भेजा जाता है। इस profile के पुनः सक्रिय होने तक पोस्टिंग और अन्य गतिविधि रोक दें।
unsuspend — profile के पुनः सक्रिय होने पर भेजा जाता है।

Events केवल तब भेजे जाते हैं जब profile की समग्र निलंबन स्थिति बदलती है। एक profile एक ही समय में एक से अधिक कारणों से निलंबित हो सकती है: यदि profile के पहले से निलंबित रहते हुए कोई अतिरिक्त कारण जोड़ा जाता है, या कई कारणों में से एक हल हो जाता है जबकि दूसरा अभी भी लागू है, तो कोई event नहीं भेजा जाता — profile निलंबित बनी रहती है, और अगला event वह unsuspend होता है जो अंतिम कारण के हल होने पर आता है। किसी भी समय वर्तमान निलंबन स्थिति की जाँच करने के लिए, Get Profiles का include=suspension के साथ उपयोग करें। प्लेटफ़ॉर्म-ट्रिगर्ड निलंबन आमतौर पर प्रभावित नेटवर्क के लिए एक Social Action unlink event के बाद आता है। निलंबन को केवल स्रोत पर ही हल किया जा सकता है — उदाहरण के लिए, Facebook की identity check Page admin द्वारा Facebook ऐप में पूरी करनी होगी — जिसके बाद profile को पुनः सक्रिय किया जा सकता है और नेटवर्क को फिर से link किया जा सकता है।

Suspend Event

{
  "action": "suspended",
  "type": "suspend",
  "reason": "Confirm your identity before you can publish as this Page.", // As reported by the platform or Ayrshare; null if unavailable
  "platform": "facebook",              // The social network that triggered the suspension; null if not platform-triggered
  "origin": "policy",                  // What suspended the profile: policy, payment, rateLimit, manual, report, or subscription; null if unavailable
  "suspendedAt": "2026-08-13T20:31:41.128Z", // When the suspension occurred (ISO 8601); null if unavailable
  "unsuspendAt": null,                 // Scheduled automatic reactivation (ISO 8601), when already known
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1786731101,             // Unix timestamp, present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Suspended"  // Your webhook URL
}

Unsuspend Event

{
  "action": "suspended",
  "type": "unsuspend",
  "reason": null,
  "platform": null,
  "origin": null,
  "suspendedAt": null,
  "unsuspendAt": null,
  "hookId": "dI3PNhrG83j2FzAFJqkb",
  "refId": "9abf1426d6ce9122ef11c72bd62e59807c5cc083",  // User Reference ID
  "timeStamp": 1786988742,             // Unix timestamp, present with Webhook Security
  "url": "https://api.myapp.com/Webhook/Ayrshare/Suspended"  // Your webhook URL
}

Suspension events उस profile के लिए भेजे जाते हैं जिसकी स्थिति बदली है। आप Get Profiles के साथ include=suspension का उपयोग करके किसी भी समय निलंबन स्थिति की जाँच भी कर सकते हैं, जो isSuspended, reason, suspendedAt, unsuspendAt, और suspensionCount लौटाता है।

Get Started

API Endpoints

Multiple Users

Dashboard

Additional

Scheduled Action

Scheduled Event

TikTok Publishing Webhook

Messages Action

एकाधिक ऐप्स वाले Facebook Pages के लिए Standby कवरेज

New Message Events

Message Read Event

Reaction Created और Deleted Events

Message Edit Event

WhatsApp Message Status

Batch Action

Batch Event

Feed Action

Feed Event

Mentions Action

Mention Event (Instagram)

Comments Action

Comment Event (Instagram)

Automations Action

Automation Event

Demo Action

Demo Upgrade Warning Event

Demo Upgrade Event

Suspended Action

Suspend Event

Unsuspend Event

​Scheduled Action

​Scheduled Event

​TikTok Publishing Webhook

​Social Action

​Social Action Event

​Messages Action

​एकाधिक ऐप्स वाले Facebook Pages के लिए Standby कवरेज

​New Message Events

​Message Read Event

​Reaction Created और Deleted Events

​Message Edit Event

​WhatsApp Message Status

​Batch Action

​Batch Event

​Feed Action

​Feed Event

​Mentions Action

​Mention Event (Instagram)

​Comments Action

​Comment Event (Instagram)

​Automations Action

​Automation Event

​Demo Action

​Demo Upgrade Warning Event

​Demo Upgrade Event

​Suspended Action

​Suspend Event

​Unsuspend Event

Scheduled Action

Scheduled Event

TikTok Publishing Webhook

Social Action

Social Action Event

Messages Action

एकाधिक ऐप्स वाले Facebook Pages के लिए Standby कवरेज

New Message Events

Message Read Event

Reaction Created और Deleted Events

Message Edit Event

WhatsApp Message Status

Batch Action

Batch Event

Feed Action

Feed Event

Mentions Action

Mention Event (Instagram)

Comments Action

Comment Event (Instagram)

Automations Action

Automation Event

Demo Action

Demo Upgrade Warning Event

Demo Upgrade Event

Suspended Action

Suspend Event

Unsuspend Event