Messenger מבית Facebook

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

מגבלות

השילוב הזה תומך רק בשפת ברירת המחדל של נציג התמיכה.

איך זה עובד

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

  • יוצרים אפליקציית פייסבוק שמשתמשת בפלטפורמת Facebook Messenger.
  • מגדירים את השילוב עם Dialogflow ואת אפליקציית Facebook כדי שהם יוכלו לתקשר ביניהם.
  • השילוב עם Dialogflow שולח הודעות למשתמש הקצה באמצעות Facebook Messenger API.
  • השילוב של Dialogflow מקבל הודעות מהמשתמשים הסופיים באמצעות Facebook Messenger Webhook.

הגדרה

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

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

  2. מגדירים את אפליקציית פייסבוק לשימוש בפלטפורמת Facebook Messenger. פועלים לפי השלבים במאמר בנושא הגדרת אפליקציית פייסבוק כדי לבצע את הפעולות הבאות:

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

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

    1. עוברים אל מסוף Dialogflow ES.
    2. בתפריט הצד הימני, לוחצים על שילובים.
    3. לוחצים על Facebook Messenger.

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

      • הצגת כתובת URL ישנה לקריאה חוזרת (callback): אם המתג הזה מוצג, ברירת המחדל שלו היא 'מושבת'. זו אפשרות זמנית שנועדה להתאים לשינוי שבוצע לאחרונה ב-API של Facebook Messenger. אל תשנו את המתג הזה אלא אם קיבלתם הוראה לעשות זאת מצוות התמיכה של Dialogflow. אחרי שכל הסוכנים יעודכנו, האפשרות הזו תוסר.
      • כתובת URL להתקשרות חזרה: מעתיקים את הערך הזה. ההגדרה הזו משמשת להגדרת ה-Webhook של Facebook Messenger.
      • Verify Token: אפשר להזין כל אסימון פרטי שרוצים. מעתיקים את הערך הזה. ההגדרה הזו משמשת להגדרת ה-Webhook של Facebook Messenger.
      • ‫Page Access Token: מזינים את אסימון הגישה שהעתקתם כשיצרתם את דף הפייסבוק.
      • התחלה: לוחצים כדי להפעיל את שירות השילוב הזה עבור הסוכן.

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

    • מגדירים את ה-webhook של פייסבוק באפליקציה. משתמשים בערכים של Callback URL ושל Verify Token שהעתקתם למעלה. חשוב להפעיל את האפשרויות messages ו-messaging_postbacks.
    • בודקים את האפליקציה.

אירועים

האירועים הבאים מופעלים על ידי השילוב הזה:

אירוע תיאור
FACEBOOK_WELCOME מופעל כשמשתמש קצה מתחיל שיחה עם הצ'אטבוט.

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

השילוב הזה מתרגם חלק מההודעות של תגובות עשירות להודעות של סוגי הודעות בפלטפורמת Facebook Messenger.

תשובות עם תמונות

תשובות עם תמונות נשלחות אל Facebook Messenger בתור הודעות עם קבצים מצורפים ב-Facebook Messenger. הערך של message.attachment.type מוגדר כ-image. הפורמטים הנתמכים הם:

  • jpg
  • png
  • ‫GIF סטטי
  • קובץ GIF מונפש

תשובות בכרטיס

תשובות בכרטיסים נשלחות אל Facebook Messenger בתור תבניות כלליות של Facebook Messenger.

תשובות מהירות

תשובות מהירות נשלחות אל Facebook Messenger בתור תשובות מהירות ב-Facebook Messenger.

תשובות של מטען ייעודי (payload) בהתאמה אישית

כדי לשלוח סוגים אחרים של הודעות ב-Facebook Messenger, אפשר להשתמש בpayload בהתאמה אישית.

הפורמט הכללי של המטען הייעודי המותאם אישית נראה כך:

{
  "facebook": {
    message
  }
}

במקום message, מציינים את האובייקט message של Facebook Messenger. פרטים על האובייקט message זמינים בהפניית API של Facebook Messenger.

לדוגמה:

  • כדי לשלוח קישור לאודיו: 
    {
  "facebook": {
    "attachment": {
      "type": "audio",
      "payload": {
        "url": "https://example.com/audio/test.mp3"
      }
    }
  }
}
  • שליחת סרטון שאפשר להפעיל: 
    {
  "facebook": {
    "attachment": {
      "type": "video",
      "payload": {
        "url": "https://example.com/video.mp4"
      }
    }
  }
}
  • שליחת קובץ: 
    {
  "facebook": {
    "attachment": {
      "type": "file",
      "payload": {
        "url": "https://example.com/file.pdf"
      }
    }
  }
}