सोशल मीडिया वेबहुक: कमेंट्स, मेन्शन्स आणि मेसेजेस एकाच एंडपॉइंटवर
easyCoexistence सोशल मीडिया घटना घडताच तुमच्या स्वतःच्या HTTPS एंडपॉइंटवर पाठवते: Instagram आणि Facebook वरील कमेंट्स, मेन्शन्स आणि डायरेक्ट मेसेजेस, तसेच TikTok वरील कमेंट्स. प्रत्येक घटना एकाच लिफाफ्यात येते, नेटवर्कची मूळ घटना त्यात जशीच्या तशी असते, आणि प्रत्येक खात्यासाठी X-EC-Signature ने सही केलेली असते. प्रत्येक खात्यासाठी हे चालू करण्यासाठी Claude किंवा ChatGPT वरून set_social_webhook_destination चालवा, किंवा Partner API वापरा. WhatsApp नंबरचे मेसेजेसही तुमच्या सर्व्हरपर्यंत पोहोचतात.
- कमेंट्स, मेन्शन्स आणि डायरेक्ट मेसेजेस घडताच
- एका लिफाफ्यात, प्रत्येक खात्यासाठी सही केलेले
- Claude, ChatGPT किंवा Partner API वरून सेट करा
3 दिवस कोणतेही शुल्क नाही. कधीही रद्द करा.
easyCoexistence प्रत्येक पाठवलेली सोशल घटना किती वेळा पाठवते; ती कोणतीही प्रत ठेवत नाही, त्यामुळे नंतर काहीही पुन्हा पाठवले जात नाही.
TikTok चा comment.update वेबहुक, मालकीच्या खात्याच्या सार्वजनिक व्हिडिओंवरील कमेंट तयार, हटवलेली किंवा दृश्यता बदललेली असल्याचे किती लवकर कळवतो.
Instagram Login वरील ॲप्सना @mentions कुठे मिळतात: कमेंट्सच्या वेबहुक सूचनेच्या आत, स्वतंत्र फील्ड म्हणून नव्हे.
YouTube च्या पुश सूचना एखाद्या चॅनलबाबत काय कळवतात: नवा अपलोड, नवे शीर्षक किंवा नवे वर्णन.
Meta WhatsApp वेबहुक किती वेळ पुन्हा पाठवत राहते, जो तुमच्या सर्व्हरने स्वीकारला नाही, आणि त्यामुळे डुप्लिकेट येऊ शकतात.
प्रत्येक नेटवर्क कोणत्या घटना पाठवते?
Instagram, Facebook आणि TikTok easyCoexistence ला घटना पाठवतात, आणि easyCoexistence प्रत्येक घटना तुम्ही त्या खात्यासाठी सेट केलेल्या URL वर पोहोचवते. Instagram नवे कमेंट्स पाठवते, @mentions कमेंट्सच्या सूचनेच्या आत येतात, आणि डायरेक्ट मेसेजेसही पाठवते. Facebook Page फीड क्रियाकलाप पाठवते, ज्यात नवे कमेंट्स येतात, तसेच Messenger मेसेजेस आणि पेजचे मेन्शन्स. TikTok comment.update पाठवते, जो कमेंट तयार झाल्यावर, हटवल्यावर किंवा दृश्यता बदलल्यावर सक्रिय होतो.
YouTube आणि LinkedIn easyCoexistence ला कोणतीही कमेंट किंवा मेसेज घटना पाठवत नाहीत, त्यामुळे एजंट त्यांचे कमेंट्स मागणीनुसार वाचतो. WhatsApp नंबर स्वतःच्या मार्गाने काम करतो: Meta मेसेजेस थेट तुमच्या सर्व्हरवर पोहोचवते, किंवा नंबर managed मोडमध्ये असेल तर 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, म्हणजे MCP टूल्स आणि Partner API वापरतात तो ID; external_id, म्हणजे नेटवर्कवरील खात्याचा ID; आणि entry, म्हणजे नेटवर्कची स्वतःची घटना जशी आली तशी. Instagram आणि Facebook साठी entry ही Meta ची वेबहुक entry आहे, कमेंट्स व मेन्शन्ससाठी changes आणि डायरेक्ट मेसेजेससाठी messaging असते. TikTok साठी त्यात comment.update घटना असते, ज्यात comment_id, video_id आणि parent_comment_id स्ट्रिंग म्हणून असतात, त्यामुळे 64-बिट 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 URL देऊन set_social_webhook_destination चालवायला सांगा, किंवा Partner API वर तुमच्या ec_live_ कीसह आणि url असलेल्या बॉडीसह PUT /api/v1/channels/:id/webhook कॉल करा. दोन्ही खात्याचे signing_secret एकदाच परत देतात, म्हणून तेव्हाच account_id सोबत ते साठवा. पुन्हा कॉल केल्यास नवा सिक्रेट मिळतो, आणि url null दिल्यास फॉरवर्डिंग बंद होते.
URL HTTPS असला पाहिजे आणि सार्वजनिक होस्टवर असला पाहिजे: खाजगी पत्ता सेट करतानाही आणि डिलिव्हरीच्या वेळीही नाकारला जातो. एकच एंडपॉइंट अनेक खात्यांना सेवा देऊ शकतो, कारण प्रत्येक घटना account_id नावाने येते. WhatsApp नंबरसाठी set_webhook_destination Meta च्या डिलिव्हरी तुमच्याकडे वळवतो, आणि forward_url असलेला set_inbound_mode त्या सहीसह फॉरवर्ड करतो.
तुमचा एंडपॉइंट धीमा किंवा बंद असेल तर काय होते?
घटना पुन्हा पाठवली जात नाही. easyCoexistence एकच प्रयत्न करते, उत्तरासाठी 8 सेकंदांपर्यंत थांबते, कोणतेही रीडायरेक्ट पाळत नाही आणि प्रत ठेवत नाही, कारण पुन्हा प्रयत्न करणे म्हणजे तुमच्या ग्राहकांचे कमेंट्स आणि मेसेजेस साठवणे ठरेल. सही तपासली की लगेच 2xx द्या, संथ काम रांगेतून करा, आणि नेटवर्कच्या स्वतःच्या ID वर (जसे कमेंट ID किंवा मेसेज mid) डुप्लिकेट काढा, कारण घटना दोनदा येऊ शकते.
WhatsApp वेगळे आहे. थेट मोडमध्ये Meta तुमच्या सर्व्हरने स्वीकारली नाही अशी डिलिव्हरी 7 दिवसांपर्यंत पुन्हा पाठवते. managed मोडमध्ये easyCoexistence मेसेजेस तुमच्या फॉरवर्ड URL साठी रांगेत ठेवते आणि बॅकऑफसह पुन्हा प्रयत्न करते. Partner स्टेटसच्या घटना, जसे कनेक्शन तुटणे, सुमारे 33 तासांपर्यंत पुन्हा पाठवल्या जातात.
YouTube आणि LinkedIn कमेंट्स एजंटपर्यंत कसे पोहोचतात?
वेळापत्रकानुसार वाचून. YouTube च्या पुश सूचना नवा अपलोड, नवे शीर्षक किंवा नवे वर्णन कळवतात, कमेंट्स नाही, आणि easyCoexistence ला LinkedIn कडून कोणत्याही कमेंट घटना मिळत नाहीत, त्यामुळे दोघेही काहीही फॉरवर्ड करत नाहीत. एजंट त्याऐवजी तपासतो: list_youtube_comments एका व्हिडिओचे धागे किंवा संपूर्ण चॅनलचे धागे परत देते, ज्यात पुनरावलोकनासाठी रोखलेले धागेही असतात, आणि list_linkedin_comments एका पोस्टवरील कमेंट्स किंवा त्यातील उत्तरे परत देते. n8n, Make किंवा Zapier मध्ये शेड्यूल ट्रिगर ही तपासणी सुरू करतो; तुमच्या स्वतःच्या कोडमध्ये cron job चॅनलचे क्रेडेन्शियल्स आणतो आणि 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.
सामान्य चुका
- HMAC पार्स केलेल्या JSON वर तपासणे. सही रॉ बॉडी बाइट-बाइट कव्हर करते, आणि पार्स केलेली वस्तू पुन्हा सिरीयलाइज केल्यास ते बाइट्स बदलतात, म्हणून पार्स करण्यापूर्वीच तपासा.
- प्रत्येक खात्यासाठी एकच सिक्रेट वापरणे. प्रत्येक खाते स्वतःच्या सिक्रेटने सही करते, म्हणून v1 तुलना करण्यापूर्वी घटनेच्या account_id वरून सिक्रेट शोधा.
- एंडपॉइंट अपडेट न करता गंतव्य पुन्हा सेट करणे. प्रत्येक कॉल नवा सिक्रेट देतो आणि जुना सिक्रेट लगेच सही करणे थांबवतो, म्हणून नवा सिक्रेट लगेच साठवा.
- रीडायरेक्ट करणारा URL देणे. फॉरवर्ड कोणतेही रीडायरेक्ट पाळत नाहीत, त्यामुळे नव्या पथ किंवा होस्टवर गेल्यास घटना हरवते; अंतिम पत्ता सेट करा.
easyCoexistence Instagram आणि Facebook वरील कमेंट्स, मेन्शन्स आणि डायरेक्ट मेसेजेस, तसेच TikTok वरील कमेंट्स घडताच तुमच्या एंडपॉइंटवर पाठवते, प्रत्येक खात्याच्या सहीसह, आणि WhatsApp मेसेजेस तुमच्या सर्व्हरवर वळवते, जेणेकरून तुमचे AI एजंट प्रत्येक नेटवर्कच्या अधिकृत एपीआय द्वारे ग्राहकांचे ऐकतात, आणि प्रत्येक कनेक्शनवर 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 दिवसांपर्यंत Meta कडून होणारे पुन्हा प्रयत्नही डुप्लिकेट आणू शकतात.
एकच एंडपॉइंट अनेक खात्यांकडून घटना घेऊ शकतो का?
हो. प्रत्येक घटनेत platform आणि account_id असतात, त्यामुळे एकच URL अनेक खात्यांना सेवा देऊ शकतो, जोपर्यंत तो प्रत्येक सही त्या खात्याच्या स्वतःच्या सिक्रेटने तपासतो.
सोशल मीडिया वेबहुकसाठी easyCoexistence किती खर्च येतो?
प्रति कनेक्शन दरमहा US$ 9 ते US$ 0.75, कनेक्शन वाढवल्यावर कमी होत जाते आणि प्रत्येक नेटवर्कसाठी सारखेच. फॉरवर्डिंग, MCP सर्व्हर आणि Partner API समाविष्ट आहेत, पहिले 3 दिवस मोफत.
पुढे वाचा
तुमचे पहिले चॅनेल दोन मिनिटांत कनेक्ट करा.
कोणत्याही प्लॅटफॉर्म पुनरावलोकनाची वाट पाहावी लागत नाही. WhatsApp, Instagram, TikTok किंवा दुसरे चॅनेल कनेक्ट करा, मग तुमच्या AI ला पोस्ट करायला, उत्तर द्यायला किंवा रिपोर्ट द्यायला सांगा आणि ते काम करताना पाहा.
- 3 दिवस मोफत
- कधीही रद्द करा
- फक्त अधिकृत एपीआय
- 24/7 देखरेख
पडताळले: