Messenger מבית Facebook

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

הערה: כשמשתמשים בשילוב עם צד שלישי, בקשות ונתונים של משתמשי קצה נשלחים גם אל Google וגם אל הצד השלישי. התנאים וההגבלות, הסכם רמת השירות (SLA), התמחור והמכסות של מהדורת הסוכן שלכם חלים על הטיפול של Google בבקשות האלה. התנאים וההגבלות, ה-SLA, התמחור והמכסות של הצד השלישי חלים על הטיפול של הצד השלישי בבקשות האלה.

מגבלות

השילוב הזה תומך רק בשפת ברירת המחדל של הסוכן.

איך זה עובד

השילוב פועל באופן הבא:

1. יוצרים אפליקציית פייסבוק שמשתמשת בפלטפורמת Facebook Messenger.
2. מגדירים את השילוב עם Dialogflow ואת אפליקציית פייסבוק כך שהם יוכלו לתקשר ביניהם.
3. השילוב של Dialogflow שולח הודעות למשתמש הקצה באמצעות Facebook Messenger API.
4. השילוב עם Dialogflow מקבל הודעות ממשתמש הקצה באמצעות Facebook Messenger webhook.

הגדרה

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

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

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

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

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

   1. עוברים אל מסוף Dialogflow ES.
   2. בתפריט הצד, לוחצים על שילובים.
   3. לוחצים על Facebook Messenger.
   4. נפתחת תיבת דו-שיח של הגדרות:
      • הצגת כתובת URL ישנה של callback: אם המתג הזה מוצג, ברירת המחדל שלו היא 'מושבת'. זוהי אפשרות זמנית שנועדה להתאים לשינוי שבוצע לאחרונה ב-Facebook Messenger API. אל תשנו את המתג הזה אלא אם קיבלתם הוראה לעשות זאת מצוות התמיכה של Dialogflow. האפשרות הזו מוסרת אחרי שכל הסוכנים עודכנו.
      • כתובת URL להתקשרות חזרה: מעתיקים את הערך הזה. ההגדרה הזו משמשת להגדרת ה-webhook של Facebook Messenger.
      • אימות אסימון: אפשר להזין כל אסימון פרטי שצריך. מעתיקים את הערך הזה. ההגדרה הזו משמשת להגדרת ה-webhook של Facebook Messenger.
      • אסימון גישה לדף: מזינים את אסימון הגישה שהעתקתם כשנוצר דף הפייסבוק.
      • התחלה: לוחצים כדי להפעיל את שירות השילוב הזה עבור הסוכן.

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

   • מגדירים את ה-webhook של פייסבוק לאפליקציה. משתמשים בערכים של כתובת ה-URL של הקריאה החוזרת (callback) ואסימון האימות שהעתקתם קודם. חשוב להפעיל את האפשרויות 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 בהתאמה אישית.

הפורמט הכללי של מטען ייעודי (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"
        }
      }
    }
  }