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

רישום דף Facebook לוובהוקים: נקודת הקצה subscribed_apps

דף Facebook נרשם לוובהוקים של אפליקציה באמצעות POST /{page-id}/subscribed_apps. בקריאה מעבירים את subscribed_fields, למשל feed,messages, ואת אסימון הגישה (Access Token) לדף, שמגיע מאדם בעל המשימה CREATE_CONTENT, MANAGE או MODERATE, עם הרשאות pages_manage_metadata ו-pages_show_list. Meta שולחת אירועים של שדה רק כשגם האפליקציה נרשמת לשדה. GET מציג את המנוי, ו-DELETE מסיר אותו.

easyCoexistence רושמת כל דף שמחברים ל-feed, messages ו-mention דרך subscribed_apps, מבטלת את הרישום בעת ההסרה, ומעבירה את אירועי הדף לנקודת הקצה HTTPS שלכם, חתומים בסוד ייעודי לאותו דף, דרך שרת MCP אחד או דרך Partner API.

Both levels

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

CREATE_CONTENT, MANAGE or MODERATE

משימות הדף, ואחת מהן נדרשת לאדם שמאחורי האסימון כדי לקרוא מנוי או ליצור אותו.

messaging_success

מוחזר לצד success כשאפליקציה מסירה מדף את מנוי הוובהוק שלה באמצעות DELETE.

App access token

הדרישות של /{app-id}/subscriptions לקריאה, יצירה ומחיקה של המנוי ברמת האפליקציה.

1 hour

כשלי מסירה ב-Messenger שאחריהם Meta מבטלת את הרישום של האפליקציה מהדף, עד שתירשם שוב.

מה עושה נקודת הקצה subscribed_apps?

היא מתקינה את האפליקציה על הדף וקובעת אילו משדות הוובהוק של הדף האפליקציה מקבלת. Meta שולחת התראות רק כשהאפליקציה מותקנת בדף ולא כיבה את פלטפורמת האפליקציות בהגדרותיו, ורק לשדות שנרשמו בשתי הרמות: של הדף, דרך נקודת הקצה הזו, ושל האפליקציה, שמוגדרת ב-App Dashboard או דרך /{app-id}/subscriptions. דף יכול להירשם ליותר שדות מאשר האפליקציה.

איך רושמים דף?

עם POST לנקודת הקצה, כשהשדה subscribed_fields מפרט את השדות מופרדים בפסיקים, ועם אסימון הגישה לדף. קריאה מוצלחת מחזירה success true, וקריאה שמפרטת messages דורשת גם את ההרשאה pages_messaging באסימון:

Subscribing a Page to three fields
POST https://graph.facebook.com/{page-id}/subscribed_apps
  ?subscribed_fields=feed,messages,mention
  &access_token=<PAGE_ACCESS_TOKEN>

{ "success": true }

איזה אסימון, משימות והרשאות נדרשים?

אסימון גישה לדף, שקושר את הקריאה לדף אחד, מאדם שיכול לפעול בשם הדף. ההנחיות והמדריכים של Meta קובעים את הדרישות:

  • לכל שדה: אדם בעל המשימה CREATE_CONTENT, MANAGE או MODERATE, וההרשאות pages_manage_metadata ו-pages_show_list.
  • messages ושאר שדות Messenger: בנוסף pages_messaging, באסימון של אדם שיכול לבצע את המשימה MESSAGING.
  • leadgen: המשימה ADVERTISE, עם leads_retrieval, pages_read_engagement ו-ads_management.
  • קריאת המנוי עם GET דורשת את אותן משימות והרשאות כמו יצירתו.

איזו רמת גישה נדרשת לשדות?

נדרשת Advanced Access, עבור דפים ואנשים שאינם בתפקידים של האפליקציה עצמה. עם Standard Access, התראות Messenger מגיעות רק מאנשים בעלי תפקיד באפליקציה, כמו מנהליה, מפתחיה ובודקיה. Advanced Access, שניתן לכל הרשאה דרך App Review ודורש Business Verification, פותח אותן ללקוחות האפליקציה. המדריך של Meta ל-Messenger מונה גם את פרסום האפליקציה בין התנאים המוקדמים.

מה זה מנוי ברמת האפליקציה?

זה החלק השני: השדות שהאפליקציה עצמה מאזינה להם, עם כתובת callback_url שלה. מגדירים אותו ב-App Dashboard, או באמצעות POST אל /{app-id}/subscriptions ואסימון גישה לאפליקציה, ומעבירים: object=page, callback_url, fields, include_values, verify_token. הפעולה הזו מפעילה את בקשת האימות של Meta. GET על אותה נקודת קצה מציג לכל אובייקט את callback_url, את fields ואם המנוי פעיל. POST חדש מעדכן את השדות בלי לדרוס את האחרים, ו-DELETE מסיר את כולם או את השדות שצוינו.

איך בודקים למה דף רשום?

עם GET על אותה נקודת קצה ואסימון הגישה של הדף. המערך data מפרט כל אפליקציה שהדף התקין, עם שמה, המזהה שלה ושדות subscribed_fields, ומוחזר ריק כשאין לדף אפליקציות מותקנות:

Reading a Page's subscriptions
GET https://graph.facebook.com/{page-id}/subscribed_apps
  ?access_token=<PAGE_ACCESS_TOKEN>

{
  "data": [
    {
      "category": "Business",
      "link": "https://example.com/app",
      "name": "<APP_NAME>",
      "id": "<APP_ID>",
      "subscribed_fields": ["feed", "messages", "mention"]
    }
  ]
}

איך מסירים מנוי?

עם DELETE /{page-id}/subscribed_apps, שמנתק את האפליקציה מהדף. אפליקציה יכולה להסיר מנוי משלה עם אסימון גישה לאפליקציה, והתגובה מכילה: success, messaging_success. Meta מסירה את המנוי גם בעצמה: אחרי שעה של כשלי מסירה ב-Messenger, האפליקציה מבוטלת מהדף וצריכה להירשם שוב כשנקודת הקצה שלה תעבוד.

מה easyCoexistence עושה בעת החיבור?

היא רושמת כל דף שהאדם בוחר, מיד אחרי ששמרה את אסימון הדף: POST /{page-id}/subscribed_apps עם subscribed_fields שמוגדר לערכים feed,messages,mention. אם Meta מסרבת, הדף נשאר מחובר, וlist_social_accounts מציג את הסיבה בשדה last_error. הסרת הדף שולחת DELETE /{page-id}/subscribed_apps לפני שהאסימון נמחק, ואף כלי אינו מגיע לנתיבי subscribed_apps או לנתיבי token, כך שהמנוי מנוהל על ידי easyCoexistence בלבד.

טעויות נפוצות

  • קריאה לנקודת הקצה עם אסימון גישה של משתמש. היא דורשת את אסימון הגישה לדף שנרשם.
  • רישום הדף בלי רישום האפליקציה. שדה מגיע ל-callback רק אם גם המנוי של האפליקציה כולל אותו.
  • השמטת pages_messaging בעת רישום messages. Meta דורשת אותו, באסימון של אדם שיכול לבצע את המשימה MESSAGING.
  • שכחה לרשום מחדש אחרי תקלה. שעה של כשלי מסירה ב-Messenger מבטלת את האפליקציה, והאירועים נעצרים עד ששולחים את ה-POST שוב.
עושים את זה עם EasyCoexistence

US$ 9 עד US$ 0.75 לחיבור לחודש, יורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.

שאלות נפוצות

האם צריך לרשום כל דף בנפרד?

כן. subscribed_apps פועל לכל דף עם אסימון הגישה של אותו דף, ואילו המנוי ברמת האפליקציה לאובייקט page חל על הדפים שהתקינו את האפליקציה.

למה subscribed_apps מחזיר שגיאה 200?

Meta מסמנת 200 כשגיאת הרשאות לנקודה הזו. בדקו שלאסימון יש pages_manage_metadata ו-pages_show_list, ושהוא מגיע מאדם בעל CREATE_CONTENT, MANAGE או MODERATE.

אפשר לרשום דף מ-Graph API Explorer?

כן. המדריך של Meta בוחר את האפליקציה, מקבל אסימון משתמש עם pages_manage_metadata, ממיר אותו לאסימון הדף ושולח את ה-POST אל {page-id}/subscribed_apps.

אפשר להוסיף שדות וובהוק לדף שמחובר ל-easyCoexistence?

לא דרך הכלים שלה: אף אחד מהם אינו מגיע לנתיבי subscribed_apps, והדף נשאר רשום ל-feed, messages ו-mention, השדות ש-easyCoexistence מעבירה.

המשיכו לקרוא

שדות וובהוק (Webhook) של עמוד Facebook: הרשימה המלאה64 שדות וובהוק לעמוד Facebook שאותם מתעדת Meta: feed, mention, שדות Messenger ושדות פרופיל, וההרשאה שכל אחד דורש.אימות וובהוק (Webhook) של Facebook: hub.challenge ו-X-Hub-Signature-256אימות וובהוק של Facebook: מחזירים את hub.challenge כאשר hub.verify_token תואם, ואז בודקים את X-Hub-Signature-256 בכל אירוע עם סוד האפליקציה.הרשאות דף Facebook API ודרישות App Reviewתשע הרשאות של דף Facebook, מה כל אחת פותחת, ומה Meta דורשת ב-App Review לגישה מתקדמת: אימות עסק וסרטון הקלטה.אסימון גישה לעמוד Facebook: כמה זמן הוא תקף ומה מבטל אותוהסבר איך מקבלים אסימון גישה לעמוד Facebook ללא תאריך תפוגה, מי יכול לקבל אותו, ומה גורם ל-Meta להפסיק לקבל אותו.וובהוק (Webhook) של feed בעמוד Facebook: אירועים של תגובות, פוסטים וריאקציותמה שוובהוק של feed בעמוד Facebook שולח על תגובות, פוסטים וריאקציות: שדות item ו-verb, מבנה ה-payload של Meta ואיך עמוד נרשם.פרוטוקול ההעברה ב-Messenger: שיתוף תיבת הדואר של הדף בין סוכן AI לאנשיםאיך השיחות של דף Facebook עוברות בין אפליקציות לתיבת הדואר של הדף: ניתוב שיחות, pass_thread_control ובעלי השיחה.

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

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

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

נבדק ב-