Messenger מבית Meta

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

איך זה עובד

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

  • אתם יוצרים אפליקציית Meta שמשתמשת ב-Meta Messenger Platform.
  • מגדירים את השילוב של Dialogflow CX ואת האפליקציה של Meta כדי שהם יוכלו לתקשר ביניהם.
  • השילוב עם Dialogflow CX שולח הודעות למשתמש הקצה באמצעות Meta Messenger API.
  • השילוב של Dialogflow CX מקבל הודעות מהמשתמשים הסופיים באמצעות Meta Webhooks for Messenger Platform.

הגדרה

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

  1. פועלים לפי השלבים ליצירת אפליקציית Meta: פיתוח אפליקציות ל-Meta.

  2. מגדירים את אפליקציית Meta לשימוש בפלטפורמת Meta Messenger. כדי לבצע את הפעולות הבאות, פועלים לפי השלבים שמפורטים בתיעוד בנושא Meta Webhooks for Messenger Platform:

    • מוסיפים את Messenger Platform לאפליקציית Meta.
    • מירשמים עם האפליקציה לדף ב-Meta. מוודאים שהאפשרויות messages ו-messaging_postbacks מופעלות במינוי לדף.
    • בשלב הזה מקבלים אסימון גישה. מעתיקים את הערך הזה. האסימון הזה משמש להגדרת השילוב ממסוף Dialogflow CX.
    • אל תגדירו את ה-webhook או תבדקו את השילוב עדיין.

  3. מגדירים את השילוב במסוף Dialogflow CX:

    1. עוברים אל מסוף Dialogflow CX.
    2. לוחצים על הכרטיסייה ניהול בחלונית הימנית.
    3. בתפריט הצד הימני, לוחצים על שילובים.
    4. לוחצים על הלחצן Connect (חיבור) בכרטיס Meta Messenger.

    5. נפתחת תיבת דו-שיח של הגדרות:

      • סוד האפליקציה: מזינים את סוד האפליקציה מתוך ההגדרות הבסיסיות של לוח הבקרה של האפליקציה.

      • אימות טוקן: אפשר להזין כל טוקן פרטי שרוצים. מעתיקים את הערך הזה. ההגדרה הזו משמשת להגדרת ה-Webhook של Meta Messenger.

      • Page access token: מזינים את טוקן הגישה שהעתקתם במהלך הגדרת אפליקציית Meta שמוסברת למעלה.

      • הפעלת הלחצן 'קדימה, מתחילים': אפשר לעיין בקטע הלחצן 'קדימה, מתחילים'.

      • Webhook URL: מעתיקים את הערך הזה. ההגדרה הזו משמשת להגדרת ה-Webhook של Meta Messenger.

      • התחלה: לוחצים כדי להפעיל את שירות השילוב הזה עבור הסוכן.

  4. משלימים את ההגדרה של אפליקציית Meta ובודקים אותה. כדי לבצע את הפעולות הבאות, פועלים לפי השלבים שמפורטים בתיעוד בנושא Meta Webhooks for Messenger Platform:

    • מגדירים את ה-webhook של Meta באפליקציה. משתמשים בערכים של Webhook URL ושל Verify token שהעתקתם למעלה. חשוב לוודא שהפעלתם את messages ואת messaging_postbacks במינוי לדף.
    • בודקים את האפליקציה.

אירועים

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

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

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

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

  1. כשמפעילים את שירות השילוב הזה, מחליפים את המצב של הפעלת הכפתור 'תחילת העבודה'.

    • שירות השילוב הזה מפעיל את הלחצן באמצעות קריאה ל-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. מתחילים שיחה חדשה עם הדף שלכם ב-Meta.

  3. לוחצים על הלחצן Get Started (מתחילים) ומאמתים את התגובה מ-גורם מטפל באירועים מותאם אישית.

תמיד אפשר להשתמש ב-Messenger Profile API כדי לנהל את הלחצן Get Started. האפשרות הזו יכולה להיות שימושית לצורכי בדיקה.

לדוגמה, הבקשה הבאה בודקת את הסטטוס של הלחצן תחילת העבודה:

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

הבקשה הבאה משביתה את הלחצן תחילת העבודה:

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}"

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

הודעות התשובה העשירות נתמכות באמצעות Custom Payload בFulfillment. מידע על פורמט ההודעה זמין במאמר בנושא שליחת אובייקט הודעה עם פרמטרים של API.

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

{
  "text": "Hello, world"
}

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

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

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

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