וובהוק (Webhook) של feed בעמוד Facebook: אירועים של תגובות, פוסטים וריאקציות
שדה feed בוובהוק של עמודי Facebook מדווח על כמעט כל שינוי בפיד של עמוד, ברגע שהוא קורה. לכל שינוי יש item, כמו post, comment או reaction, ו-verb, כמו add, edit או remove, וכן מזהים רלוונטיים, השדה from שמציין את המחבר והשדה message שמכיל את הטקסט. Meta שולחת אותו כ-JSON, חתום עם X-Hub-Signature-256.
easyCoexistence רושם כל עמוד שאתם מחברים לשדה feed ומעביר את השינויים שלו לנקודת הקצה שלכם ב-HTTPS ברגע שהם מגיעים, חתומים במפתח הסודי של אותו עמוד.
הודעות feed על לייקים לעמוד נשלחות רק לעמודים עם פחות לייקים מזה.
השדה feed לא שולח דבר על פוסטים ממומנים עצמם, אבל שולח תגובות עליהם.
ההרשאה שמנהל עמוד עם הרשאות MODERATE חייב להעניק כדי שוובהוקי עמוד יגיעו לאפליקציה.
רוב העדכונים Meta מאגדת למשלוח וובהוק אחד, אף שאינה מתחייבת לכך.
כמה זמן Meta ממשיכה לנסות שוב משלוח שנכשל לנקודת הקצה של האפליקציה, בתדירות יורדת.
מה השדה feed מדווח?
כמעט כל שינוי בפיד של עמוד, בלשונו של Meta, כגון פוסטים, תגובות, ריאקציות ושיתופים; מה שינוי נושא תלוי בסוגו. Meta לא שולחת דבר על פוסטים ממומנים עצמם, אם כי תגובות עליהם מגיעות, ושולחת הודעות על לייקים לעמוד רק כל עוד בעמוד יש פחות מ-10,000 לייקים.
מה משמעותם של item ו-verb?
שני שדות בערך של כל שינוי מציינים מה קרה:
- item: מה השתנה, מתוך רשימתה של Meta, שכוללת post, status, photo, video, link, share, comment, reaction ו-album.
- verb: מה נעשה בו: add, edit, edited, delete, remove, hide, unhide, block, unblock, follow, mute או update.
- תגובה חדשה מגיעה עם item comment ו-verb add, וזה מה שכללי comment-to-DM מחפשים.
- ריאקציה נושאת item reaction ו-
reaction_typeשמציין אותה.
איך נראה שינוי בפיד?
בקשת POST שגוף ה-JSON שלה הוא object שערכו page, עם רשומה לכל עמוד שמכילה את המזהה של העמוד, זמן ומערך של changes. זו הדוגמה של Meta עצמה, אדם שמפרסם לעמוד:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1520544816,
"changes": [
{
"field": "feed",
"value": {
"from": { "id": "<USER_ID>", "name": "<NAME>" },
"item": "post",
"post_id": "<PAGE_POST_ID>",
"verb": "add",
"created_time": 1520544814,
"is_hidden": false,
"message": "<POST_TEXT>"
}
}
]
}
]
}אילו שדות יכולים להופיע בשינוי?
Meta מפרטת את השדות האלה מתוך הערך של שינוי בפיד, שמופיעים לפי סוג השינוי:
post_id,comment_idו-parent_id: הפוסט, התגובה ומה שהיא שייכת אליו.- from: המזהה והשם של מי שביצע את השינוי.
- message: הטקסט, עם link, photo, photos או video לתוכן מצורף.
created_time, ו-edited_timeלעריכות.reaction_typeלריאקציות, ו-is_hiddenשמציין אם פוסט מוסתר.- post: פרטים כגון
status_type,is_published,updated_timeו-permalink_url.
איך עמוד נרשם?
האפליקציה שולחת POST אל /{page-id}/subscribed_apps עם subscribed_fields=feed ואסימון העמוד, ממי שיכול לבצע את המשימה CREATE_CONTENT, MANAGE או MODERATE, עם pages_manage_metadata ו-pages_show_list שניתנו. Meta שולחת הודעות רק כשהעמוד מותקן עליו האפליקציה ולא כיבה את פלטפורמת האפליקציות בהגדרות שלו. easyCoexistence רושם כל עמוד שמחברים לשדות: feed, messages ו-mention כשמחברים אותו.
איך אירועי הפיד מגיעים לנקודת הקצה שלכם?
Meta מעבירה אותם לאפליקציה של easyCoexistence, שבודקת את X-Hub-Signature-256, עונה ל-Meta מיד ומעבירה כל רשומה של עמוד מחובר אל כתובת ה-URL של נקודת הקצה שהגדרתם לו, ב-HTTPS. ההעברה נושאת כותרת X-EC-Signature, שהיא HMAC-SHA256 של חותמת זמן וגוף הבקשה הגולמי, שנחתם במפתח הסודי של אותו עמוד, ויוצאת פעם אחת, בלי לשמור עותק ובלי ניסיונות חוזרים. אפשר להגדיר את נקודת הקצה עם set_social_webhook_destination או עם PUT /channels/:id/webhook ב-Partner API.
אילו שינויים בפיד מפעילים כללי תגובות ואוטומציות?
רק תגובות חדשות: שינוי עם item comment ו-verb add בפוסט של העמוד. כללי comment-to-DM בודקים את message לפי מילות המפתח שלהם ומדלגים על תגובות שהעמוד כתב בעצמו, והאוטומציות לוקחות את התגובות שאף כלל לא ענה להן. עריכות, הסתרות, ריאקציות ופוסטים עוברים ישירות לנקודת הקצה שלכם, אם הגדרתם אחת.
טעויות נפוצות
- לראות בכל שינוי בפיד תגובה חדשה. בדקו את item ו-verb: ריאקציות, עריכות, הסתרות והסרות מגיעות באותו שדה feed.
- להשיב לתגובות של העמוד עצמו. גם התשובות שלו מגיעות כשינויים בפיד, לכן דלגו על אלה שבהם from.id הוא מזהה העמוד.
- להניח שיש שינוי אחד לכל משלוח. Meta יכולה לאגד עד 1,000 עדכונים, לכן עברו על כל entry ועל כל change בתוכו.
- לקרוא את entry.time כזמן קרות השינוי. Meta מגדירה אותו לזמן שבו נשלחה ההתראה; created_time בערך הוא הזמן שבו נוצר האובייקט.
כללי comment-to-DM ואוטומציות פועלים על תגובות חדשות. US$ 9 עד US$ 0.75 לחיבור לחודש, וזה יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם הוובהוק של feed כולל תגובות?
כן. תגובה חדשה מגיעה כשינוי בפיד עם item comment ו-verb add, ונושאת את comment_id, post_id, from ו-message.
האם מגיעים וובהוקים על לייקים בעמוד?
רק לעמודים עם פחות מ-10,000 לייקים, לפי מדריך הוובהוקים לעמודים של Meta.
האם פוסטים ממומנים נכללים בוובהוק של feed?
לא הפוסטים הממומנים עצמם, אבל תגובות עליהם נשלחות.
האם צריך אפליקציית Meta משלכם כדי לקבל אירועי feed של עמוד?
לא. Meta שולחת אותם לאפליקציה של easyCoexistence, שמעבירה כל אחד מהם לנקודת הקצה שהגדרתם לאותו עמוד.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-