सामाजिक सञ्जाल वेबहुक: कमेन्ट, उल्लेख र म्यासेज एउटै एन्डपोइन्टमा
easyCoexistence ले सामाजिक सञ्जालका घटनाहरू घटना हुनेबित्तिकै तपाईंकै HTTPS एन्डपोइन्टमा फर्वार्ड गर्छ: Instagram र Facebook का कमेन्ट, उल्लेख र DM, र TikTok का कमेन्ट। हरेक घटना एउटै इन्भेलोपमा आउँछ, जसभित्र नेटवर्कको घटना जस्ताको तस्तै रहन्छ, र X-EC-Signature मार्फत खातापिच्छे हस्ताक्षरित हुन्छ। यो सुविधा set_social_webhook_destination बाट Claude वा ChatGPT मा, वा Partner API मार्फत, प्रति खाता सक्रिय गर्नुहोस्। WhatsApp नम्बरका म्यासेज पनि तपाईंको सर्भरमा पुग्छन्।
- घटना हुनेबित्तिकै कमेन्ट, उल्लेख र DM
- एउटै इन्भेलोप, खातापिच्छे हस्ताक्षरसहित
- Claude, ChatGPT वा Partner API बाट सेट गर्नुहोस्
3 दिनसम्म कुनै शुल्क लाग्दैन। जुनसुकै बेला रद्द गर्नुहोस्।
easyCoexistence ले प्रत्येक फर्वार्ड गरिएको सामाजिक घटना कतिपटक पठाउँछ; यसले कुनै प्रतिलिपि राख्दैन, त्यसैले पछि पुन: पठाइँदैन।
TikTok को comment.update webhook ले स्वामित्वमा रहेको खाताको सार्वजनिक भिडियोमा कमेन्ट सिर्जना, मेटिएको वा दृश्यता बदलिएको कति छिटो रिपोर्ट गर्छ।
Instagram Login अनुप्रयोगहरूले @mentions कहाँ पाउँछन्: कमेन्ट वेबहुक सूचनाभित्र, आफ्नै छुट्टै फिल्डका रूपमा होइन।
YouTube का पुश सूचनाले च्यानलका लागि के रिपोर्ट गर्छन्: नयाँ अपलोड, नयाँ शीर्षक वा नयाँ विवरण।
Meta ले तपाईंको सर्भरले स्वीकार नगरेको WhatsApp वेबहुकलाई कति समयसम्म पुन: प्रयास गर्छ, जसले डुप्लिकेट पठाउन सक्छ।
कुन नेटवर्कले कुन घटना पठाउँछ?
Instagram, Facebook र TikTok ले घटनाहरू easyCoexistence मा पठाउँछन्, र त्यसले प्रत्येकलाई खाताका लागि सेट गरिएको URL मा फर्वार्ड गर्छ। Instagram ले नयाँ कमेन्ट र DM पठाउँछ, र @mentions कमेन्ट सूचनाभित्र आउँछन्। Facebook Page ले फिड गतिविधि पठाउँछ, जसमा नयाँ कमेन्ट पर्छन्, साथै Messenger का म्यासेज र Page का उल्लेख। 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 को webhook entry हो, कमेन्ट र उल्लेखका लागि changes सहित र DM का लागि 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खाताका लागि फर्वार्डिङ कसरी सक्रिय गर्ने?
AI सहायकबाट वा तपाईंको ब्याकएन्डबाट। Claude वा ChatGPT लाई खाता र तपाईंको HTTPS URL सहित set_social_webhook_destination चलाउन भन्नुहोस्, वा ec_live_ कुञ्जीसहित Partner API मा PUT /api/v1/channels/:id/webhook बोलाउनुहोस्, जसको बडीमा url हुन्छ। दुवैले खाताको signing_secret एकपटक फर्काउँछन्, त्यसैले त्यतिबेलै खाता ID सँग यो भण्डारण गर्नुहोस्। फेरि बोलाउँदा नयाँ गोप्य कुञ्जी जारी हुन्छ, र url को मान null भयो भने फर्वार्डिङ बन्द हुन्छ।
URL HTTPS हुनुपर्छ र सार्वजनिक होस्टमा हुनुपर्छ: निजी ठेगाना सेट गर्दा र डेलिभरी हुँदा दुवैपटक अस्वीकार गरिन्छ। एउटै एन्डपोइन्टले धेरै खाता सेवा गर्न सक्छ, किनभने हरेक घटनामा account_id नाम हुन्छ। WhatsApp नम्बरका लागि set_webhook_destination ले Meta का डेलिभरी तपाईंतर्फ पठाउँछ, र set_inbound_mode मा forward_url दिँदा तिनलाई हस्ताक्षरसहित फर्वार्ड गर्छ।
तपाईंको एन्डपोइन्ट सुस्त वा बन्द हुँदा के हुन्छ?
घटना फेरि पठाइँदैन। 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 मा शेड्युल ट्रिगरले जाँच सुरु गर्छ; आफ्नै कोडमा, क्रोन जबले च्यानलका क्रेडेन्सियल लिएर 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 जाँच नगर्नुहोस्। हस्ताक्षरले कच्चा बडीलाई बाइटै-बाइट ढाक्छ, र पार्स गरिएको वस्तुलाई फेरि क्रमबद्ध (serialize) गर्दा ती बाइट बदलिन्छन्, त्यसैले पार्स गर्नुअघि नै जाँच गर्नुहोस्।
- सबै खातामा एउटै गोप्य कुञ्जी प्रयोग नगर्नुहोस्। हरेक खाताले आफ्नै गोप्य कुञ्जीले हस्ताक्षर गर्छ, त्यसैले v1 तुलना गर्नुअघि घटनाको account_id बाट त्यो खोज्नुहोस्।
- तपाईंको एन्डपोइन्ट अद्यावधिक नगरी गन्तव्य फेरि सेट नगर्नुहोस्। हरेक बोलाइमा नयाँ गोप्य कुञ्जी जारी हुन्छ र पुरानोले तुरुन्तै हस्ताक्षर गर्न छोड्छ, त्यसैले नयाँ कुञ्जी तुरुन्तै भण्डारण गर्नुहोस्।
- पुनर्निर्देशन गर्ने URL नदिनुहोस्। फर्वार्डले रिडाइरेक्ट पछ्याउँदैनन्, त्यसैले नयाँ बाटो वा होस्टमा सर्दा घटना हराउँछ; अन्तिम ठेगाना सेट गर्नुहोस्।
easyCoexistence ले Instagram र Facebook का कमेन्ट, उल्लेख र DM, र TikTok का कमेन्ट, घटना हुनेबित्तिकै तपाईंको एन्डपोइन्टमा खातापिच्छे हस्ताक्षरसहित पठाउँछ, र WhatsApp म्यासेज पनि तपाईंको सर्भरसम्म पुर्याउँछ, ताकि तपाईंका AI एजेन्टहरूले हरेक नेटवर्कको आधिकारिक API मार्फत ग्राहकका कुरा सुनून्, र हरेक कनेक्सन 24/7 निगरानीमा राखिन्छ। प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थपिँदै जाँदा घट्दै, र पहिलो 3 दिन निःशुल्क।
बारम्बार सोधिने प्रश्नहरू
WhatsApp नम्बरका म्यासेज मेरो एन्डपोइन्टमा कसरी पुग्छन्?
दुई तरिकाले। set_webhook_destination ले Meta लाई म्यासेज सिधै तपाईंको सर्भरमा पठाउन लगाउँछ, जबकि set_inbound_mode मा forward_url दिँदा easyCoexistence ले X-EC-Signature सहित हस्ताक्षरित गरेर फर्वार्ड गर्छ र ब्याकअफसहित पुन: प्रयास गर्छ।
के एउटै घटना दुईपटक आउन सक्छ?
सक्छ, त्यसैले नेटवर्कको आफ्नै ID, जस्तै कमेन्ट ID वा म्यासेज mid, बाट डुप्लिकेट हटाउनुहोस्। तपाईंको सर्भरले स्वीकार नगरेको WhatsApp डेलिभरीमा Meta ले 7 दिनसम्म पुन: प्रयास गर्दा पनि डुप्लिकेट आउन सक्छ।
एउटै एन्डपोइन्टले धेरै खाताका घटना लिन सक्छ?
हो। हरेक घटनामा platform र account_id हुन्छ, त्यसैले एउटै URL ले धेरै खाता सेवा गर्न सक्छ, तर हरेक हस्ताक्षर त्यस खाताको आफ्नै गोप्य कुञ्जीसँग जाँचिनुपर्छ।
social media webhooks का लागि easyCoexistence को मूल्य कति हो?
प्रति कनेक्सन प्रति महिना US$ 9 देखि US$ 0.75 सम्म, कनेक्सन थपिँदै जाँदा घट्दै, र सबै नेटवर्कमा उस्तै। फर्वार्डिङ, MCP सर्भर र Partner API समावेश छन्, र पहिलो 3 दिन निःशुल्क।
पढ्दै जानुहोस्
दुई मिनेटमै आफ्नो पहिलो च्यानल जडान गर्नुहोस्।
प्लेटफर्मको समीक्षा कुर्नुपर्दैन। WhatsApp, Instagram, TikTok वा अर्को च्यानल जडान गर्नुहोस्, अनि आफ्नो AI लाई पोस्ट गर्न, जवाफ दिन वा रिपोर्ट बनाउन भन्नुहोस् र काम भइरहेको हेर्नुहोस्।
- 3 दिन निःशुल्क
- जुनसुकै बेला रद्द गर्नुहोस्
- आधिकारिक एपीआई मात्र
- 24/7 निगरानी
प्रमाणीकरण गरिएको