أحداث webhook لتعليقات TikTok
ترسل TikTok API for Business حدث comment.update عبر خطاف الويب (webhook) خلال خمس دقائق من إنشاء تعليق أو رد على حساب، أو حذفه، أو إخفائه، أو تحويله إلى الأصدقاء فقط أو جعله عامًا، وذلك في منشورات الصور ومقاطع الفيديو العامة للحساب. يحدد كل حدث التعليق والمنشور والإجراء ومعرّف صاحب التعليق والنص، ويكون موقّعًا برأس Tiktok-Signature.
يمرّر easyCoexistence كل حدث تعليق من TikTok للحساب إلى نقطة النهاية HTTPS الخاصة بك فور وصوله، موقّعًا بسر خاص بذلك الحساب ودون الاحتفاظ بأي نسخة.
المدة التي يُطلق فيها comment.update بعد إنشاء تعليق أو رد أو حذفه أو تغيير ظهوره.
المدة التي يعيد فيها TikTok محاولة التسليم التي لم يرد عليها رد الاستدعاء برمز HTTP 200، مع تراجع أسّي بين المحاولات.
النطاق الذي يجب أن يمنحه الحساب، ويبقيه صالحًا، لإرسال أحداث comment.update الخاصة به.
وعد التسليم من 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 مسبقًا وتحويل معرّفاته إلى نصوص حتى لا يُقرَّب أي منها.
{
"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 النهائي.
فعّله باستخدام 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 لصاحب التعليق.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في