התחברותהתחילו תקופת ניסיון
easyCoexistence ממשקי API רשמיים

שדות וובהוק (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.

64

שדות המנוי המתועדים במדריך Meta לוובהוקים של עמוד, החל מ-feed, דרך mention, ועד שדות Messenger ושדות פרופיל.

pages_manage_metadata

ההרשאה שמנהל עמוד בעל הרשאות MODERATE חייב להעניק לפני שהוובהוקים של העמוד יגיעו לאפליקציה.

message_echoes

שדה Messenger נפרד להודעות שהעמוד שולח, זמין רק לשיחות Messenger.

ADVERTISE

משימת עמוד הנדרשת להירשם ל-leadgen, עם leads_retrieval, ads_management, pages_read_engagement וגם pages_manage_metadata.

Both levels

רק שדות שנרשמו גם בעמוד וגם באפליקציה מייצרים וובהוקים.

איך מאורגנים שדות הוובהוק של עמוד?

Meta מתעדת אותם בדף עזר אחד לאובייקט page, והם מתחלקים לשלוש משפחות: פעילות על העמוד ומסביבו, שיחות Messenger, ועריכות של הפרטים של העמוד עצמו. שינויים בשדות feed, mention ובשדות הפרופיל מגיעים בשדה entry.changes, כשכל אחד מציין את השדה שלו, או כ-changed_fields כשהאפליקציה כיבתה את האפשרות Include Values. אירועי Messenger מגיעים בשדה entry.messaging, או בשדה entry.standby באפליקציה שאינה הבעלים של השיחה.

אילו שדות מדווחים על פעילות בעמוד?

שנים עשר שדות מכסים תוכן ופעילות ולא שיחות. למשל, תגובה חדשה מגיעה בשדה feed כשהערך של item הוא comment והערך של verb הוא add, לצד תגובות רגשיות, שיתופים והפוסטים של העמוד עצמו. מה כל אחד מהם מעביר, לפי המדריך של Meta:

feedNearly all changes to the Page's feed: posts, comments, reactions, shares; likes only below 10,000 likes
mentionNew mentions of the Page in posts and comments; some IDs it returns cannot be queried
ratingsNew ratings, and comments or reactions on a rating
videosChanges to the encoding status of a video on the Page
live_videosChanges to a live video's status, with its ID
leadgenNew leads from the Page's lead ads, with leadgen_id, form_id and ad_id
group_feedComments on the Page's posts in the business's Facebook Group
product_reviewA product item's review status: pending, approved, rejected or outdated
inbox_labelsLabel changes on people in the Page inbox: the user, the action and the label
page_upcoming_changeUpcoming changes to the Page, with their type and effective time
page_change_proposalProposals to change the Page, created, accepted or rejected
invoice_access_invoice_draft_changeChanges to an invoice draft, such as its shipping address

אילו שדות נושאים אירועי Messenger?

לשדות Messenger יש את הרשימה הארוכה ביותר, ומדריך הוובהוקים של Messenger ב-Meta מתאר מה כל שדה שולח. שלושה עשר השדות האלה מכסים את שיחות העמוד. השדה standby, שנושא הודעות לאפליקציה שאינה הבעלים של השיחה, מתועד במדריך הזה ולא במדריך העמוד:

messagesA message from a person, through any entry point, with text or attachments
message_echoesA message the Page sent, with the app_id of the app that sent it
message_deliveriesA message from the Page was delivered
message_readsThe person read a message from the Page
message_reactionsThe person reacted to a message from the Page
message_editsThe person edited a message they had sent
messaging_postbacksA tap on a postback button, Get Started or a persistent menu item
messaging_referralsThe person came back to the conversation through an m.me link or an ad
messaging_optinsA Messenger plugin click, an accepted message request or a checkbox opt-in
messaging_handoversThread control passed, taken or requested between apps
messaging_policy_enforcementA policy warning, block or unblock on the Page's messaging
messaging_account_linkingThe person linked or unlinked their account with the business
response_feedbackFeedback buttons, such as thumbs up or down, on a message the Page sent

אילו שדות 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:

PermissionsTask of the person behind the token
Any fieldpages_manage_metadata and pages_show_listCREATE_CONTENT, MANAGE or MODERATE
messages and other Messenger fieldspages_messaging as wellMESSAGING
leadgenleads_retrieval, pages_read_engagement and ads_management as wellADVERTISE

לאילו שדות 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 לייקים.
עושים את זה עם EasyCoexistence

כללי תגובות ואוטומציות פועלים על תגובות ועל הודעות חדשות. 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, ולכן השם, התמונה ושאר שדות הפרופיל לא מועברים.

המשיכו לקרוא

אימות וובהוק (Webhook) של Facebook: hub.challenge ו-X-Hub-Signature-256אימות וובהוק של Facebook: מחזירים את hub.challenge כאשר hub.verify_token תואם, ואז בודקים את X-Hub-Signature-256 בכל אירוע עם סוד האפליקציה.רישום דף Facebook לוובהוקים: נקודת הקצה subscribed_appsאיך POST /{page-id}/subscribed_apps רושם דף Facebook לשדות וובהוק (Webhook): אסימונים, משימות, מנוי ברמת האפליקציה, בדיקה והסרה.וובהוק (Webhook) של feed בעמוד Facebook: אירועים של תגובות, פוסטים וריאקציותמה שוובהוק של feed בעמוד Facebook שולח על תגובות, פוסטים וריאקציות: שדות item ו-verb, מבנה ה-payload של Meta ואיך עמוד נרשם.וובהוק (Webhook) של Messenger לעמודי Facebook: הודעות ואזכוריםשדות הוובהוק של עמודי Facebook להודעות Messenger ולאזכורים: מבנה ה-payload, מזהי השולחים, קבצים מצורפים ודרך המסירה לנקודת הקצה.ממשק API לפרופיל Messenger: ברכה, כפתור Get Started, ice breakers ותפריט קבועהגדירו את פרופיל Messenger של דף Facebook דרך /{page-id}/messenger_profile: Get Started, ברכה, ice breakers, תפריט קבוע ופקודות.קריאת היסטוריית שיחות Messenger דרך ה-APIקריאת היסטוריית Messenger של עמוד Facebook עם Conversations API: /{page-id}/conversations, שדות הודעה, מגבלת 20 הודעות והרשאות.

מחברים את הערוץ הראשון שלכם תוך שתי דקות.

בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.

  • 3 ימי ניסיון חינם
  • ביטול בכל עת
  • רק ממשקי API רשמיים
  • ניטור 24/7

נבדק ב-