שדות וובהוק (Webhook) של עמוד Facebook: הרשימה המלאה
במדריך Meta לוובהוקים של עמוד מתועדים 64 שדות מנוי: feed לפוסטים, לתגובות ולתגובות רגשיות; mention לאזכורים של העמוד; שדות Messenger כמו messages, message_echoes, messaging_postbacks וגם message_reads; ושדות פרופיל כמו name, picture, hours וגם website. כל אחד מהם דורש את pages_manage_metadata, ואפליקציה מקבלת שדה רק כשהוא רשום גם ברמת האפליקציה וגם על ידי העמוד דרך subscribed_apps.
easyCoexistence נרשמת לאירועים של כל עמוד שמחברים לשדות feed, messages וגם mention, ומעבירה את האירועים האלה לנקודת הקצה HTTPS שלכם כשהם מגיעים, חתומים בכותרת X-EC-Signature.
שדות המנוי המתועדים במדריך Meta לוובהוקים של עמוד, החל מ-feed, דרך mention, ועד שדות Messenger ושדות פרופיל.
ההרשאה שמנהל עמוד בעל הרשאות MODERATE חייב להעניק לפני שהוובהוקים של העמוד יגיעו לאפליקציה.
שדה Messenger נפרד להודעות שהעמוד שולח, זמין רק לשיחות Messenger.
משימת עמוד הנדרשת להירשם ל-leadgen, עם leads_retrieval, ads_management, pages_read_engagement וגם pages_manage_metadata.
רק שדות שנרשמו גם בעמוד וגם באפליקציה מייצרים וובהוקים.
איך מאורגנים שדות הוובהוק של עמוד?
Meta מתעדת אותם בדף עזר אחד לאובייקט page, והם מתחלקים לשלוש משפחות: פעילות על העמוד ומסביבו, שיחות Messenger, ועריכות של הפרטים של העמוד עצמו. שינויים בשדות feed, mention ובשדות הפרופיל מגיעים בשדה entry.changes, כשכל אחד מציין את השדה שלו, או כ-changed_fields כשהאפליקציה כיבתה את האפשרות Include Values. אירועי Messenger מגיעים בשדה entry.messaging, או בשדה entry.standby באפליקציה שאינה הבעלים של השיחה.
אילו שדות מדווחים על פעילות בעמוד?
שנים עשר שדות מכסים תוכן ופעילות ולא שיחות. למשל, תגובה חדשה מגיעה בשדה feed כשהערך של item הוא comment והערך של verb הוא add, לצד תגובות רגשיות, שיתופים והפוסטים של העמוד עצמו. מה כל אחד מהם מעביר, לפי המדריך של Meta:
אילו שדות נושאים אירועי Messenger?
לשדות Messenger יש את הרשימה הארוכה ביותר, ומדריך הוובהוקים של Messenger ב-Meta מתאר מה כל שדה שולח. שלושה עשר השדות האלה מכסים את שיחות העמוד. השדה standby, שנושא הודעות לאפליקציה שאינה הבעלים של השיחה, מתועד במדריך הזה ולא במדריך העמוד:
אילו שדות Messenger נוספים קיימים?
עוד עשרה שדות משרתים מוצרים מסוימים, מטלפוניה ועד סחר ודיווח על תקינות:
send_cart: הודעה הנושאת מידע על עגלה או הזמנה;message_context: זיהויים שמבצעים מודלים של Meta על הודעה, עם שם אירוע וציון.- calls,
call_settings_update,call_permission_reply: שיחות קוליות ב-Messenger, שינויים בהגדרות השיחה של העמוד, ותשובה של אדם לבקשת הרשאה להתקשר. messaging_customer_information: מה שאדם הזין במסך מידע לקוח;messaging_in_thread_lead_form_submit: טופס ליד שנשלח בתוך השיחה.message_template_status_update: סטטוס הבדיקה של תבנית הודעת utility השתנה.business_integrity,messaging_integrity: עדכוני תקינות, עם הפרות, הגבלות ואירועי פעולה בשדהbusiness_integrity.
אילו שדות מדווחים על שינויים בפרופיל העמוד?
עשרים ותשעה שדות מדווחים על עריכות בפרטים של העמוד עצמו, שדה אחד לכל פרט, וכל אחד מגיע כשינוי שמציין את הפרט:
- זהות: השדות name, picture, category, שמחזיק עד שלוש קטגוריות, וכן description, שהוא Story Description.
- פרטים עסקיים:
company_overview, mission, founded, products,general_info,general_manager, members, awards וגם affiliation. - קשר ומקום: email, phone, website, location, hours,
current_location, hometown, parking וגםpublic_transit. - מקום:
price_range,payment_options, attire וגםculinary_team. - אישי: birthday,
personal_infoוגםpersonal_interests.
איזו הרשאה נדרשת לכל שדה?
pages_manage_metadata לכל אחד מהם, שמעניק מנהל עמוד בעל הרשאות MODERATE, ובחלקם הרשאות נוספות. העמוד נרשם דרך subscribed_apps. מדריכי Meta קובעים את האסימון וההרשאות לכל סוג שדה, ולקבלת אירועים על אנשים מחוץ לתפקידי האפליקציה, ההרשאות דורשות גם Advanced Access:
| Permissions | Task of the person behind the token | |
|---|---|---|
| Any field | pages_manage_metadata and pages_show_list | CREATE_CONTENT, MANAGE or MODERATE |
| messages and other Messenger fields | pages_messaging as well | MESSAGING |
| leadgen | leads_retrieval, pages_read_engagement and ads_management as well | ADVERTISE |
לאילו שדות easyCoexistence נרשמת?
שלושה: feed, messages וגם mention. כשעמוד מתחבר, easyCoexistence שולחת POST /{page-id}/subscribed_apps עם השדות האלה ועם אסימון העמוד, ואז מעבירה כל entry של העמוד אל נקודת הקצה שהגדרתם, חתום בכותרת X-EC-Signature. כללי תגובות ואוטומציות פועלים על תגובות חדשות מ-feed ועל הודעות, והאזכורים מועברים כמו שהם. שום שדה אחר לא נרשם, ולכן לא מועברים echoes, postbacks, receipts, handovers, standby או שינויי פרופיל.
טעויות נפוצות
- הרשמת העמוד לשדה שהאפליקציה לא נרשמה אליו. Meta מעבירה רק שדות שנרשמו גם בעמוד וגם ברמת האפליקציה.
- לקרוא אירועי Messenger מתוך entry.changes. הם מגיעים בשדה entry.messaging, עם אובייקט messaging אחד לכל entry, ולא בשדה entry.changes.
- לצפות לקבל את תשובות העמוד עצמו בהודעות. הודעות שהעמוד שולח מגיעות בשדה message_echoes, שהוא שדה נפרד.
- לסמוך על feed לקבלת לייקים בעמוד גדול. Meta שולחת התראות על לייקים רק לעמודים עם פחות מ-10,000 לייקים.
כללי תגובות ואוטומציות פועלים על תגובות ועל הודעות חדשות. US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם תקופת ניסיון של 3 ימים.
שאלות נפוצות
האם שדה feed כולל תגובות על מודעות?
כן. Meta לא שולחת דבר על פוסטים של מודעות עצמם, אבל התגובות עליהם מגיעות בשדה feed.
מה משנה ההגדרה Include Values?
כשהאפשרות דלוקה, שינוי כולל את הערכים החדשים בתוך changes. כשהיא כבויה, Meta שולחת רק את שמות השדות ששונו, בתוך changed_fields.
איך רואים לאילו שדות עמוד רשום?
GET /{page-id}/subscribed_apps עם האסימון של העמוד מציג את האפליקציות שהעמוד התקין, ולכל אחת את subscribed_fields שלה.
האם easyCoexistence מעבירה שינויי פרופיל של עמוד?
לא. עמודים שמחוברים ל-easyCoexistence רשומים רק לשדות feed, messages וגם mention, ולכן השם, התמונה ושאר שדות הפרופיל לא מועברים.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-