ממשק API לפרופיל Messenger: ברכה, כפתור Get Started, ice breakers ותפריט קבוע
פרופיל Messenger של דף Facebook מוגדר דרך /{page-id}/messenger_profile, עם אסימון גישה (Access Token) של הדף וההרשאה pages_messaging. POST כותב מאפיינים כמו get_started, greeting, ice_breakers, persistent_menu ו-commands, GET קורא אותם עם fields, ו-DELETE מסיר את אלה שמופיעים במערך fields. Meta מתירה 10 קריאות בכל 10 דקות לכל דף, ונדרסים רק המאפיינים שנשלחו.
easyCoexistence עונה לשיחות ב-Messenger של דף עם send_social_dm בתוך חלון של 24 שעות, מ-Claude, מ-ChatGPT או מהקוד שלכם, כשהודעות חדשות מועברות לנקודת הקצה שלכם ברגע שהן מגיעות.
מספר הקריאות ל-Messenger Profile API המותרות לכל דף בכל פרק זמן של 10 דקות.
המספר המרבי של ice breakers שה-API מגדיר; כששניהם מוגדרים, ice breakers של ה-API קודמים לכפתור Get Started.
המספר המרבי של פריטים ברמה העליונה בתפריט קבוע; הכותרת של כל פריט מוגבלת ל-30 תווים.
כמה זמן יכול לקחת עדכון של תפריט קבוע ברמת הדף; תפריט שנקבע לאדם אחד מתעדכן בזמן אמת.
טקסט הברכה (greeting), ש-Meta מציינת במדריך שלה שכבר אינו עובד ב-Messenger ב-Android וב-iOS.
מה כולל פרופיל Messenger?
ההגדרות שמהן מתחילה חוויית Messenger של דף. ה-Messenger Profile API של Meta מונה את המאפיינים האלה, וכל אחד מהם נקבע ונקרא באותה נקודת הקצה; באפליקציה במצב Development Mode, ההגדרות גלויות רק לאנשים שיש להם תפקיד באפליקציה:
איך קוראים, קובעים ומוחקים מאפיינים?
בשלוש שיטות על אותה נקודת הקצה, שנקראת עם האסימון של הדף. POST מקבל גוף JSON של מאפיינים וכותב רק את אלה ששם; GET מקבל fields כרשימה מופרדת בפסיקים, ו-DELETE מקבל גוף JSON שבמערך fields שלו מצוין מה להסיר; POST ו-DELETE מחזירים result success. קביעת כפתור Get Started ותפריט בקריאה אחת:
POST /{page-id}/messenger_profile
{
"get_started": { "payload": "GET_STARTED" },
"persistent_menu": [
{
"locale": "default",
"composer_input_disabled": false,
"call_to_actions": [
{ "type": "postback", "title": "Talk to an agent", "payload": "AGENT" },
{ "type": "web_url", "title": "Shop now", "url": "https://example.com/shop" }
]
}
]
}
{ "result": "success" }איך פועל כפתור Get Started?
הכפתור נמצא במסך הפתיחה, שמציג את שם הדף, תמונת הפרופיל ותמונת השער, ואת משך התגובה הטיפוסי של העסק. לחיצה שולחת את Get Started לשיחה, שולחת את get_started.payload לאפליקציה כאירוע messaging_postbacks ופותחת את חלון ההודעות הרגיל. Meta מציינת שהכפתור אינו נתמך כש-Messenger פועל בדפדפן המובנה של אפליקציית Facebook, ותפריט קבוע דורש שהוא יוגדר קודם.
האם טקסט הברכה עדיין עובד?
לא בטלפונים. ההפניה של Meta נקראת כעת [Deprecated] Greeting Text: התכונה כבר לא עובדת ב-Messenger ב-Android וב-iOS, וייתכן ש-API עדיין יקבל את המאפיין greeting, אבל הלקוחות לא יראו אותו, ולכן Meta מבקשת מהמפתחים להימנע ממנו. לפי התיעוד, greeting מחזיק טקסט אחד לכל שפה, עם default חובה, עד 160 תווים, ומותאם אישית עם {{user_first_name}}, {{user_last_name}} או {{user_full_name}}, וקביעתו דורשת את תפקיד Administrator בדף.
איך פועלים ice breakers?
הם מציגים עד 4 שאלות שאדם יכול ללחוץ עליהן כדי לפתוח שיחה; השאלה נשלחת לשרשור כאילו האדם שאל אותה, וה-payload שלה חוזר כאירוע postback. מאז אפריל 2022 הם מותאמים לשפות: כל אובייקט במערך ice_breakers מכיל call_to_actions ו-locale, locale עם default נדרש, וקריאת DELETE לשדה ice_breakers מסירה את כולם. Meta מדרגת את האלמנטים שמתחרים על שיחה חדשה:
- ice breakers של ה-API גוברים על כפתור Get Started כששניהם מוגדרים.
- שניהם קודמים לשאלות מותאמות שנקבעות בתיבת הדואר הנכנס של הדף, ועריכתן מושבתת כל עוד מוגדרים ice breakers של ה-API.
איך בנוי התפריט הקבוע?
כמערך תפריטים, אחד לכל שפה עם default חובה, שכל אחד מהם מכיל עד 20 call_to_actions מסוג web_url או postback. כותרת מוגבלת ל-30 תווים, payload של postback עד 1,000 תווים, וכשהשדה composer_input_disabled מקבל את הערך true, התפריט, הכפתורים וה-webviews הם הדרך היחידה לאינטראקציה. הדרישות של Meta לפני שהוא מופיע:
- כפתור Get Started כבר מוגדר, והרשאת
pages_messagingקיימת. - דף מפורסם, והאפליקציה מוגדרת כציבורית.
- תפקיד Administrator בדף למי שמגדיר אותו.
- Messenger v106 ומעלה ב-iOS או ב-Android, מחוץ לדפדפן המובנה של אפליקציית Facebook.
- שינויים ברמת הדף יכולים לקחת עד 24 שעות; תפריט לאדם אחד, שנקבע דרך
custom_user_settingsעם PSID, מתעדכן בזמן אמת.
מה הן פקודות?
מילות מפתח שאדם יכול להפעיל בכל רגע, מתפריט פקודות ליד שדה ההקלדה, על ידי הקלדת לוכסן או סימן @, או מחלון קופץ כשהוא מקליד מילה תואמת. לכל שפה 1 עד 100 פקודות, עם שם של 1 עד 32 תווים בלי לוכסן מוביל ותיאור של 1 עד 64 תווים; כשפקודות מוגדרות, הן גוברות על התפריט הקבוע. פקודות שהופעלו מגיעות לאפליקציה בתוך האירוע messages, בשדה message.commands.
מה עושים whitelisted_domains וגם account_linking_url?
שניהם משרתים חוויות מחוץ לשיחה עצמה. whitelisted_domains מציין עד 50 דומיינים שחלון ה-webview של Messenger רשאי לפתוח עבור Messenger Extensions SDK ותוסף ה-checkbox, שכל אחד מהם מוגש ב-HTTPS תחת שם מלא, ולעולם לא כתובת IP או localhost, וקביעתו דורשת את תפקיד Administrator בדף. account_linking_url היא כתובת callback ב-HTTPS שמקשרת את חשבון Messenger של אדם לחשבון שלו עם העסק.
איך easyCoexistence מגדירה את פרופיל Messenger של דף?
זה לא אפשרי: אף כלי אינו קורא ל-{page-id}/messenger_profile, ואסימוני דף אינם נמסרים, ולכן הגדרת הפרופיל היא מחוץ לחיבור הזה. פקודות שאנשים מפעילים מגיעות לאירוע messages ש-easyCoexistence מעבירה והאוטומציות קוראות; הקשות ש-Meta מדווחת עליהן כאירועי messaging_postbacks, מ-Get Started, מפריטי תפריט postback ומ-ice breakers, לא מועברות, מכיוון שהדפים רשומים לאירועים feed, messages וגם mention.
טעויות נפוצות
- הגדרת תפריט קבוע לפני Get Started. Meta דורשת כפתור Get Started, לכן קובעים קודם את get_started.
- השמטת שפת ברירת המחדל. כל אחד מ-ice breakers, תפריטים ופקודות צריך אובייקט עם locale שערכו default, כגיבוי.
- קריאה לפרופיל ה-API בלולאה. Meta מתירה 10 קריאות בכל 10 דקות לכל דף, לכן שולחים כמה מאפיינים בקריאת POST אחת.
- ציפייה לשינוי מיידי בתפריט. עדכון של תפריט ברמת הדף יכול לקחת עד 24 שעות עד שיגיע לאנשים.
הגדרת פרופיל Messenger אינה בין הכלים שלו. US$ 9 עד US$ 0.75 לחיבור בחודש, שיורד ככל שמוסיפים חיבורים, עם 3 הימים הראשונים בחינם.
שאלות נפוצות
האם תפריט קבוע יכול להיות שונה לכל אדם?
כן. custom_user_settings עם ה-PSID של האדם עוקף את תפריט הדף עבורו, מתעדכן בזמן אמת ומתיר 10 קריאות לאדם ב-10 דקות.
אילו שפות תומך פרופיל Messenger?
אלה שברשימת השפות הנתמכות של Meta, כמו en_GB, pt_BR או ja_JP, וכן default, ברירת המחדל שבה משתמשים כשאף שפה לא מתאימה לזו של האדם.
מי יכול לשנות את פרופיל Messenger של דף?
אפליקציה עם אסימון דף שנושא את pages_messaging. התפריט הקבוע, הברכה ורשימת הדומיינים דורשים גם את תפקיד Administrator בדף.
כמה עולה easyCoexistence לדף Facebook?
כל דף הוא חיבור אחד: US$ 9 עד US$ 0.75 לחיבור בחודש, כשהמחיר יורד ככל שמספר החיבורים גדל, והשלושה ימים הראשונים הם בחינם.
המשיכו לקרוא
מחברים את הערוץ הראשון שלכם תוך שתי דקות.
בלי לחכות לאישורים של הפלטפורמות. מחברים את WhatsApp, Instagram, TikTok או ערוץ אחר, מבקשים מה-AI לפרסם, להשיב או להפיק דוח, ורואים אותו עובד.
- 3 ימי ניסיון חינם
- ביטול בכל עת
- רק ממשקי API רשמיים
- ניטור 24/7
נבדק ב-