Messenger מבית Meta

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

איך זה עובד

כך השילוב פועל:

הגדרה

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

כדי להגדיר את השילוב:

  1. פועלים לפי השלבים ליצירת אפליקציה במטא: פיתוח אפליקציות במטא.
  2. מגדירים את אפליקציית Meta כדי להשתמש בפלטפורמת Meta Messenger. כדי לבצע את הפעולות הבאות, פועלים לפי השלבים שמפורטים במסמכי התיעוד של Meta Webhooks for Messenger Platform:
    • מוסיפים את Messenger Platform לאפליקציה של מטא.
    • מגדירים את האפליקציה כמנוי לדף Meta. צריך לוודא שההרשאות messages ו-messaging_postbacks מופעלות במינוי לדף.
    • מעתיקים את אסימון הגישה שמופיע בשלב הזה. האסימון הזה משמש להגדרת השילוב ממסוף Dialogflow CX.
    • אל תגדירו עדיין את ה-webhook ואל תבדקו את השילוב.
  3. מגדירים את השילוב במסוף Dialogflow CX:
    1. נכנסים למסוף Dialogflow CX.
    2. בתפריט הניווט, לוחצים על הכרטיסייה ניהול.
    3. לוחצים על Integrations (שילובים).
    4. לוחצים על הכפתור קישור במשבצת Meta Messenger.
    5. ממלאים את השדות בתיבת הדו-שיח של ההגדרות:
      • סוד האפליקציה: מזינים את סוד האפליקציה מההגדרות הבסיסיות של מרכז הבקרה של האפליקציה.
      • אימות טוקן: מזינים את הטוקן הפרטי שצריך. מעתיקים את הערך הזה. הוא משמש להגדרת ה-Webhook של Meta Messenger.
      • טוקן גישה לדף: מזינים את טוקן הגישה שהעתקתם במהלך הגדרת האפליקציה של Meta.
      • Enable get started button: מסמנים את התיבה הזו כדי להפעיל את הלחצן "שנתחיל?".
      • כתובת ה-URL של ה-webhook: מעתיקים את הערך הזה. הוא משמש להגדרת ה-Webhook של Meta Messenger.
      • ‫Start: מסמנים את התיבה הזו כדי להפעיל את שירות השילוב של הנציג.
  4. מסיימים את ההגדרה של האפליקציה של מטא ובודקים אותה. כדי לבצע את הפעולות הבאות, פועלים לפי השלבים שמפורטים במסמכי התיעוד של Meta Webhooks for Messenger Platform:
    • מגדירים את ה-webhook של Meta לאפליקציה. משתמשים בערכים של Webhook URL ו-Verify token שהעתקתם קודם. חשוב להפעיל את messages ואת messaging_postbacks במינוי לדף.
    • בודקים את האפליקציה.

אירועים

האירועים הבאים מופעלים על ידי השילוב הזה. אתם יכולים ליצור גורמים מטפלים באירועים בהתאמה אישית כדי להגדיר מה לעשות כשהאירועים מופעלים.

אירוע תיאור
FACEBOOK_WELCOME מופעל כשמשתמש קצה לוחץ על הכפתור "תחילת העבודה" ב-Meta Messenger.
FACEBOOK_MEDIA מופעל כשההודעה ממשתמש הקצה מכילה קבצים מצורפים (לדוגמה, אודיו, תמונה או וידאו).

כפתור להוספת משתמשים

מגדירים את הלחצן "קדימה, מתחילים" ב-Meta Messenger:

  1. כשמפעילים את שירות השילוב הזה, צריך להעביר את המתג Enable Get Started Button (הפעלת הלחצן "שנתחיל?") למצב מופעל.

    • שירות השילוב הזה מאפשר להפעיל את הכפתור באמצעות קריאה ל-Messenger Profile API.

      curl -X POST \
-H "Content-Type: application/json" \
-d '{"get_started": {"payload": "FACEBOOK_WELCOME"}}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

  2. יוצרים גורם מטפל באירועים בהתאמה אישית לאירוע FACEBOOK_WELCOME.

כדי לבדוק את זה:

  1. אם יש שיחה קודמת עם הדף שלכם ב-Meta, מחקו אותה.
    • הכפתור שנתחיל? מופיע רק בשיחות חדשות.
  2. מתחילים שיחה חדשה עם הדף שלכם במטא.
  3. לוחצים על הכפתור Get Started ובודקים את התשובה מהגורם המטפל באירועים בהתאמה אישית.

אתם יכולים לשלוח קריאה ל-Messenger Profile API כדי לנהל את הלחצן Get Started (שנתחיל?). זה יכול לעזור בבדיקות.

כדי לבדוק את הסטטוס של הלחצן Get Started, משתמשים בבקשה הבאה:

curl -X GET \
"https://graph.facebook.com/v10.0/me/messenger_profile?fields=get_started&access_token=${PAGE_ACCESS_TOKEN}"

כדי להשבית את הלחצן Get Started, אפשר להשתמש בבקשה הבאה:

curl -X DELETE \
-H "Content-Type: application/json" \
-d '{"fields": ["get_started"]}' \
"https://graph.facebook.com/v10.0/me/messenger_profile?access_token=${PAGE_ACCESS_TOKEN}"

הודעות עם תשובות עשירות

הודעות עם תשובות עשירות נתמכות באמצעות מטען ייעודי (payload) מותאם אישית במילוי בקשות. למידע נוסף, עיינו בפורמט ההודעה במסמכי התיעוד של Send API Parameters Message Object.

לדוגמה, המטען הייעודי (payload) הבא בהתאמה אישית מספק הודעת טקסט:

{
  "text": "Hello, world"
}

המטען הייעודי המותאם אישית הבא מספק הודעת תמונה:

{
  "attachment": {
    "type": "image",
    "payload": {
      "url": "https://example.com/test.jpg"
    }
  }
}

תשובות ספציפיות לערוץ

אחרי שמגדירים את התשובות הספציפיות לערוץ, הנציג משתמש באופן אוטומטי בערוץ DF_CX_FB_MESSENGER כדי להשיב להודעות ב-Meta Messenger.