सोशल मीडिया वेबहुक: एक एंडपॉइंट पर कमेंट, मेंशन और मैसेज
easyCoexistence सोशल मीडिया के इवेंट आपके अपने HTTPS एंडपॉइंट पर भेजता है, जैसे ही वे होते हैं: Instagram और Facebook से कमेंट, मेंशन और DMs, और TikTok से कमेंट। हर इवेंट एक ही एनवेलप में आता है, जिसके भीतर नेटवर्क का इवेंट बिना बदले होता है, और हर खाते के अपने सीक्रेट से X-EC-Signature के साथ साइन किया जाता है। किसी खाते के लिए इसे चालू करने के लिए Claude या ChatGPT से set_social_webhook_destination चलाएँ, या Partner API का इस्तेमाल करें। WhatsApp नंबर के मैसेज भी आपके सर्वर तक पहुँचते हैं।
- जैसे ही होते हैं, कमेंट, मेंशन और DMs
- एक एनवेलप, हर खाते के लिए साइन किया हुआ
- Claude, ChatGPT या Partner API से सेट करें
3 दिनों तक कोई शुल्क नहीं लिया जाता। कभी भी रद्द करें।
easyCoexistence हर फ़ॉरवर्ड किया गया सोशल इवेंट कितनी बार भेजता है; वह कोई कॉपी नहीं रखता, इसलिए बाद में कुछ भी दोबारा नहीं भेजा जाता।
TikTok का comment.update वेबहुक किसी स्वामित्व वाले खाते के सार्वजनिक वीडियो पर कमेंट बनने, मिटने या दृश्यता बदलने की कितनी जल्दी सूचना देता है।
Instagram Login वाले ऐप्स @mentions कहाँ पाते हैं: कमेंट वेबहुक नोटिफ़िकेशन के अंदर, अपने अलग फ़ील्ड के रूप में नहीं।
YouTube की पुश सूचनाएँ किसी चैनल के लिए क्या बताती हैं: नया अपलोड, नया टाइटल या नया विवरण।
Meta उस WhatsApp वेबहुक को कितनी देर तक दोबारा भेजने की कोशिश करता है जिसे आपके सर्वर ने स्वीकार नहीं किया, और इससे डुप्लिकेट आ सकते हैं।
कौन-से इवेंट हर नेटवर्क भेजता है?
Instagram, Facebook और TikTok इवेंट easyCoexistence को पुश करते हैं, और easyCoexistence हर इवेंट को उस खाते के लिए आपके सेट किए गए यूआरएल पर पहुँचा देता है। Instagram नए कमेंट भेजता है, जिसमें @mentions कमेंट नोटिफ़िकेशन के अंदर आते हैं, और DMs भेजता है। एक Facebook पेज फ़ीड गतिविधि भेजता है, जिसमें नए कमेंट शामिल हैं, साथ ही Messenger मैसेज और पेज के मेंशन। TikTok comment.update भेजता है, जो तब चलता है जब कोई कमेंट बनता है, मिटता है या दृश्यता बदलता है।
YouTube और LinkedIn easyCoexistence को कोई कमेंट या मैसेज इवेंट नहीं भेजते, इसलिए एजेंट माँग पर उनके कमेंट पढ़ता है। WhatsApp नंबर अपने अलग रास्ते पर चलता है: Meta उसके मैसेज सीधे आपके सर्वर तक पहुँचाता है, या जब नंबर मैनेज्ड मोड में चलता है तो easyCoexistence उन्हें साइन करके फ़ॉरवर्ड करता है।
| What arrives | Sent by | |
|---|---|---|
| Comments, mentions and DMs | easyCoexistence, signed per account | |
| Feed activity, Messenger and mentions | easyCoexistence, signed per account | |
| TikTok | comment.update events | easyCoexistence, signed per account |
| Messages and echoes from the app | Meta directly, or easyCoexistence in managed mode | |
| YouTube | No comment events | Read with list_youtube_comments |
| No comment events | Read with list_linkedin_comments |
फ़ॉरवर्ड किया गया इवेंट कैसा दिखता है?
हर नेटवर्क पर एक ही JSON एनवेलप, Content-Type application/json के साथ पोस्ट किया जाता है: platform, यानी नेटवर्क; account_id, वह ID जिसे MCP टूल और Partner API इस्तेमाल करते हैं; external_id, नेटवर्क पर खाते का ID; और entry, नेटवर्क का अपना इवेंट जैसा वह आया। Instagram और Facebook के लिए entry, Meta का वेबहुक entry है, जिसमें कमेंट और मेंशन के लिए changes और DMs के लिए messaging होता है। TikTok के लिए इसमें comment.update इवेंट होता है, जिसमें comment_id, video_id और parent_comment_id स्ट्रिंग के रूप में होते हैं, ताकि 64-bit ID गोल न हों। Messenger मैसेज इस तरह आता है:
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793318400512,
"messaging": [
{
"sender": { "id": "<PAGE_SCOPED_ID>" },
"recipient": { "id": "<PAGE_ID>" },
"timestamp": 1793318399870,
"message": { "mid": "<MESSAGE_ID>", "text": "Are you open on Sunday?" }
}
]
}
}X-EC-Signature को कैसे वेरिफ़ाई करें?
उस साइनिंग सीक्रेट से, जो वेबहुक डेस्टिनेशन सेट करते समय लौटता है। यह सीक्रेट उस खाते के लिए अलग होता है और एक ही बार दिखाया जाता है। हेडर t=<unix>,v1=<hex> के रूप में आता है, और v1 टाइमस्टैम्प, एक डॉट और रॉ अनुरोध बॉडी का HMAC-SHA256 है, जिसे उसी सीक्रेट से बनाया गया है। पार्स करने से पहले बॉडी को बाइट्स के रूप में पढ़ें, ऐसा टाइमस्टैम्प अस्वीकार करें जो आपकी घड़ी से 5 मिनट से ज़्यादा दूर हो, इवेंट के account_id से सीक्रेट खोजें, और दोनों डाइजेस्ट स्थिर समय में तुलना करें। फिर 2xx जवाब दें और काम को क़्यू में डालें। PHP में इसके लिए कुछ पंक्तियाँ लगती हैं:
<?php
// POST /hooks/social: one endpoint for the events of each account
$raw = file_get_contents('php://input'); // the exact bytes that were signed
parse_str(str_replace(',', '&', $_SERVER['HTTP_X_EC_SIGNATURE'] ?? ''), $sig);
$event = json_decode($raw, true); // platform, account_id, external_id, entry
$secret = secret_for($event['account_id'] ?? ''); // the signing_secret stored for that account
$fresh = ctype_digit($sig['t'] ?? '') && abs(time() - (int) $sig['t']) <= 300;
$expected = hash_hmac('sha256', ($sig['t'] ?? '') . '.' . $raw, (string) $secret);
if (!$secret || !$fresh || !hash_equals($expected, $sig['v1'] ?? '')) {
http_response_code(401);
exit;
}
http_response_code(204);
enqueue($event); // keep this quick: the forward waits 8 seconds and is never resentकिसी खाते के लिए फ़ॉरवर्डिंग कैसे चालू करें?
किसी असिस्टेंट से या अपने बैकएंड से। Claude या ChatGPT से खाते और अपने HTTPS यूआरएल के साथ set_social_webhook_destination चलाने को कहें, या अपनी ec_live_ कुंजी और url वाली बॉडी के साथ Partner API पर PUT /api/v1/channels/:id/webhook कॉल करें। दोनों ही खाते का signing_secret एक बार लौटाते हैं, इसलिए उसी समय इसे account_id के साथ स्टोर करें। दोबारा कॉल करने पर नया सीक्रेट जारी होता है, और url null हो तो फ़ॉरवर्डिंग बंद हो जाती है।
यूआरएल HTTPS होना चाहिए और सार्वजनिक होस्ट पर होना चाहिए: निजी पता सेट करते समय भी और डिलीवरी के समय भी अस्वीकार होता है। एक एंडपॉइंट कई खातों की सेवा कर सकता है, क्योंकि हर इवेंट अपना account_id बताता है। WhatsApp नंबर के लिए set_webhook_destination Meta की डिलीवरी आपकी ओर भेजता है, और forward_url के साथ set_inbound_mode इसके बजाय उन्हें साइन करके फ़ॉरवर्ड करता है।
जब आपका एंडपॉइंट धीमा या बंद हो तो क्या होता है?
इवेंट दोबारा नहीं भेजा जाता। easyCoexistence एक ही कोशिश करता है, जवाब के लिए 8 सेकंड तक इंतज़ार करता है, कोई रीडायरेक्ट नहीं मानता और कोई कॉपी नहीं रखता, क्योंकि दोबारा कोशिश करने का मतलब होगा आपके ग्राहकों के कमेंट और मैसेज स्टोर करना। हस्ताक्षर सही निकलते ही 2xx जवाब दें, धीमा काम क़्यू से करें, और नेटवर्क के अपने ID, जैसे कमेंट ID या मैसेज mid, के आधार पर डुप्लिकेट हटाएँ, ताकि इवेंट दो बार आए तो भी सही रहे।
WhatsApp अलग है। डायरेक्ट मोड में, जो डिलीवरी आपका सर्वर स्वीकार नहीं करता, Meta उसे 7 दिन तक दोबारा भेजने की कोशिश करता है। मैनेज्ड मोड में easyCoexistence आपके फ़ॉरवर्ड यूआरएल के लिए मैसेज क़्यू में रखता है और बैकऑफ़ के साथ दोबारा कोशिश करता है। Partner स्टेटस इवेंट, जैसे कनेक्शन टूटना, लगभग 33 घंटे तक दोबारा भेजे जाते हैं।
YouTube और LinkedIn के कमेंट एजेंट तक कैसे पहुँचते हैं?
शेड्यूल पर उन्हें पढ़कर। YouTube की पुश सूचनाएँ नया अपलोड, नया टाइटल या नया विवरण बताती हैं, कमेंट नहीं, और easyCoexistence LinkedIn से कोई कमेंट इवेंट नहीं पाता, इसलिए दोनों में से कुछ भी फ़ॉरवर्ड नहीं होता। एजेंट इसके बजाय जाँच करता है: list_youtube_comments किसी वीडियो के थ्रेड या पूरे चैनल के थ्रेड लौटाता है, जिनमें समीक्षा के लिए रोके गए थ्रेड भी शामिल हैं, और list_linkedin_comments किसी पोस्ट के कमेंट या किसी एक के नीचे के जवाब लौटाता है। n8n, Make या Zapier में शेड्यूल ट्रिगर यह जाँच शुरू करता है; अपने कोड में cron जॉब चैनल के क्रेडेंशियल लाता है और सीधे YouTube के commentThreads या LinkedIn के comments एंडपॉइंट को कॉल करता है।
कैसे कॉन्फ़िगर करें
- Set the destinationRun set_social_webhook_destination with the account and an HTTPS URL, or call PUT /api/v1/channels/:id/webhook with your ec_live_ key.
- Store the secretSave the signing_secret from the response against that account_id, since it is shown only once.
- Verify each deliveryCheck that the timestamp is fresh and that v1 matches an HMAC-SHA256 of the timestamp, a dot and the raw body.
- Acknowledge, then workAnswer 2xx straight away and hand the event to a queue, because easyCoexistence sends it only once.
आम गड़बड़ियाँ
- पार्स किए गए JSON पर HMAC जाँचना। सिग्नेचर रॉ बॉडी को बाइट-दर-बाइट कवर करता है, और पार्स किए गए ऑब्जेक्ट को दोबारा सीरियलाइज़ करने से वे बाइट बदल जाते हैं, इसलिए पार्स करने से पहले वेरिफ़ाई करें।
- हर खाते के लिए एक ही सीक्रेट इस्तेमाल करना। हर खाता अपने सीक्रेट से साइन करता है, इसलिए v1 की तुलना से पहले इवेंट के account_id से उसे खोजें।
- एंडपॉइंट अपडेट किए बिना डेस्टिनेशन दोबारा सेट करना। हर कॉल नया सीक्रेट जारी करती है और पुराना तुरंत साइन करना बंद कर देता है, इसलिए नया सीक्रेट तुरंत स्टोर करें।
- ऐसा यूआरएल देना जो रीडायरेक्ट करता है। फ़ॉरवर्ड कोई रीडायरेक्ट नहीं मानते, इसलिए नए पाथ या होस्ट पर जाने से इवेंट खो जाता है; अंतिम पता सेट करें।
easyCoexistence Instagram और Facebook के कमेंट, मेंशन और DMs, तथा TikTok के कमेंट, होते ही आपके एंडपॉइंट पर भेजता है, हर खाते के लिए साइन किए हुए, और WhatsApp मैसेज आपके सर्वर तक पहुँचाता है, ताकि आपके AI एजेंट हर नेटवर्क के आधिकारिक API के ज़रिए ग्राहकों की बात सुनें, और हर कनेक्शन 24/7 निगरानी में रहे। प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, जैसे-जैसे कनेक्शन जोड़ते जाएँ वैसे घटता हुआ, पहले 3 दिन निःशुल्क।
अक्सर पूछे जाने वाले सवाल
WhatsApp नंबर के मैसेज मेरे एंडपॉइंट तक कैसे पहुँचते हैं?
दो तरीकों में से एक से। set_webhook_destination Meta को उन्हें सीधे आपके सर्वर तक पहुँचाने देता है, जबकि forward_url के साथ set_inbound_mode easyCoexistence को उन्हें X-EC-Signature से साइन करके फ़ॉरवर्ड करने देता है, बैकऑफ़ के साथ दोबारा कोशिश करते हुए।
क्या एक ही इवेंट दो बार आ सकता है?
आ सकता है, इसलिए नेटवर्क के अपने ID, जैसे कमेंट ID या मैसेज mid, के आधार पर डुप्लिकेट हटाएँ। जो WhatsApp डिलीवरी आपका सर्वर स्वीकार नहीं करता, उसकी 7 दिन तक की दोबारा कोशिशें भी डुप्लिकेट ला सकती हैं।
क्या एक ही एंडपॉइंट कई खातों से इवेंट ले सकता है?
हाँ। हर इवेंट platform और account_id साथ लाता है, इसलिए एक ही यूआरएल कई खातों की सेवा कर सकता है, बशर्ते वह हर सिग्नेचर को उस खाते के अपने सीक्रेट से जाँचे।
सोशल मीडिया वेबहुक के लिए easyCoexistence की लागत कितनी है?
प्रति कनेक्शन प्रति माह US$ 9 से US$ 0.75 तक, कनेक्शन बढ़ने के साथ घटता हुआ, और हर नेटवर्क पर एक जैसी दर। फ़ॉरवर्डिंग, MCP सर्वर और Partner API शामिल हैं, पहले 3 दिन निःशुल्क।
पढ़ना जारी रखें
दो मिनट में अपना पहला चैनल कनेक्ट करें।
किसी प्लैटफ़ॉर्म की समीक्षा का इंतज़ार नहीं। WhatsApp, Instagram, TikTok या कोई और चैनल कनेक्ट करें, फिर अपने AI से पोस्ट करने, जवाब देने या रिपोर्ट बनाने को कहें और उसे काम करते देखें।
- 3 दिन मुफ़्त
- कभी भी रद्द करें
- सिर्फ़ आधिकारिक एपीआई
- 24/7 निगरानी
इस तारीख को सत्यापित