Workplace from Facebook

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

מגבלות

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

איך זה עובד

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

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

התחלה

כדי להתחיל את השילוב:

  1. אם אין לכם מופע של Workplace, אתם צריכים לרשום אחד ולוודא שאתם אדמינים של המערכת בקבוצה.

  2. הפעלת השילוב דרך מסוף Dialogflow:

    1. עוברים אל מסוף Dialogflow ES.
    2. בתפריט הצד הימני, לוחצים על שילובים.
    3. לוחצים על Workplace from Facebook.
    4. לוחצים על התחלה ותועברו אל Workplace כדי להשלים את ההתקנה:
      • מתחברים לחשבון Workplace. כדי להתקין שילובים, צריך להיות אדמין מערכת בחשבון Workplace.
      • לוחצים על הוספה ל-Workplace בחלון הקופץ שבו מוצגת בקשה להתקין את השילוב של Dialogflow. אפשר גם לשנות את השם של הבוט.

  3. בודקים את האפליקציה:

    1. עוברים אל Workplace ונכנסים לחשבון.
    2. בקטע Home שבסרגל הצד, לוחצים על Bots ומחפשים את Dialogflow (או את השם המותאם אישית של הבוט) כדי להתחיל לשוחח עם הבוט.

ביטול

אם לחצתם על הלחצן התחלה אבל אתם לא רוצים לסיים את ההתקנה ב-Workplace:

  1. עוברים אל מסוף Dialogflow ES.

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

  3. לוחצים על Facebook Workplace:

    1. אם מופיע לחצן ביטול: לוחצים על ביטול כדי לבטל את ההתקנה.
    2. אם מופיע כפתור STOP: פועלים לפי ההוראות שבהמשך כדי להסיר את השילוב.

עצירה

כדי להפסיק שילוב שהותקן בהצלחה:

  1. עוברים אל מסוף Dialogflow ES.

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

  3. לוחצים על Facebook Workplace.

  4. לוחצים על STOP ותועברו אל Workplace כדי לסיים את ההתקנה:

    1. מתחברים לחשבון Workplace. כדי להסיר שילובים, צריך להיות אדמין מערכת ב-Workplace.
    2. מוצאים את השילוב של Dialogflow מבין השילובים המותקנים ב-Workplace ובוחרים אותו, ואז לוחצים על הסרת התקנה כדי לסיים את ההסרה.

  5. השילוב עם Dialogflow יוסר.

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

השילוב הזה מתרגם חלק מההודעות של תגובות עשירות להודעות של סוגי הודעות בפלטפורמת 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"
      }
    }
  }
}

מגבלות

  1. אפשר להתקין סוכן Dialogflow רק במופע אחד של Workplace, אבל אפשר להתקין כמה סוכני Dialogflow במופע אחד של Workplace.

  2. כדי להסיר התקנה שנכשלה, צריך לבטל את ההתקנה ב-Dialogflow ולהסיר את ההתקנה ב-Workplace.

העברה

אם אתם משתמשים בשילוב של Messenger ואתם מתכוונים להעביר אותו לשילוב של Workplace, תצטרכו:

  1. מפסיקים את השילוב עם Messenger.

  2. מסירים את callback_url באפליקציית Facebook על ידי ביצוע הפעולות שבקטע הגדרת אפליקציית Facebook בסדר הפוך.

  3. מתחילים את השילוב עם Workplace לפי השלבים שלמעלה.