וובהוק (Webhook) של אזכור בעמוד Facebook: מתי מישהו מזכיר את העמוד שלכם
שדה mention בוובהוקים של Page ב-Facebook מודיע לאפליקציה כשמישהו מזכיר את ה-Page בפוסט או בתגובה. Meta שולחת רשומה ב-changes שבה field מוגדר ל-mention, וה-value שלה יכול לכלול את post_id, את comment_id לתגובה, את הטקסט ב-message, קישורים ומדיה מצורפים, וגם item ו-verb, ב-POST חתום ב-X-Hub-Signature-256.
easyCoexistence רושמת כל Page שמחברים ל-mention, לצד feed ו-messages, ומעבירה את אירועי האזכור שלו לנקודת הקצה ב-HTTPS שלכם כשהם מגיעים, חתומים במפתח נפרד לאותו Page ובלי לשמור עותק, כך שהסוכן שלכם יידע על כל אזכור ברגע שהוא קורה.
שדה וובהוק של Page לאזכורים חדשים, כולל אזכורים בתגובות ובפוסטים.
הרשאה שמנהל Page עם הרשאות MODERATE חייב להעניק לפני שוובהוקים של Page מגיעים לכתובת ה-URL של ה-callback באפליקציה.
איך אנשים מזכירים Page בפוסט או בתגובה: מקלידים @ ואת שם ה-Page, ואז בוחרים אותו.
כמה זמן Meta מנסה שוב התראה שנכשלה על Page, בתדירות יורדת, לפני שהיא מוותרת עליה.
שדה שנוסף על ידי ה-edge /{page-id}/tagged לכל פוסט ציבורי שבו ה-Page תויג.
מה מפעיל את וובהוק האזכור?
מישהו שמזכיר את ה-Page בפוסט או בתגובה. ב-Facebook, אזכור נעשה על ידי הקלדת @ ושם ה-Page ובחירה בו מההצעות. מסמך ההפניה של Meta מתאר את השדה כאזכורים חדשים של Page, כולל אזכורים בתגובות ובפוסטים. מרכז העזרה של Facebook מציין שהגדרות ה-Page יכולות למנוע מאנשים להזכיר אותו.
איך נראית התראה על אזכור?
POST עם object שערכו page ורשומה אחת עבור ה-Page שאוזכר: המזהה שלו, זמן, ומערך changes שבו field הוא mention. מסמך ההפניה של Meta מפרט את שדות ה-value ללא דוגמה, ולכן אזכור בפוסט מעוצב לפי הרשימה הזו:
{
"object": "page",
"entry": [
{
"id": "<PAGE_ID>",
"time": 1793520000,
"changes": [
{
"field": "mention",
"value": {
"item": "post",
"verb": "add",
"post_id": "<POST_ID>",
"message": "<TEXT_WITH_THE_MENTION>"
}
}
]
}
]
}מה כל שדה של אזכור אומר?
אלו שדות ה-value במסמך ההפניה של Meta; אילו מהם מגיעים בהתראה תלוי בפוסט או בתגובה:
post_id: מזהה הפוסט שהזכיר את ה-Page.comment_id: מזהה התגובה, כשהאזכור הוא בתגובה;parent_id: מזהה התגובה ההורה שלה.- message: הטקסט שנושא את האזכור.
- השדות link, photo, photos ו-video: קישורים למה שהפוסט או התגובה מצרפים.
- item ו-verb: סוג האובייקט ומה קרה לו, מאותן רשימות שבהן משתמש השדה feed.
created_time: מתי נוצרו הפוסט או התגובה.- from ו-
message_tags: הכותב והפרופילים שתויגו בטקסט, שניהם מסומנים כ-Workplace only. - מופיעים גם: action,
album_id,event_id,photo_id,video_id,share_id, published,reaction_type,recipient_idו-open_graph_story_id.
איזו הרשאה נדרשת לשדה mention?
pages_manage_metadata, שמנהל Page עם הרשאות MODERATE חייב להעניק לפני שוובהוקים של Page מגיעים לאפליקציה. ה-Page נרשם דרך POST /{page-id}/subscribed_apps עם mention בין subscribed_fields, באמצעות אסימון Page של מי שיש לו משימה CREATE_CONTENT, MANAGE או MODERATE, עם pages_manage_metadata ו-pages_show_list. גם האפליקציה נרשמת ל-mention, כי נשלחים רק שדות שנרשמו בשתי הרמות, וכש-Pages מנוהלים על ידי אנשים בלי תפקיד באפליקציה, הם צריכים את ההרשאות האלה ב-Advanced Access.
איך קוראים את הפוסט או התגובה שמזכירים את ה-Page?
לפי המזהה שלו, עם אסימון ה-Page, כשמטא מתירה זאת. אסימון Page קורא פוסטים שפורסמו אל ה-Page או על ידיו; פוסטים משותפים לציבור של Pages אחרים דורשים pages_manage_posts ותכונת Page Public Content Access, על אסימון של מנהל Page; ו-Meta קושרת קריאת פוסט של אדם להרשאת user_posts של אותו אדם.
GET https://graph.facebook.com/<POST_ID>
?fields=message,permalink_url,created_time
&access_token=<PAGE_ACCESS_TOKEN>
GET https://graph.facebook.com/<COMMENT_ID>
?fields=message,from,created_time
&access_token=<PAGE_ACCESS_TOKEN>איפה עוד Page יכול למצוא את האזכורים שלו?
ב-edge של tagged. GET /{page-id}/tagged מציג את הפוסטים הציבוריים שבהם ה-Page תויג, כל אחד עם tagged_time, וזה כולל גם פוסטים מלפני שהוגדר הוובהוק. הוא דורש אסימון Page של מי שיש לו משימה CREATE_CONTENT, MANAGE או MODERATE, עם pages_read_user_content ו-pages_show_list, ו-Meta אומרת שייתכן שתידרש תכונת Page Public Content Access. בפוסט של אדם, Meta מחזירה את השדה from רק לאדם שכתב אותו.
איך easyCoexistence מעבירה אירועי אזכור?
היא נרשמת ל-mention לכל Page בזמן החיבור, לצד feed ו-messages. האפליקציה שלה בודקת X-Hub-Signature-256 בכל משלוח, עונה ל-Meta מיד ושולחת כל רשומה של ה-Page, ללא שינוי, אל נקודת הקצה ב-HTTPS שאתם מגדירים עם set_social_webhook_destination או PUT /channels/:id/webhook ב-Partner API:
- X-EC-Signature מכיל t=<unix>,v1=<hex>: ה-HMAC-SHA256 של חותמת הזמן, נקודה והגוף הגולמי, שמפתחו הוא סוד החתימה של ה-Page.
- הסוד מתחיל ב-whsec_ ומוצג פעם אחת; הגדרת הכתובת שוב מנפיקה סוד חדש, וכתובת null עוצרת את ההעברה.
- כל רשומה נשלחת פעם אחת, עם המתנה של עד 8 שניות, לכתובת HTTPS שנפתרת לכתובת IP ציבורית, בלי לעקוב אחרי הפניות ובלי לשמור עותק.
POST <YOUR_ENDPOINT>
Content-Type: application/json
X-EC-Signature: t=1793520001,v1=<HEX_HMAC_SHA256>
{
"platform": "facebook",
"account_id": "<ACCOUNT_ID>",
"external_id": "<PAGE_ID>",
"entry": {
"id": "<PAGE_ID>",
"time": 1793520000,
"changes": [
{
"field": "mention",
"value": {
"item": "post",
"verb": "add",
"post_id": "<POST_ID>",
"message": "<TEXT_WITH_THE_MENTION>"
}
}
]
}
}טעויות נפוצות
- לקרוא את entry.time כרגע האזכור. Meta קובעת אותו לזמן שבו נשלחה ההתראה, ו-created_time ב-value מציין את תאריך היצירה של הפוסט או התגובה.
- לראות בחיפוש שנכשל אירוע שבור. Meta מזהירה שחלק מהערכים post_id ו-comment_id בהתראות אזכור אי אפשר לבצע עליהם שאילתה, בגלל חוסר הרשאה או פרטיות, ולכן שמרו את טקסט message מתוך האירוע עצמו.
- לשלוף את הפוסט לפני שמחזירים תשובה להעברה. העברות לא נשלחות שוב, ולכן החזירו 2xx מיד ושלפו את הפוסט אחר כך.
החל מ-US$ 9 לחיבור בחודש, שיורד עד US$ 0.75 ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם וובהוק האזכור אומר מי הזכיר את ה-Page?
לא בשביל Page: מסמך ההפניה של Meta מסמן את השדה from כ-Workplace only. חיפוש הפוסט או התגובה לפי המזהה שלהם יכול להחזיר את הכותב, במידה שההרשאות של Meta מאפשרות זאת.
האם אפשר לקבל אזכורים מלפני שה-Page נרשם?
לא מהוובהוק, כי Meta לא שומרת היסטוריית התראות שאפשר לשאול אותה. ה-edge של tagged מציג את הפוסטים הציבוריים שבהם ה-Page תויג.
מה ההבדל בין השדה mention לבין השדה feed?
feed מדווח על שינויים בפיד של ה-Page עצמו, כמו פוסטים, תגובות וריאקשנים שם; mention מדווח על כך שה-Page אוזכר בפוסט או בתגובה. כל שדה נרשם בנפרד.
האם כללי התגובות של easyCoexistence פועלים על אזכורים?
לא. כללים ואוטומציות פועלים על תגובות מהשדה feed ועל הודעות Messenger; שינויי mention מועברים לנקודת הקצה שלכם בדיוק כפי ש-Meta שלחה אותם.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-