וובהוק (Webhook) של live_comments ב-Instagram: תגובות בזמן שידור חי
live_comments של Instagram מודיע לאפליקציה על תגובות לשידור חי של חשבון מקצועי, בזמן שהשידור באוויר. כל תגובה מגיעה כשינוי שהשדה שלו הוא live_comments, עם אותו מבנה ערך כמו השדה comments: מזהה התגובה והטקסט שלה, ה-Instagram-scoped ID ושם המשתמש של המחבר בשדה from, ומזהה המדיה. ההודעות נפסקות כשהשידור מסתיים.
easyCoexistence רושם כל חשבון Instagram מחובר לתגובות, להודעות ולאזכורים, ומעביר תגובות על הפוסטים וה-Reels שלו אל נקודת הקצה ה-HTTPS שלכם כשהן מגיעות, חתומות במפתח הסודי של אותו חשבון.
נדרש להתראות live_comments, כמו בשדה comments; מדיה של חשבון פרטי אינה שולחת התראות כלל.
מספר ההודעות הפרטיות בשנייה שאפליקציה יכולה לשלוח לכל חשבון, לתגובות בשידור חי ב-Instagram.
מתי התראות התגובות למדיה חיה נפסקות.
מתי אפשר לשלוח הודעה פרטית לתגובה בשידור חי; אחרי סיום השידור כבר אי אפשר.
מתי Meta הוסיפה את live_comments, לתגובות על סרטונים חיים בזמן השידור.
מתי live_comments מופעל?
כשמישהו מגיב לסרטון הלייב של החשבון המקצועי בזמן השידור, לאחר שהאפליקציה והחשבון רשומים לשדה. זה נפרד מהשדה comments: תגובה על פוסט, Reel, סטורי או מודעה מגיעה לשדה comments, ותגובה במהלך לייב מגיעה לשדה live_comments. התראות למדיה חיה נפסקות כשהשידור מסתיים, ומדיה של חשבון פרטי לא מפעילה כלל.
איך נראית התראת live_comments?
המעטפה של תגובה: object עם הערך instagram, רשומה אחת לכל חשבון, ומערך changes שהשדה שלו מכיל live_comments. הדוגמה של Meta ל-Instagram Login מציגה מבנה ערך אחד עבור comments ו-live_comments, ולכן שם השדה הוא מה שמבדיל ביניהם:
{
"object": "instagram",
"entry": [
{
"id": "<IG_ID>",
"time": 1793448000,
"changes": [
{
"field": "live_comments",
"value": {
"id": "<COMMENT_ID>",
"text": "<COMMENT_TEXT>",
"from": {
"id": "<INSTAGRAM_SCOPED_ID>",
"username": "<USERNAME>"
},
"media": {
"id": "<LIVE_MEDIA_ID>",
"media_product_type": "<MEDIA_PRODUCT_TYPE>"
}
}
}
]
}
]
}מה כל שדה אומר?
השדות שמדריך ההתראות של Meta מציין עבור live_comments, מבחוץ פנימה:
- entry[].id: החשבון המקצועי. entry[].time: מתי Meta שלחה את ההתראה, לא מתי נכתבה התגובה.
- changes[].field:
live_comments. בודקים אותו לפני קריאת value, כי המבנה זהה לזה של comments. - value.id: מזהה התגובה, זה שאליו מופנית הודעה פרטית.
- value.text: הטקסט של התגובה.
- השדות value.from.id ו-value.from.username: ה-Instagram-scoped ID ושם המשתמש של המחבר; from.
self_ig_scoped_idמופיע כשהחשבון מגיב לעצמו. - value.media.id ו-value.media.
media_product_type: הסרטון החי והמשטח שבו הוא מופיע. - value.
parent_id: מופיע בהפניה לתגובה שמשיבה לתגובה אחרת.
במה live_comments שונה מהשדה comments?
המטען זהה, אבל הכללים לא. ההפניות של Meta לתגובות מתייחסות לתגובות על וידאו חי ככלל נפרד, ומגבלות הקצב וכללי ההודעות הפרטיות שלה נותנות להן מספרים אחרים. זה בצד בצד, כשהשדה comments משמאל:
| comments | live_comments | |
|---|---|---|
| Fires for | Comments on posts, Reels, Stories and ads | Comments on a Live while it broadcasts |
| Notifications | As each comment is made | Stop when the broadcast ends |
| Public reply | POST /<COMMENT_ID>/replies | Not supported on live video |
| Hide or delete | Supported | Not supported on live video |
| Private reply | Within 7 days of the comment | Only during the broadcast |
| Private reply rate | 750 per hour per account | 100 per second per account |
איך משיבים לתגובה לייב?
בהודעה פרטית, במהלך השידור. POST /<IG_ID>/messages עם recipient.comment_id שמוגדר למזהה התגובה שולח למחבר הודעה ישירה אחת, שנוחתת בתיבת הדואר שלו אם הוא עוקב אחרי החשבון, ובבקשות הודעה אם לא. ההפניות של Meta שוללות את הנתיבים הציבוריים על וידאו חי: מענה לתגובות, יצירה, הסתרה ומחיקה שם אינם נתמכים. אחרי סיום השידור אי אפשר לשלוח הודעות פרטיות לתגובות שלו.
POST https://graph.instagram.com/<IG_ID>/messages
Authorization: Bearer <INSTAGRAM_USER_ACCESS_TOKEN>
Content-Type: application/json
{
"recipient": { "comment_id": "<COMMENT_ID>" },
"message": { "text": "<REPLY_TEXT>" }
}אפשר לקרוא תגובות של לייב בלי וובהוק?
רק בזמן שהלייב פעיל. ההפניה של Meta לתגובות אומרת שאפשר לקרוא תגובות על וידאו חי רק כשהמדיה משודרת, וההפניה למדיה אומרת זאת גם על הווידאו החי עצמו. הקשר live_media, שמציג את הלייב הנוכחי של החשבון, מתועד ל-Facebook Login ב-graph.facebook.com. Meta לא שומרת היסטוריית התראות שאפשר לשאול אותה, לכן שמרו מכל אירוע את מה שצריך ברגע שהוא מגיע.
מה live_comments דורש?
עם Instagram Login: instagram_business_basic ו-instagram_business_manage_comments, אותו זוג כמו עבור comments, בתוספת Advanced Access, ש-Meta דורשת להתראות comments ו-live_comments. מוצר Instagram חדש ב-App Dashboard מתחיל רשום לשדה live_comments, וכל חשבון נרשם דרך POST /<IG_ID>/subscribed_apps. החשבון שבבעלותו השידור חייב להיות ציבורי.
האם easyCoexistence מעביר תגובות לייב?
לא. האפליקציה של easyCoexistence וכל חשבון מחובר רשומים לתגובות, להודעות ולאזכורים, ולא לשדה live_comments, ולכן תגובות שנכתבות במהלך לייב אינן מועברות. תגובות על פוסטים ועל Reels כן מועברות, וגם reply_to_comment, hide_comment, כללי הודעה פרטית לתגובה ואוטומציות יכולים לפעול עליהן.
טעויות נפוצות
- לחכות לתגובות לייב בשדה comments. הן מגיעות בשדה live_comments, והשדה הזה חייב להיבחר לאפליקציה.
- להשיב בפומבי לתגובה לייב. Meta לא תומכת במענה, בהסתרה או במחיקה של תגובות על וידאו חי; הדרך היא הודעה פרטית במהלך השידור.
- לתזמן הודעות פרטיות לאחרי הלייב. אחרי סיום השידור אי אפשר לשלוח אותן, ולכן יש להשיב בזמן שהשידור באוויר.
- להתייחס לשדה live_comments כאל היסטוריה. ההתראות נפסקות כשהשידור מסתיים ו-Meta לא שומרת כלום לשאילתות, ולכן שמרו מה שצריך כשכל אחת מגיעה.
reply_to_comment משיב בפומבי או בהודעה פרטית, וכללי הודעה פרטית לתגובה פועלים מסביב לשעון. US$ 9 עד US$ 0.75 לחיבור בחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם וובהוק התגובות של Instagram כולל תגובות לייב?
לא. תגובות שנכתבות במהלך שידור חי מגיעות לשדה live_comments הנפרד, עם אותו מבנה ערך.
מתי Meta הוסיפה את וובהוק live_comments?
ב-9 בנובמבר 2021, לתגובות על סרטונים חיים בזמן שהם משודרים.
למה וובהוק live_comments שלי הפסיק לעבוד?
כנראה השידור הסתיים, וזה עוצר התראות תגובה למדיה חיה. אם הוא מעולם לא התחיל, בדקו את Advanced Access, את הרישום של החשבון ושהחשבון ציבורי.
כמה מהר אפליקציה יכולה לשלוח הודעות פרטיות לתגובות לייב של Instagram?
עד 100 בשנייה לכל חשבון, קצב ההודעות הפרטיות של Meta לתגובות בלייב, לעומת 750 בשעה לתגובות על פוסטים וב-Reels. כל אחת חייבת לצאת לפני שהשידור מסתיים.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-