سوشل میڈیا ویب ہکس: کمنٹس، مینشنز اور میسجز ایک اینڈ پوائنٹ تک
easyCoexistence سوشل میڈیا کے ایونٹس کو جیسے ہی ہوتے ہیں آپ کے اپنے HTTPS اینڈ پوائنٹ تک فارورڈ کرتا ہے: Instagram اور Facebook سے کمنٹس، مینشنز اور DMs، اور TikTok سے کمنٹس۔ ہر ایونٹ ایک ہی لفافے میں آتا ہے، جس کے اندر نیٹ ورک کا ایونٹ بغیر تبدیلی کے ہوتا ہے، اور ہر اکاؤنٹ کے لیے الگ X-EC-Signature کے ساتھ دستخط شدہ ہوتا ہے۔ اسے ہر اکاؤنٹ کے لیے Claude یا ChatGPT سے set_social_webhook_destination کے ذریعے، یا Partner API سے آن کریں۔ WhatsApp نمبر کے میسجز بھی آپ کے سرور تک پہنچتے ہیں۔
- کمنٹس، مینشنز اور DMs، ہوتے ہی
- ایک لفافہ، ہر اکاؤنٹ کے لیے الگ دستخط کے ساتھ
- Claude، ChatGPT یا Partner API سے سیٹ کریں
3 دن تک کچھ وصول نہیں کیا جائے گا۔ کسی بھی وقت cancel کریں۔
easyCoexistence ہر فارورڈ کیے گئے سوشل ایونٹ کو کتنی بار بھیجتا ہے؛ یہ کوئی کاپی نہیں رکھتا، اس لیے بعد میں دوبارہ کچھ نہیں بھیجا جاتا۔
TikTok کا comment.update ویب ہک کسی ملکیتی اکاؤنٹ کی عوامی ویڈیوز پر کمنٹ بننے، حذف ہونے یا مرئیت بدلنے کی اطلاع کتنی جلدی دیتا ہے۔
Instagram Login پر ایپس @mentions کہاں وصول کرتی ہیں: کمنٹس ویب ہک کی اطلاع کے اندر، اپنے الگ فیلڈ کے طور پر نہیں۔
YouTube کے پش نوٹیفیکیشنز کسی چینل کے بارے میں کیا بتاتے ہیں: نیا اپ لوڈ، نیا ٹائٹل یا نئی تفصیل۔
Meta کتنی دیر تک WhatsApp ویب ہک کی دوبارہ کوشش کرتا رہتا ہے جسے آپ کا سرور قبول نہیں کرتا، اور اس سے ڈپلیکیٹ میسجز بھی آ سکتے ہیں۔
ہر نیٹ ورک کون سے ایونٹس بھیجتا ہے؟
Instagram، Facebook اور TikTok ایونٹس easyCoexistence کو بھیجتے ہیں، جو ہر ایک کو اس URL پر آگے بھیج دیتا ہے جو آپ اس اکاؤنٹ کے لیے سیٹ کرتے ہیں۔ Instagram نئے کمنٹس بھیجتا ہے، جبکہ @mentions کمنٹس کی اطلاع کے اندر آتے ہیں، اور DMs بھی۔ Facebook Page فیڈ کی سرگرمی بھیجتا ہے، جس میں نئے کمنٹس شامل ہیں، ساتھ ہی Messenger میسجز اور Page کا ذکر۔ 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 بٹ IDs گول نہ ہوں۔ 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_ کلید کے ساتھ PUT /api/v1/channels/:id/webhook کال کریں، جس کی باڈی میں url ہو۔ دونوں اکاؤنٹ کا signing_secret ایک بار واپس کرتے ہیں، اس لیے اسے اسی وقت account_id کے ساتھ محفوظ کریں۔ دوبارہ کال کرنے پر نیا سیکرٹ جاری ہوتا ہے، اور url کی قدر null ہو تو فارورڈنگ بند ہو جاتی ہے۔
URL کا HTTPS ہونا لازم ہے اور وہ عوامی ہوسٹ پر ہو: نجی ایڈریس سیٹ کرتے وقت بھی رد ہوتا ہے اور ڈیلیوری کے وقت بھی۔ ایک اینڈ پوائنٹ کئی اکاؤنٹس کو سروس دے سکتا ہے، کیونکہ ہر ایونٹ اپنے account_id کا نام لیتا ہے۔ WhatsApp نمبر کے لیے set_webhook_destination، Meta کی ڈیلیوریز آپ تک پہنچاتا ہے، اور set_inbound_mode کے ساتھ forward_url انہیں دستخط شدہ فارورڈ کرتا ہے۔
جب آپ کا اینڈ پوائنٹ سست ہو یا بند ہو تو کیا ہوتا ہے؟
ایونٹ دوبارہ نہیں بھیجا جاتا۔ easyCoexistence ایک کوشش کرتا ہے، جواب کا زیادہ سے زیادہ 8 سیکنڈ تک انتظار کرتا ہے، کوئی ری ڈائریکٹ فالو نہیں کرتا اور کوئی کاپی نہیں رکھتا، کیونکہ دوبارہ کوشش کا مطلب ہوگا آپ کے صارفین کے کمنٹس اور میسجز محفوظ کرنا۔ دستخط درست ہوتے ہی 2xx جواب دیں، سست کام کسی کیو کے ذریعے کریں، اور نیٹ ورک کی اپنی IDs پر ڈپلیکیٹ ہٹائیں، جیسے کمنٹ ID یا میسج mid، کیونکہ ایونٹ دو بار بھی آ سکتا ہے۔
WhatsApp مختلف ہے۔ براہ راست موڈ میں Meta اس ڈیلیوری کو 7 دن تک دوبارہ کوشش کرتا ہے جسے آپ کا سرور قبول نہیں کرتا۔ منیجڈ موڈ میں 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 کی تصدیق کرنا۔ دستخط خام باڈی کو بائٹ بہ بائٹ ڈھانپتا ہے، اور پارس شدہ آبجیکٹ کو دوبارہ سیریلائز کرنے سے وہ بائٹس بدل جاتی ہیں، اس لیے پارس کرنے سے پہلے تصدیق کریں۔
- ہر اکاؤنٹ کے لیے ایک ہی سیکرٹ استعمال کرنا۔ ہر اکاؤنٹ اپنے سیکرٹ سے دستخط کرتا ہے، اس لیے v1 کا موازنہ کرنے سے پہلے اسے ایونٹ کے account_id سے تلاش کریں۔
- اپنا اینڈ پوائنٹ اپ ڈیٹ کیے بغیر ڈیسٹینیشن دوبارہ سیٹ کرنا۔ ہر کال نیا سیکرٹ جاری کرتی ہے اور پرانا فوراً دستخط کرنا بند کر دیتا ہے، اس لیے نیا سیکرٹ فوراً محفوظ کریں۔
- ایسا URL دینا جو ری ڈائریکٹ کرتا ہو۔ فارورڈز کوئی ری ڈائریکٹ فالو نہیں کرتے، اس لیے نئے پاتھ یا ہوسٹ پر جانے سے ایونٹ ضائع ہو جاتا ہے؛ حتمی پتہ سیٹ کریں۔
easyCoexistence Instagram اور Facebook کے کمنٹس، مینشنز اور DMs، اور 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 کے ساتھ دستخط شدہ فارورڈ کرتا ہے اور بیک آف کے ساتھ دوبارہ کوشش کرتا ہے۔
کیا ایک ہی ایونٹ دو بار آ سکتا ہے؟
ہاں، اس لیے نیٹ ورک کی اپنی IDs پر ڈپلیکیٹ ہٹائیں، جیسے کمنٹ ID یا میسج mid۔ وہ WhatsApp ڈیلیوری جسے آپ کا سرور قبول نہیں کرتا، اس کی 7 دن تک کی دوبارہ کوششیں بھی ڈپلیکیٹ لا سکتی ہیں۔
کیا ایک ہی اینڈ پوائنٹ کئی اکاؤنٹس کے ایونٹس وصول کر سکتا ہے؟
ہاں۔ ہر ایونٹ platform اور account_id لے کر آتا ہے، اس لیے ایک URL کئی اکاؤنٹس کو سروس دے سکتا ہے، بشرطیکہ وہ ہر دستخط کو اس اکاؤنٹ کے اپنے سیکرٹ سے جانچے۔
سوشل میڈیا ویب ہکس کے لیے easyCoexistence کی قیمت کتنی ہے؟
فی کنکشن فی ماہ US$ 9 سے US$ 0.75 تک، جیسے جیسے کنکشن بڑھتے ہیں قیمت کم ہوتی ہے، اور ہر نیٹ ورک پر یکساں ہے۔ فارورڈنگ، MCP سرور اور Partner API شامل ہیں، اور پہلے 3 دن مفت ہیں۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ