సోషల్ మీడియా వెబ్హుక్లు: కామెంట్లు, మెన్షన్లు, DMలు ఒకే ఎండ్పాయింట్కు
easyCoexistence సోషల్ మీడియా ఈవెంట్లను జరిగిన వెంటనే మీ స్వంత HTTPS ఎండ్పాయింట్కు పంపుతుంది: Instagram మరియు Facebook నుంచి కామెంట్లు, మెన్షన్లు, DMలు, అలాగే TikTok నుంచి కామెంట్లు. ప్రతి ఈవెంట్ ఒకే ఎన్వలప్లో వస్తుంది, నెట్వర్క్ ఈవెంట్ మారకుండా లోపల ఉంటుంది, మరియు ఖాతా వారీగా X-EC-Signature తో సంతకం చేయబడుతుంది. Claude లేదా ChatGPT నుంచి set_social_webhook_destination తో, లేదా Partner APIతో ప్రతి ఖాతాకు దీన్ని ఆన్ చేయండి. WhatsApp నంబర్ మెసేజ్లు కూడా మీ సర్వర్కు చేరతాయి.
- కామెంట్లు, మెన్షన్లు, DMలు జరిగిన వెంటనే
- ఒకే ఎన్వలప్, ప్రతి ఖాతాకు సంతకం
- Claude, ChatGPT లేదా Partner API నుంచి సెట్ చేయండి
3 రోజులు ఎలాంటి ఛార్జీ లేదు. ఎప్పుడైనా రద్దు చేయండి.
easyCoexistence ప్రతి ఫార్వార్డ్ చేసిన సోషల్ ఈవెంట్ను ఎన్నిసార్లు పంపుతుంది; దాని కాపీ ఏదీ ఉంచదు, కాబట్టి తర్వాత మళ్లీ పంపబడదు.
TikTok యొక్క comment.update వెబ్హుక్ ఒక సొంత ఖాతా పబ్లిక్ వీడియోల్లో కామెంట్ సృష్టించబడినప్పుడు, తొలగించబడినప్పుడు లేదా దృశ్యమానత మారినప్పుడు ఎంత త్వరగా నివేదిస్తుంది.
Instagram Login యాప్లు @mentions ను ఎక్కడ అందుకుంటాయి: వాటి స్వంత ఫీల్డ్గా కాకుండా కామెంట్ల వెబ్హుక్ నోటిఫికేషన్ లోపల.
YouTube పుష్ నోటిఫికేషన్లు ఛానల్ గురించి ఏమి నివేదిస్తాయి: కొత్త అప్లోడ్, కొత్త టైటిల్ లేదా కొత్త వివరణ.
మీ సర్వర్ అంగీకరించని WhatsApp వెబ్హుక్ను Meta ఎంతకాలం మళ్లీ ప్రయత్నిస్తుంది; ఇది డూప్లికేట్లను పంపగలదు.
ప్రతి నెట్వర్క్ ఏ ఈవెంట్లను పంపుతుంది?
Instagram, Facebook మరియు TikTok ఈవెంట్లను easyCoexistence కు పుష్ చేస్తాయి, అది ప్రతి ఒక్కదాన్ని ఆ ఖాతాకు మీరు సెట్ చేసిన URLకు పంపుతుంది. Instagram కొత్త కామెంట్లను పంపుతుంది, @mentions కామెంట్ల నోటిఫికేషన్ లోపల వస్తాయి, అలాగే DMలను. Facebook Page ఫీడ్ యాక్టివిటీని పంపుతుంది, అందులో కొత్త కామెంట్లు ఉంటాయి, అలాగే 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, అది MCP టూల్స్ మరియు Partner API ఉపయోగించే ID; external_id, నెట్వర్క్లో ఖాతా యొక్క ID; మరియు entry, అది వచ్చినట్లుగా నెట్వర్క్ యొక్క స్వంత ఈవెంట్. Instagram మరియు Facebook కోసం entry అనేది Meta యొక్క వెబ్హుక్ 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 ను ఎలా వెరిఫై చేయాలి?
మీరు destination సెట్ చేసినప్పుడు తిరిగి వచ్చే సైనింగ్ సీక్రెట్తో, అది ఆ ఖాతాకు ప్రత్యేకం మరియు ఒకసారి మాత్రమే చూపబడుతుంది. హెడర్ 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ఒక ఖాతాకు ఫార్వార్డింగ్ను ఎలా ఆన్ చేయాలి?
అసిస్టెంట్ నుంచి లేదా మీ బ్యాకెండ్ నుంచి. ఖాతా మరియు మీ HTTPS URL తో set_social_webhook_destination ను నడపమని Claude లేదా ChatGPT ను అడగండి, లేదా మీ ec_live_ కీతో మరియు url ఉన్న బాడీతో Partner APIపై 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 రోజుల వరకు మళ్లీ ప్రయత్నిస్తుంది. మేనేజ్డ్ మోడ్లో, easyCoexistence మెసేజ్లను మీ ఫార్వార్డ్ URL కోసం క్యూలో ఉంచి బ్యాక్ఆఫ్తో మళ్లీ ప్రయత్నిస్తుంది. 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 ద్వారా దాన్ని వెతకండి.
- ఎండ్పాయింట్ను అప్డేట్ చేయకుండా destination ను మళ్లీ సెట్ చేయడం. ప్రతి కాల్ కొత్త సీక్రెట్ జారీ చేస్తుంది, మరియు పాత సీక్రెట్ వెంటనే సంతకం చేయడం ఆపేస్తుంది, కాబట్టి కొత్తదాన్ని వెంటనే నిల్వ చేయండి.
- రీడైరెక్ట్ చేసే URL ఇవ్వడం. ఫార్వార్డ్లు రీడైరెక్ట్లను అనుసరించవు, కాబట్టి కొత్త పాత్ లేదా హోస్ట్కు మారితే ఈవెంట్ పోతుంది; చివరి అడ్రస్ను సెట్ చేయండి.
easyCoexistence Instagram మరియు Facebook కామెంట్లు, మెన్షన్లు, DMలు, మరియు 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 డెలివరీని Meta 7 రోజుల వరకు మళ్లీ ప్రయత్నించడం వల్ల కూడా డూప్లికేట్లు రావచ్చు.
ఒకే ఎండ్పాయింట్ అనేక ఖాతాల నుంచి ఈవెంట్లను అందుకోగలదా?
అవును. ప్రతి ఈవెంట్ platform మరియు account_id ను కలిగి ఉంటుంది, కాబట్టి ఒక URL అనేక ఖాతాలకు సేవ చేయగలదు, అది ప్రతి సంతకాన్ని ఆ ఖాతా సొంత సీక్రెట్తో తనిఖీ చేసినంత వరకు.
సోషల్ మీడియా వెబ్హుక్ల కోసం easyCoexistence ఖర్చు ఎంత?
ప్రతి కనెక్షన్కు నెలకు US$ 9 నుంచి US$ 0.75 వరకు, మీరు కనెక్షన్లు జోడించే కొద్దీ తగ్గుతుంది, మరియు ప్రతి నెట్వర్క్లో ఒకే ధర. ఫార్వార్డింగ్, MCP సర్వర్ మరియు Partner API చేర్చబడ్డాయి, మొదటి 3 రోజులు ఉచితం.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ