تسجيل الدخولابدأ الفترة التجريبية المجانية
easyCoexistence واجهات API الرسمية

أحداث webhook لتعليقات TikTok

ترسل TikTok API for Business حدث comment.update عبر خطاف الويب (webhook) خلال خمس دقائق من إنشاء تعليق أو رد على حساب، أو حذفه، أو إخفائه، أو تحويله إلى الأصدقاء فقط أو جعله عامًا، وذلك في منشورات الصور ومقاطع الفيديو العامة للحساب. يحدد كل حدث التعليق والمنشور والإجراء ومعرّف صاحب التعليق والنص، ويكون موقّعًا برأس 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، وهو معرّف الحساب، وcontent، وهو سلسلة JSON مُسلسَلة. داخل content: comment_id وvideo_id، وparent_comment_id في الردود، وcomment_type (comment أو reply)، وcomment_action، وطابع زمني، وunique_identifier لصاحب التعليق، والنص. المعرّفات أرقام JSON أكبر من أن يحفظها نوع double بدقة، لذا اقرأها من السلسلة الخام.

كيف تصل الأحداث إلى نقطة النهاية الخاصة بك؟

يرسل TikTok أحداث webhook إلى تطبيق المطوّر، عبر عنوان URL واحد للاستدعاء للتطبيق بأكمله. يستقبلها easyCoexistence ويمرّر كل حدث comment.update لحساب متصل إلى نقطة نهاية HTTPS التي حددتها له، مرة واحدة، فور وصوله، موقّعًا بالسر الخاص بذلك الحساب. عيّن نقطة النهاية باستخدام set_social_webhook_destination من Claude أو ChatGPT، أو عبر Partner API باستخدام PUT /channels/:id/webhook؛ يُعرض السر مرة واحدة، ويؤدي عنوان URL فارغ إلى إيقاف التمرير.

كيف يبدو الحدث المُمرَّر؟

طلب POST يتضمن المنصة، وaccount_id الذي يعطيه list_social_accounts للاتصال، وexternal_id للحساب، وهو open_id في TikTok، وentry: اسم الحدث وcreate_time وcontent، مع تحليل content مسبقًا وتحويل معرّفاته إلى نصوص حتى لا يُقرَّب أي منها.

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 معًا.

الأخطاء الشائعة

  • تحليل المعرّفات كأرقام. comment_id وvideo_id أكبر مما يحفظه double بدقة؛ يمررهما easyCoexistence نصوصًا، فاحتفظ بها كذلك.
  • حساب التوقيع على نسخة محللة من النص. يغطي HMAC النص الخام كما وصل، وإعادة تسلسله تكسر التطابق.
  • معالجة الحدث المكرر مرتين. يسلّم TikTok مرة واحدة على الأقل، لذا اعتمد على comment_id وcomment_action قبل التنفيذ.
  • توجيه الوجهة إلى عنوان يعيد التوجيه. لا يتبع التمرير عمليات إعادة التوجيه، لذا أعطِ عنوان HTTPS النهائي.
إنجاز ذلك باستخدام EasyCoexistence

فعّله باستخدام set_social_webhook_destination من Claude أو ChatGPT، أو عبر Partner API. من US$ 9 إلى US$ 0.75 لكل اتصال شهريًا، ويقل السعر كلما أضفت اتصالات، مع فترة تجريبية مجانية مدتها 3 أيام.

الأسئلة الشائعة

ما أحداث webhook في TikTok التي تُمرَّر؟

comment.update، للتعليقات والردود على منشورات الحساب المتصل: إنشاؤها وحذفها وإخفاؤها وضبطها للأصدقاء فقط أو للجميع.

هل تُمرَّر أحداث النشر في TikTok أيضًا؟

لا. يمرّر التمرير أحداث التعليقات فقط؛ تابع نشر المنشور باستخدام get_tiktok_publish_status بدلًا من ذلك.

ما مدى سرعة وصول حدث تعليق في TikTok؟

يرسل TikTok الحدث comment.update خلال خمس دقائق من التغيير، ويمرره easyCoexistence فور وصوله.

هل يتضمن حدث تعليق TikTok النص؟

يوثّق TikTok حقل text في content الحدث، إلى جانب معرّفي التعليق والمنشور والإجراء، وunique_identifier لصاحب التعليق.

تابع القراءة

ردود تعليقات TikTok والإشراف عليها عبر واجهة برمجة التطبيقات (API)كيف تقرأ واجهة TikTok للأعمال التعليقات وترد عليها وتخفيها وتحذفها، وكيف ترد القواعد والأتمتة على التعليقات الجديدة تلقائياً.TikTok API for Business مقابل Content Posting APIلماذا TikTok API for Business بدلًا من developers.tiktok.com: التعليقات والتحليلات وتجديد رموز الوصول.كيفية متابعة حالة نشر منشور TikTok عبر واجهة برمجة التطبيقات (API)متابعة منشور TikTok المرسل عبر واجهة برمجة التطبيقات (API): share_id، والحالات PROCESSING_DOWNLOAD وPUBLISH_COMPLETE وFAILED، ومعرّفات المنشور وأسباب الفشل.واجهة TikTok Analytics API: مؤشرات الحساب ومقاييس الفيديومقاييس TikTok التي تعيدها واجهة API الخاصة بالأعمال: المتابعون والمشاهدات والإعجابات يوميًا للحساب، والمشاهدات والإعجابات والتعليقات والمشاركات لكل فيديو.خطأ TikTok 40001: لا توجد صلاحية لتنفيذ العمليةيعني الخطأ 40001 في TikTok أن الاستدعاء لا يملك صلاحية العملية. كيف تتحقق من صلاحية تطبيقك في TikTok Accounts ونطاقات الرمز.

اربط قناتك الأولى في دقيقتين.

لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.

  • 3 أيام مجانًا
  • إلغاء في أي وقت
  • واجهات API الرسمية فقط
  • مراقبة على مدار الساعة 24/7

تم التحقق في