සමාජ මාධ්ය webhook: අදහස්, සඳහන් සහ පණිවිඩ එක endpoint එකට
easyCoexistence සමාජ මාධ්ය සිදුවීම් ඔබේම HTTPS endpoint එකට ඒවා සිදුවන විටම යවයි: Instagram සහ Facebook වෙතින් අදහස්, සඳහන් සහ DM, TikTok වෙතින් අදහස්. සෑම සිදුවීමක්ම එක envelope එකකින් ලැබෙන අතර, network එකේ සිදුවීම එහි නොවෙනස්ව ඇතුළත ඇත, සහ එය X-EC-Signature සමඟ ගිණුම අනුව අත්සන් කර ඇත. ගිණුම අනුව එය ක්රියාත්මක කිරීමට set_social_webhook_destination මගින් Claude හෝ ChatGPT වලින්, නැතහොත් Partner API සමඟ. WhatsApp අංකයක පණිවිඩ ද ඔබේ server එකට ළඟා වේ.
- සිදුවන විටම අදහස්, සඳහන් සහ DM
- එක envelope එකක්, සෑම ගිණුමකටම අත්සන් කළ
- Claude, ChatGPT හෝ Partner API වලින් සකසන්න
දින 3ක් කිසිදු ගාස්තුවක් නැත. ඕනෑම වේලාවක අවලංගු කරන්න.
easyCoexistence යවන සෑම සමාජ සිදුවීමක්ම කොපමණ වාර ගණනක් යවන්නේද; එය පිටපතක් තබා නොගන්නා නිසා පසුව නැවත කිසිවක් යවන්නේ නැත.
TikTok හි comment.update webhook, හිමි ගිණුමක පොදු වීඩියෝවල අදහසක් සාදන, මකන හෝ දෘශ්යතාව වෙනස් කරන විට, එය වාර්තා කරන්නේ කොපමණ ඉක්මනින්ද.
Instagram Login මත යෙදුම් @mentions ලබන ස්ථානය: comments webhook දැනුම්දීම ඇතුළත, තමන්ගේම ක්ෂේත්රයක් ලෙස නොවේ.
YouTube හි push දැනුම්දීම් නාලිකාවක් ගැන වාර්තා කරන්නේ කුමක්ද: නව උඩුගත කිරීමක්, නව මාතෘකාවක් හෝ නව විස්තරයක්.
ඔබේ server පිළිනොගත් WhatsApp webhook එකක් Meta කොපමණ කාලයක් නැවත උත්සාහ කරන්නේද, එමඟින් අනුපිටපත් ලැබිය හැක.
සෑම network එකක්ම කුමන සිදුවීම් යවන්නේද?
Instagram, Facebook සහ TikTok, easyCoexistence වෙත සිදුවීම් තල්ලු කරයි, එය සෑම එකක්ම ගිණුම සඳහා ඔබ සකසන URL එකට යවයි. Instagram නව අදහස් යවයි, @mentions comments දැනුම්දීම ඇතුළත ලැබෙන අතර, මෙන්ම DM යවයි. Facebook Page එකක් feed ක්රියාකාරකම් යවයි, එයට නව අදහස් ඇතුළත් වේ, මෙන්ම Messenger පණිවිඩ සහ Page එකේ සඳහන් යවයි. TikTok comment.update යවයි, එය අදහසක් සාදන, මකන හෝ දෘශ්යතාව වෙනස් කරන විට ක්රියාත්මක වේ.
YouTube සහ LinkedIn, easyCoexistence වෙත අදහස් හෝ පණිවිඩ සිදුවීම් කිසිවක් යවන්නේ නැත, එබැවින් agent එකක් ඒවායේ අදහස් ඉල්ලීමෙන් කියවයි. WhatsApp අංකය තමන්ගේම මාර්ගයෙන් ක්රියා කරයි: Meta එහි පණිවිඩ කෙලින්ම ඔබේ server එකට යවයි, නැතහොත් අංකය managed mode හි ධාවනය වන විට easyCoexistence ඒවා අත්සන් කර forward කරයි.
| 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 |
forward කළ සිදුවීමක් කෙසේ පෙනේද?
සෑම network එකකම එකම JSON envelope එකයි, Content-Type application/json සමඟ POST කෙරේ: platform, network එක; account_id, MCP tools සහ Partner API භාවිත කරන ID එක; external_id, network එකේ ගිණුමේ ID එක; සහ entry, network එකේම සිදුවීම එය පැමිණි ආකාරයටම. Instagram සහ Facebook සඳහා entry යනු Meta හි webhook entry එකයි, අදහස් සහ සඳහන් සඳහා changes සමඟ, DM සඳහා messaging සමඟ. TikTok සඳහා එහි comment.update සිදුවීම ඇත, comment_id, video_id සහ parent_comment_id string ලෙස, එබැවින් 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 සකසන විට ලැබෙන signing secret එකෙන්, එය එම ගිණුමට අනන්ය වන අතර එක් වරක් පමණක් පෙන්වයි. header එක t=<unix>,v1=<hex> ලෙස කියවෙන අතර, v1 යනු timestamp, තිතක් සහ raw request body හි HMAC-SHA256 වේ, එම secret සමඟ යතුරු කර ඇත. body එක parse කිරීමට පෙර bytes ලෙස කියවන්න, ඔබේ ඔරලෝසුවට වඩා මිනිත්තු 5 කට වැඩි timestamp එකක් ප්රතික්ෂේප කරන්න, secret එක event හි account_id මගින් සොයන්න, සහ digest දෙක නියත කාලයෙන් සසඳන්න. ඉන්පසු 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ගිණුමක් සඳහා forwarding ක්රියාත්මක කරන්නේ කෙසේද?
assistant එකකින් හෝ ඔබේ backend එකෙන්. Claude හෝ ChatGPT වෙත ගිණුම සහ ඔබේ HTTPS URL සමඟ set_social_webhook_destination ධාවනය කරන්න ලෙස ඉල්ලන්න, නැතහොත් Partner API හි PUT /api/v1/channels/:id/webhook ඔබේ ec_live_ key සහ url අඩංගු body එක සමඟ ඇමතුම් ලබන්න. දෙකම ගිණුමේ signing_secret එක එක් වරක් ලබා දෙයි, එබැවින් එය එවිට account_id ට එරෙහිව ගබඩා කරන්න. නැවත ඇමතීමෙන් නව secret එකක් නිකුත් වන අතර, url null නම් forwarding ක්රියාවිරහිත වේ.
URL එක HTTPS විය යුතු අතර public host එකක විය යුතුය: private address එකක් සකසන විට සහ නැවත delivery හිදී ප්රතික්ෂේප වේ. එක endpoint එකකට ගිණුම් රාශියකට සේවය කළ හැක, මන්ද සෑම සිදුවීමක්ම එහි account_id නම් කරයි. WhatsApp අංකයක් සඳහා set_webhook_destination මගින් Meta හි delivery ඔබ වෙත යොමු කරයි, සහ forward_url සහිත set_inbound_mode මගින් ඒවා අත්සන් කර forward කරයි.
ඔබේ endpoint මන්දගාමී හෝ ක්රියා නොකරන විට කුමක් සිදුවේද?
සිදුවීම නැවත යවනු නොලැබේ. easyCoexistence එක උත්සාහයක් පමණක් කරයි, පිළිතුරක් සඳහා තත්පර 8 දක්වා රැඳී සිටී, කිසිදු redirect අනුගමනය නොකරයි, පිටපතක් තබා නොගනී, මන්ද නැවත උත්සාහ කිරීම ඔබේ පාරිභෝගිකයන්ගේ අදහස් සහ පණිවිඩ ගබඩා කිරීමක් අදහස් කරයි. අත්සන පරීක්ෂා වූ වහාම 2xx පිළිතුරු දී, මන්දගාමී වැඩ queue එකකින් කරන්න, සහ network එකේම ID මත deduplicate කරන්න, අදහස් ID එකක් හෝ පණිවිඩ mid එකක් වැනි, සිදුවීමක් දෙවරක් පැමිණියහොත්.
WhatsApp වෙනස් වේ. direct mode හි, Meta, ඔබේ server පිළිනොගත් delivery එකක් දින 7 දක්වා නැවත උත්සාහ කරයි. managed mode හි, easyCoexistence පණිවිඩ ඔබේ forward URL සඳහා පෝලිමේ තබා backoff සමඟ නැවත උත්සාහ කරයි. Partner status සිදුවීම්, උදාහරණයක් ලෙස සම්බන්ධතාවයක් බිඳ වැටීම, පැය 33 ක් පමණ නැවත උත්සාහ කරයි.
YouTube සහ LinkedIn අදහස් agent එකට ළඟා වන්නේ කෙසේද?
නියමිත කාලසටහනකට අනුව කියවීමෙනි. YouTube හි push දැනුම්දීම් නව උඩුගත කිරීමක්, නව මාතෘකාවක් හෝ නව විස්තරයක් වාර්තා කරයි, අදහස් නොවේ, සහ easyCoexistence LinkedIn වෙතින් කිසිදු අදහස් සිදුවීමක් නොලබන බැවින්, කිසිවක් forward නොකරයි. agent එක ඒ වෙනුවට පරීක්ෂා කරයි: list_youtube_comments වීඩියෝවක threads හෝ මුළු නාලිකාවේම ඒවා ලබා දෙයි, සමාලෝචනය සඳහා රඳවා ඇති ඒවා ද ඇතුළුව, සහ list_linkedin_comments පළ කිරීමක අදහස් හෝ එක් පිළිතුරක් යටතේ පිළිතුරු ලබා දෙයි. n8n, Make හෝ Zapier හි schedule trigger එකක් පරීක්ෂාව ආරම්භ කරයි; ඔබේම code එකේ, cron job එකක් නාලිකාවේ credentials ලබාගෙන YouTube හි commentThreads හෝ LinkedIn හි comments endpoint එක කෙලින්ම ඇමතුම් කරයි.
එය සකසන ආකාරය
- 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.
සාමාන්ය වැරදි
- parse කළ JSON මත HMAC පරීක්ෂා කිරීම. අත්සන raw body එක byte අනුව byte ආවරණය කරයි, සහ parse කළ object එක නැවත serialize කිරීමෙන් එම bytes වෙනස් වේ, එබැවින් parse කිරීමට පෙර සත්යාපනය කරන්න.
- සෑම ගිණුමක් සඳහාම එක secret එකක් භාවිත කිරීම. සෑම ගිණුමක්ම එහි තමන්ගේම secret එකෙන් අත්සන් කරයි, එබැවින් v1 සසඳීමට පෙර event හි account_id මගින් එය සොයන්න.
- endpoint එක යාවත්කාලීන නොකර destination නැවත සැකසීම. සෑම ඇමතුමක්ම නව secret එකක් නිකුත් කරන අතර පැරණි එක වහාම අත්සන් කිරීම නවතියි, එබැවින් නව එක වහාම ගබඩා කරන්න.
- redirect වන URL එකක් ලබා දීම. forward කිරීම කිසිදු redirect අනුගමනය නොකරයි, එබැවින් නව path එකකට හෝ host එකකට යාම සිදුවීම නැති කරයි; අවසාන ලිපිනය සකසන්න.
easyCoexistence Instagram සහ Facebook අදහස්, සඳහන් සහ DM, සහ TikTok අදහස්, ඔබේ endpoint එකට සිදුවන විටම යවයි, ගිණුම අනුව අත්සන් කර, සහ WhatsApp පණිවිඩ ඔබේ server එකට යොමු කරයි, එබැවින් ඔබේ AI agents පාරිභෝගිකයන්ගෙන් ලබයි, සෑම network එකකම official API හරහා, සෑම සම්බන්ධතාවයක්ම 24/7 නිරීක්ෂණය වේ. සම්බන්ධතාවයකට මාසයකට US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
WhatsApp අංකයක පණිවිඩ මගේ endpoint එකට කෙසේ ළඟා වේද?
මාර්ග දෙකකින්. set_webhook_destination මගින් Meta ඒවා කෙලින්ම ඔබේ server එකට delivery කරයි, forward_url සහිත set_inbound_mode මගින් easyCoexistence ඒවා X-EC-Signature සමඟ අත්සන් කර, backoff සමඟ නැවත උත්සාහ කරමින් forward කරයි.
එකම සිදුවීමක් දෙවරක් පැමිණිය හැකිද?
පැමිණිය හැක, එබැවින් network එකේම ID මත deduplicate කරන්න, උදාහරණයක් ලෙස අදහස් ID එකක් හෝ පණිවිඩ mid එකක්. ඔබේ server පිළිනොගත් WhatsApp delivery එකක් නැවත උත්සාහ කිරීම, දින 7 දක්වා, අනුපිටපත් ද ලබා දිය හැක.
එක endpoint එකකට ගිණුම් කිහිපයකින් සිදුවීම් ලැබිය හැකිද?
ඔව්. සෑම සිදුවීමකම platform සහ account_id ඇත, එබැවින් එක URL එකක් ගිණුම් රාශියකට සේවය කළ හැක, එක් එක් අත්සන එම ගිණුමේම secret එකෙන් පරීක්ෂා කරන පමණට.
easyCoexistence social media webhooks සඳහා කොපමණ වියදම් වේද?
සම්බන්ධතාවයකට මාසයකට US$ 9 සිට US$ 0.75 දක්වා, සම්බන්ධතා එකතු කරන විට අඩු වේ, සෑම network එකකම එකම මිලයි. forwarding, MCP server සහ Partner API ඇතුළත්, පළමු දින 3 නොමිලේ.
තවදුරටත් කියවන්න
ඔබේ පළමු channel එක මිනිත්තු දෙකකින් සම්බන්ධ කරන්න.
වේදිකා සමාලෝචන සඳහා බලා සිටීමට අවශ්ය නැත. WhatsApp, Instagram, TikTok හෝ වෙනත් channel එකක් සම්බන්ධ කර, පසුව ඔබේ AI හට පළ කිරීමට, ප්රතිචාර දැක්වීමට හෝ වාර්තා කිරීමට පවසා එය වැඩ කරන ආකාරය බලන්න.
- දින 3ක් නොමිලේ
- ඕනෑම වේලාවක අවලංගු කරන්න
- නිල API පමණි
- 24/7 නිරීක්ෂණය කෙරේ
සත්යාපනය කළේ