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

וובהוק (Webhook) של feed בעמוד Facebook: אירועים של תגובות, פוסטים וריאקציות

שדה feed בוובהוק של עמודי Facebook מדווח על כמעט כל שינוי בפיד של עמוד, ברגע שהוא קורה. לכל שינוי יש item, כמו post, comment או reaction, ו-verb, כמו add, edit או remove, וכן מזהים רלוונטיים, השדה from שמציין את המחבר והשדה message שמכיל את הטקסט. Meta שולחת אותו כ-JSON, חתום עם X-Hub-Signature-256.

easyCoexistence רושם כל עמוד שאתם מחברים לשדה feed ומעביר את השינויים שלו לנקודת הקצה שלכם ב-HTTPS ברגע שהם מגיעים, חתומים במפתח הסודי של אותו עמוד.

10K likes

הודעות feed על לייקים לעמוד נשלחות רק לעמודים עם פחות לייקים מזה.

Ad posts

השדה feed לא שולח דבר על פוסטים ממומנים עצמם, אבל שולח תגובות עליהם.

pages_manage_metadata

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

1,000

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

36 hours

כמה זמן 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 עצמה, אדם שמפרסם לעמוד:

A feed change, as Meta sends it
{
  "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 בערך הוא הזמן שבו נוצר האובייקט.
עושים את זה עם EasyCoexistence

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

המשיכו לקרוא

וובהוק (Webhook) של Messenger לעמודי Facebook: הודעות ואזכוריםשדות הוובהוק של עמודי Facebook להודעות Messenger ולאזכורים: מבנה ה-payload, מזהי השולחים, קבצים מצורפים ודרך המסירה לנקודת הקצה.ממשק API לניהול תגובות ב-Facebook Page: קריאה, מענה, הסתרה ומחיקהאיך ה-Page של Facebook קורא, משיב, מסתיר ומוחק תגובות בפוסטים שלו דרך Graph API, כולל המשימות, ההרשאות והפילטרים.ה-API לתשובות פרטיות ב-Facebook: הודעה למי שהגיב בעמודשליחת תשובה פרטית ב-Facebook עם ה-API של Meta: POST /{page-id}/messages עם מזהה התגובה, הודעה אחת תוך 7 ימים, והשגיאות.הרשאות דף Facebook API ודרישות App Reviewתשע הרשאות של דף Facebook, מה כל אחת פותחת, ומה Meta דורשת ב-App Review לגישה מתקדמת: אימות עסק וסרטון הקלטה.ה-API לפוסטים בעמוד Facebook: טקסט, קישורים, תמונות וסרטוניםאיך לפרסם פוסטים בעמוד Facebook דרך Graph API: טקסט וקישורים דרך /feed, תמונות מכתובת URL דרך /photos, סרטונים דרך /videos והכללים של Meta.וובהוק (Webhook) של אזכור בעמוד Facebook: מתי מישהו מזכיר את העמוד שלכםמה שולח וובהוק האזכור של Facebook כשפוסט או תגובה מזכירים את העמוד: ה-payload שדה אחר שדה, ההרשאה וקריאת הפוסט.

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

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

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

נבדק ב-