لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

TikTok کمنٹ ویب ہک ایونٹس

TikTok کا API for Business تصویری پوسٹس اور عوامی ویڈیوز پر کسی اکاؤنٹ کے کمنٹ یا ریپلائی بننے، حذف ہونے، چھپنے، صرف دوستوں کے لیے ہونے یا عوامی ہونے کے پانچ منٹ کے اندر comment.update ویب ہک بھیجتا ہے۔ ہر ایونٹ کمنٹ، پوسٹ، ایکشن، کمنٹر کی شناخت اور متن بتاتا ہے، اور Tiktok-Signature ہیڈر کے ساتھ دستخط شدہ ہوتا ہے۔

easyCoexistence ہر TikTok کمنٹ ایونٹ کو اکاؤنٹ کے لیے آپ کے HTTPS اینڈ پوائنٹ تک جیسے ہی آتا ہے آگے بھیجتا ہے، اس اکاؤنٹ کی اپنی خفیہ کلید سے دستخط شدہ اور بغیر کوئی کاپی رکھے۔

5 min

کمنٹ یا ریپلائی بننے، حذف ہونے یا نمائش بدلنے کے بعد comment.update کے بھیجے جانے کی مدت۔

72 hours

کتنی مدت تک TikTok اس ڈیلیوری کو دوبارہ بھیجتا ہے جس کا کال بیک HTTP 200 کے ساتھ جواب نہ دے، اور وقفہ ایکسپونینشلی بڑھتا ہے۔

comment.list

وہ اسکوپ جو اکاؤنٹ کو دینا اور درست رکھنا ہوگا تاکہ اس کے comment.update ایونٹس بھیجے جا سکیں۔

At least once

TikTok کا ڈیلیوری وعدہ ہے کہ ایک ہی ایونٹ ایک سے زیادہ بار بھی پہنچ سکتا ہے، اس لیے ہینڈلنگ آئیڈمپوٹنٹ ہونی چاہیے۔

comment.update کیا بتاتا ہے؟

اکاؤنٹ کی تصویری پوسٹس اور عوامی ویڈیو پوسٹس پر کمنٹس میں تبدیلیاں، چاہے وہ API کے ذریعے شائع ہوئی ہوں یا TikTok ایپ میں۔ comment_action بتاتا ہے کہ کیا ہوا:

  • insert: کمنٹ یا ریپلائی بنایا گیا۔
  • delete: اسے حذف کیا گیا۔
  • set_to_hidden: اسے چھپا دیا گیا، یا تو صارف نے یا ماڈریشن کے ذریعے۔
  • set_to_friends_only: اسے صرف دوستوں کو دکھائی دینے کے لیے سیٹ کیا گیا۔
  • set_to_public: یہ چھپے ہوئے یا صرف دوستوں کے لیے ہونے سے بدل کر سب کو دکھائی دینے لگا۔

ایک ایونٹ میں کیا ہوتا ہے؟

TikTok JSON پوسٹ کرتا ہے جس میں client_key، event، create_time، user_openid (جو اکاؤنٹ کی ID ہے) اور content شامل ہوتے ہیں، جو ایک سیریلائز شدہ JSON string ہے۔ content کے اندر comment_id اور video_id، ریپلائی کے لیے parent_comment_id، comment_type (comment یا reply)، comment_action، ٹائم اسٹیمپ، کمنٹر کا unique_identifier اور متن ہوتے ہیں۔ IDs بھی JSON نمبرز ہیں جو double میں درست طور پر نہیں سما سکتے، اس لیے انہیں خام string سے پڑھیں۔

ایونٹس آپ کے اینڈ پوائنٹ تک کیسے پہنچتے ہیں؟

TikTok ویب ہکس ڈویلپر ایپ کو بھیجتا ہے، پوری ایپ کے لیے ایک ہی کال بیک URL کے ذریعے۔ easyCoexistence انہیں وصول کرتا ہے اور جڑے ہوئے اکاؤنٹ کا ہر comment.update اس HTTPS اینڈ پوائنٹ تک، ایک بار، جیسے ہی آتا ہے، اس اکاؤنٹ کی اپنی خفیہ کلید سے دستخط کر کے بھیجتا ہے۔ اسے Claude یا ChatGPT سے set_social_webhook_destination کے ساتھ، یا Partner API کے ذریعے PUT /channels/:id/webhook سے سیٹ کریں؛ خفیہ کلید ایک بار دکھائی جاتی ہے، اور null URL فارورڈنگ بند کر دیتا ہے۔

آگے بھیجے گئے ایونٹ کی شکل کیا ہوتی ہے؟

ایک POST جس میں platform، account_id (جو list_social_accounts کنکشن کو دیتا ہے)، اکاؤنٹ کا external_id (جو TikTok کا open_id ہے) اور entry ہوتا ہے: ایونٹ کا نام، create_time اور content، جو پہلے سے پارس ہو چکا ہوتا ہے اور جس کی IDs string میں بدل دی گئی ہوتی ہیں تاکہ کوئی ID گول نہ ہو۔

A forwarded comment.update event
{
  "platform": "tiktok",
  "account_id": "<ACCOUNT_ID>",
  "external_id": "<TIKTOK_OPEN_ID>",
  "entry": {
    "event": "comment.update",
    "create_time": 1793318400,
    "content": {
      "comment_id": "<COMMENT_ID>",
      "video_id": "<VIDEO_ID>",
      "parent_comment_id": null,
      "comment_type": "comment",
      "comment_action": "insert",
      "timestamp": 1793318399000,
      "unique_identifier": "<UNIQUE_IDENTIFIER>",
      "text": "<COMMENT_TEXT>"
    }
  }
}

آگے بھیجے گئے ایونٹ کی تصدیق کیسے کریں؟

ہر آگے بھیجی گئی ڈیلیوری میں X-EC-Signature ہیڈر ہوتا ہے، جس کی شکل t=<unix>,v1=<hex> ہے، جہاں v1 ٹائم اسٹیمپ، ایک نقطہ اور خام باڈی کا HMAC-SHA256 ہے، جس کی کلید اکاؤنٹ کی دستخطی خفیہ کلید ہوتی ہے۔ باڈی کو بالکل ویسے ہی دوبارہ حساب کریں جیسے وہ آئی، دونوں کا موازنہ مستقل وقت میں کریں، اور ایسا ٹائم اسٹیمپ رد کریں جو 5 منٹ سے پرانا ہو۔

کیا ڈیلیوری دوبارہ کوشش کی جاتی ہے؟

easyCoexistence ایسا نہیں کرتا۔ ہر ایونٹ ایک بار، میموری میں آگے بھیجا جاتا ہے، اور کوئی کاپی نہیں رکھی جاتی جس سے دوبارہ کوشش ہو سکے؛ فارورڈ 8 سیکنڈ جواب کا انتظار کرتا ہے اور ری ڈائریکٹ کے پیچھے نہیں جاتا۔ اوپر کی طرف، TikTok اپنی ڈیلیوریز کو 72 گھنٹے تک دوبارہ کوشش کرتا ہے اور کم از کم ایک بار پہنچانے کا وعدہ کرتا ہے، اس لیے ایک ہی ایونٹ آپ تک دو بار پہنچ سکتا ہے: comment_id اور comment_action کو ملا کر ڈپلیکیٹ ہٹائیں۔

عام غلطیاں

  • IDs کو نمبر میں پارس کرنا۔ comment_id اور video_id، double میں درست طور پر سمانے کے لیے بہت بڑے ہیں؛ easyCoexistence انہیں string کے طور پر آگے بھیجتا ہے، اس لیے انہیں ویسا ہی رکھیں۔
  • باڈی کی پارس شدہ کاپی پر دستخط کا حساب لگانا۔ HMAC وہ خام باڈی ڈھانپتا ہے جیسے وہ آئی، اور اسے دوبارہ سیریلائز کرنے سے میچ ٹوٹ جاتا ہے۔
  • ایک دہرائے گئے ایونٹ کو دو بار ہینڈل کرنا۔ TikTok کم از کم ایک بار ڈیلیور کرتا ہے، اس لیے کوئی بھی کارروائی کرنے سے پہلے comment_id اور comment_action کو کلید بنائیں۔
  • ایسے پتے پر ڈیسٹینیشن لگانا جو ری ڈائریکٹ کرتا ہو۔ فارورڈنگ ری ڈائریکٹ کی پیروی نہیں کرتی، اس لیے آخری HTTPS URL دیں۔
EasyCoexistence کے ساتھ یہ کام کرنا

اسے Claude یا ChatGPT سے set_social_webhook_destination کے ساتھ، یا Partner API سے آن کریں۔ قیمت US$ 9 سے US$ 0.75 فی کنکشن فی مہینہ، کنکشن بڑھنے کے ساتھ کم ہوتی ہوئی، پہلے 3 دن فری ٹرائل کے ساتھ۔

اکثر پوچھے جانے والے سوالات

کون سے TikTok ویب ہک ایونٹس آگے بھیجے جاتے ہیں؟

comment.update، جڑے ہوئے اکاؤنٹ کی پوسٹس پر کمنٹس اور ریپلائیز کے لیے: بنایا گیا، حذف کیا گیا، چھپایا گیا، صرف دوستوں کے لیے سیٹ کیا گیا یا عوامی کیا گیا۔

کیا TikTok کی اشاعت کے ایونٹس بھی آگے بھیجے جاتے ہیں؟

نہیں۔ فارورڈنگ کمنٹ ایونٹس بھیجتی ہے؛ کسی پوسٹ کی اشاعت کو اس کے بجائے get_tiktok_publish_status سے ٹریک کریں۔

TikTok کمنٹ ایونٹ کتنی جلدی پہنچتا ہے؟

TikTok تبدیلی کے پانچ منٹ کے اندر comment.update بھیجتا ہے، اور easyCoexistence اسے آتے ہی آگے بھیج دیتا ہے۔

کیا TikTok کمنٹ ایونٹ میں متن شامل ہوتا ہے؟

TikTok ایونٹ کے content میں text فیلڈ بیان کرتا ہے، جو کمنٹ اور پوسٹ کی IDs، ایکشن اور کمنٹر کے unique_identifier کے ساتھ ہوتا ہے۔

مزید پڑھیں

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ