אירועי וובהוק של תגובות ב-TikTok
ה-API for Business של TikTok שולח וובהוק comment.update תוך חמש דקות מרגע שתגובה או תשובה נוצרת, נמחקת, מוסתרת, מוגדרת לחברים בלבד או הופכת לציבורית, בתמונות ובסרטוני וידאו ציבוריים של החשבון. כל אירוע חתום בכותרת Tiktok-Signature ומציין את התגובה, הפוסט, הפעולה, המזהה של המגיב והטקסט.
easyCoexistence מעביר לנקודת הקצה ה-HTTPS שלכם כל אירוע תגובה של TikTok לחשבון, ברגע שהוא מגיע, חתום בסוד ייעודי לחשבון ובלי עותק שנשמר.
הזמן שבו 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 גדולים מדי מכדי שמספר כפול יכיל אותם במדויק, לכן קראו אותם מהמחרוזת הגולמית.
איך אירועים מגיעים לנקודת הקצה שלכם?
TikTok שולח וובהוקים לאפליקציית המפתחים, דרך כתובת ה-URL אחת לקריאה חוזרת לכל האפליקציה. easyCoexistence מקבל אותם ומעביר כל comment.update של חשבון מחובר לנקודת הקצה ב-HTTPS שהגדרתם לו, פעם אחת, ברגע הגעתו, וחתום בסוד של אותו חשבון. להגדרת נקודת הקצה השתמשו ב-set_social_webhook_destination מ-Claude או מ-ChatGPT, או ב-Partner API דרך PUT /channels/:id/webhook; הסוד מוצג פעם אחת, וכתובת ה-URL שהיא null מכבה את ההעברה.
איך נראה אירוע שהועבר?
בקשת POST הכוללת את השדה platform, את השדה 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 גדולים ממה שמספר כפול מחזיק במדויק; easyCoexistence מעביר אותם כמחרוזות, ולכן צריך לשמור עליהם כך.
- חישוב החתימה על עותק מפוענח של הגוף. ה-HMAC מכסה את הגוף הגולמי כפי שנשלח, ושכתוב שלו מחדש שובר את ההתאמה.
- טיפול באירוע חוזר פעמיים. TikTok מעביר לפחות פעם אחת, לכן זהו לפי השדה comment_id והשדה comment_action לפני שפועלים.
- הפניית היעד לכתובת שמפנה לכתובת אחרת. ההעברה לא עוקבת אחרי הפניות, לכן ציינו את כתובת ה-HTTPS הסופית.
הפעילו אותו עם set_social_webhook_destination מ-Claude או מ-ChatGPT, או עם ה-Partner API. בין US$ 9 ל-US$ 0.75 לחיבור בחודש, ויורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
אילו אירועי וובהוק של TikTok מועברים?
comment.update, עבור תגובות ותשובות בפוסטים של החשבון המחובר: נוצרו, נמחקו, הוסתרו, הוגדרו לחברים בלבד או לציבוריים.
האם גם אירועי פרסום של TikTok מועברים?
לא. ההעברה כוללת רק אירועי תגובה; את הפרסום של פוסט מעקבים עם get_tiktok_publish_status במקום זה.
כמה מהר מגיע אירוע תגובה של TikTok?
TikTok שולח comment.update תוך חמש דקות מהשינוי, ו-easyCoexistence מעביר אותו ברגע שהוא נכנס.
האם אירוע תגובה של TikTok כולל את הטקסט?
TikTok מתעד שדה text בתוך השדה content של האירוע, לצד מזהי התגובה והפוסט, הפעולה והשדה unique_identifier של המגיב.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-