שילוב של Dialogflow עם Google Chat

שילוב של Dialogflow עם Google Chat מאפשר לכם להשתמש בתכונות של שני השירותים:

  • Google Chat. פלטפורמה לשליחת הודעות עם ממשק משתמש קצה לשיחות אישיות ולמרחבי צ'אט. באמצעות Google Chat, אתם יכולים לשפר את ממשקי המשתמש על ידי יצירת כרטיסים שכוללים סמלים, תמונות, כפתורים, שדות להזנת טקסט או אפליקציות כמו מפות Google.
  • ‫Dialogflow. מספק פלטפורמה להבנת שפה טבעית לשיחות אוטומטיות ולתשובות דינמיות. באמצעות Dialogflow, אפשר לפרש את כוונות המשתמשים ולבצע אותן, למשל לקבוע פגישות או לעבד רכישות.

אפשר גם להשתמש ב-Google Chat כדי למלא בקשות של משתמשים, אבל Dialogflow מאפשר למשתמשים להביע את הבקשות שלהם באמצעות שיחה רגילה.

איך זה עובד

אחרי שיוצרים אפליקציית Google Chat עם Dialogflow, אפשר להפוך את האפליקציה לזמינה ל:

  • הציבור הרחב. משתמשי Google Workspace עם רישיון יכולים להוריד את האפליקציה שלכם דרך Google Workspace Marketplace.
  • דומיין ב-Google Workspace. אדמין ב-Google Workspace יכול לציין אילו אפליקציות משתמשים יכולים להוסיף ל-Google Chat.
  • בודקי אפליקציות. במהלך הבדיקה של האפליקציה, אפשר להגביל את הגישה אליה.

ב-Google Chat, משתמש יכול לנהל צ'אט ישיר עם האפליקציה שלכם או להפעיל את האפליקציה מתוך מרחב. מה קורה:

  1. משתמש שולח הודעה לאפליקציית Chat.
  2. ‫Google Chat שולח בקשת JSON לאפליקציית Chat, שיכולה להיות מאוחסנת ב-Cloud Functions.
  3. אפליקציית הצ'אט מקבלת את בקשת ה-JSON ומנתחת אותה. במהלך הניתוח הזה, אפליקציית Chat מפעילה את Dialogflow.
  4. אפליקציית Chat שולחת בקשה ל-Dialogflow שכוללת את הטקסט של ההודעה בשפה טבעית של המשתמש.
  5. ‫Dialogflow מפרש את הטקסט של המשתמש ושולח תשובה לאפליקציית Chat.
  6. אפליקציית Chat מנתחת את התשובה של Dialogflow ושולחת תשובת JSON ל-Google Chat.
  7. ‫Google Chat מקבל את תגובת ה-JSON של אפליקציית Chat ומציג תגובה בצורה של הודעת טקסט, הודעת כרטיס או הודעה בתיבת דו-שיח בממשק המשתמש.
  8. ‫Google Chat משתף את התשובה כמו שהיא או מציג תשובה עשירה באמצעות ממשק משתמש מבוסס-כרטיסים.

בדף הזה מוסבר איך לשלב את Dialogflow עם Google Chat ולהגדיר תשובות צ'אט עשירות.

מגבלות

כשמשלבים את Dialogflow עם Google Chat, סוכן Dialogflow יכול להשתמש רק בשפת ברירת המחדל של הסוכן.

לפני שמתחילים

רק משתמשי Google Workspace עם רישיון יכולים להשתמש באפליקציות של Google Chat. האדמין ב-Google Workspace צריך לבצע את הפעולות הבאות:

יצירת סוכן Dialogflow

אם עדיין לא יצרתם סוכן Dialogflow אבל אתם רוצים לראות איך סוכן מנהל שיחה עם Google Chat, אתם יכולים לפעול לפי המדריך לתחילת העבודה כדי ליצור סוכן פשוט. אבל אל תמחקו את הסוכן. לאחר מכן, הגדרנו את הסוכן עם ממשק Google Chat.

הגדרה של Google Chat

כדי להגדיר את סוכן Dialogflow באמצעות Google Chat, אפשר להשתמש באחת מהאפשרויות הבאות:

הגדרה של Google Chat באמצעות מסוף Dialogflow

כדי לשלב את Google Chat באמצעות מסוף Dialogflow, פועלים לפי השלבים הבאים:

  1. עוברים אל מסוף Dialogflow ES.
  2. בתפריט הימני, בוחרים פרויקט Dialogflow.
  3. לוחצים על Integrations (שילובים).
  4. לוחצים על Google Chat. אם Google Chat לא מופיע בין האפשרויות, אפשר לעיין בפתרון בעיות.
  5. בוחרים מי יוכל לגשת לאפליקציה.
  6. [אופציונלי] בוחרים סביבה להרצת הסוכן.
  7. לוחצים על התחלה.

אפליקציית Google Chat פעילה עכשיו וזמינה למשתמשים שבחרתם.

כדי להגדיר את האפליקציה, לוחצים שוב על Google Chat ואז על הגדרת פרטי הצ'אטבוט. מוצג Google Cloud דף המסוף של Google Chat API, שבו אפשר להגדיר פרמטרים של האפליקציה כמו האווטאר של האפליקציה.

הגדרת Google Chat באמצעות מסוף Google Cloud

כדי לשלב את Google Chat באמצעות מסוף Google Cloud , פועלים לפי השלבים הבאים:

  1. בוחרים את הפרויקט ב-Dialogflow.

    כניסה לדף לבחירת הפרויקט

  2. לחץ על .

  3. לוחצים על APIs & Services (ממשקי API ושירותים) ואז על Library (ספרייה).

  4. מחפשים את Google Chat API ולוחצים עליו.

  5. לוחצים על Enable.

  6. לוחצים על הכרטיסייה Configuration.

  7. מגדירים את האפליקציה.

  8. בחלונית חשיפה, בוחרים מי יוכל לגשת לאפליקציה:

    • בודקי אפליקציות. בוחרים באפשרות הצ'אט הזה יהיה זמין לאנשים ספציפיים ומזינים את כתובות האימייל שלהם.
    • הציבור הרחב או דומיין Google Workspace Enterprise. פרסום האפליקציה.

  9. לוחצים על Save. אפליקציית Google Chat שלכם פעילה עכשיו וזמינה לאנשים שבחרתם.

בדיקה

לפני שבודקים את אפליקציית Chat, צריך לוודא שהפעלתם אותה, כמו שמתואר במאמר בנושא הגדרת Google Chat.

אפשר לבדוק את האפליקציה באחת מהשיטות הבאות:

צ'אט ישירות עם האפליקציה

  1. פותחים את Google Chat.
  2. בחלונית צ'אט, לוחצים על + ובוחרים באפשרות חיפוש אפליקציות.
  3. מחפשים את האפליקציה ובוחרים אותה. אם האפליקציה לא מופיעה ב-Google Chat, אפשר לעיין בפתרון בעיות.
  4. לוחצים על צ'אט.
  5. בשדה להזנת הודעה בצ'אט, מזינים ביטוי בשפה טבעית כדי לבדוק את האפליקציה.

הפעלת האפליקציה ממרחב

  1. פותחים את Google Chat.
  2. בחלונית מרחבים, לוחצים על + ובוחרים באפשרות יצירת מרחב.
  3. מזינים את שם המרחב Test.
  4. לוחצים על יצירה.
  5. בשדה להזנת הודעות בצ'אט, מקלידים @ ובוחרים את האפליקציה כדי להשלים אוטומטית את השם.
  6. אחרי שם האפליקציה שמושלם אוטומטית, מזינים ביטוי בשפה טבעית כדי לבדוק את האפליקציה.

פתרון בעיות

שגיאה פתרון
‫Google Chat לא מוצגת כאפשרות בדף Integrations (שילובים) במסוף Dialogflow ES. מנסים לרענן את הדף: בתפריט הימני, לוחצים על Intents (כוונות) ואז על Integrations (שילובים).
האפליקציה לא מופיעה ב-Google Chat. צריך לוודא שהאדמין ב-Google Workspace הוסיף לכם חשבון Google Workspace ואפשר למשתמשים להתקין אפליקציות ל-Chat. לאחר מכן מוודאים שהפעלתם את אפליקציית Chat, כמו שמתואר במאמר הגדרת Google Chat.

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

השילוב הזה מתרגם חלק מההודעות של תגובות עשירות לפורמטים של הודעות ב-Google Chat.

תשובות בהודעת טקסט

תשובות טקסט נשלחות ל-Google Chat כהודעות טקסט. בעזרת העיצוב הזה אפשר להדגיש טקסט או להטות אותו על ידי הוספת סימנים מסוימים (ב-Markdown Light) לפני הטקסט ואחריו.

התשובה בהודעת הטקסט נראית בדיוק כמו תשובת הטקסט שמוגדרת כברירת מחדל במסוף Dialogflow. עם זאת, התשובה הגולמית של ה-API תיראה קצת שונה. היא גם מגדירה את תצורת הפלטפורמה ל-GOOGLE_HANGOUTS, וזה יכול להיות שימושי כשבונים סוכנים לכמה שילובים.

"fulfillmentMessages": [
{
   "text": {
   "text": [
        "This is a test."
   ]
},
  "platform": "GOOGLE_HANGOUTS"
},

כרטיסים

תשובות לכרטיסים נשלחות ל-Google Chat בתור הודעות כרטיס.

תמונות

תשובות עם תמונות נשלחות ל-Google Chat בתור ווידג'טים של תמונות ב-Google Chat.

מטען ייעודי (payload) מותאם אישית

כדי לשלוח סוגים אחרים של הודעות ב-Google Chat, אפשר להשתמש במטען ייעודי (payload) בהתאמה אישית.

‫Google Chat Custom Payload מאפשר ליצור כרטיסים מתקדמים יותר. כרטיס אחד יכול להכיל קטע אחד או כמה קטעים. לכל קטע יכולה להיות כותרת. כדי לראות כמה מהשילובים שאפשר ליצור, אפשר לעיין במדריך העיון בכרטיסים של פורמטים של הודעות ב-Google Chat. עם זאת, אם משתמשים במטענים ייעודיים (payloads) בהתאמה אישית, צריך לספק את פורמט ה-JSON.

דוגמה למטען ייעודי (payload) מותאם אישית בפורמט Cards v1:

{
  "hangouts": {
    "header": {
      "title": "Pizza Delivery Customer Support",
      "subtitle": "pizzadelivery@example.com",
      "imageUrl": "https://goo.gl/aeDtrS"
    },
    "sections": [{
      "widgets": [{
        "keyValue": {
          "icon": "TRAIN",
          "topLabel": "Order No.",
          "content": "12345"
        }
      },
      {
        "keyValue": {
          "topLabel": "Status",
          "content": "In Delivery"
        }
      }]
    },
    {
      "header": "Location",
      "widgets": [{
        "image": {
          "imageUrl": "https://dummyimage.com/600x400/000/fff"
        }
      }]
    },
    {
      "header": "Buttons - I could leave the header out",
      "widgets": [{
        "buttons": [{
          "textButton": {
            "text": "OPEN ORDER",
            "onClick": {
              "openLink": {
                "url": "https://example.com/orders/..."
              }
            }
          }
        }]
      }]
    }]
  }
}

הפסקת השימוש באפליקציית Chat

כדי להפסיק את הזמינות של אפליקציית Google Chat, אתם יכולים להשתמש באחת מהאפשרויות הבאות:

הפסקת השימוש באפליקציית Chat באמצעות מסוף Dialogflow

  1. עוברים אל מסוף Dialogflow ES.
  2. בתפריט הימני, בוחרים פרויקט Dialogflow.
  3. לוחצים על Integrations (שילובים).
  4. לוחצים על Google Chat. אם Google Chat לא מופיע בין האפשרויות, אפשר לעיין בפתרון בעיות.
  5. לוחצים על הפסקה.

הפסקת השימוש באפליקציית Chat באמצעות מסוף Google Cloud

  1. בוחרים את פרויקט Dialogflow מהמסוף Google Cloud .

    כניסה לדף לבחירת הפרויקט

  2. לחץ על .

  3. לוחצים על APIs & Services (ממשקי API ושירותים) ואז על Library (ספרייה).

  4. מחפשים את Google Chat API ולוחצים עליו.

  5. לוחצים על ניהול.

  6. לוחצים על הכרטיסייה Configuration.

  7. בשדה סטטוס האפליקציה, בוחרים באפשרות מושבתת.

מידע נוסף

למידע נוסף על השימוש ב-Google Chat, אפשר לעיין במאמרים הבאים: