Google Chat

השילוב של Google Chat עם Dialogflow CX מאפשר לכם ליצור אפליקציות ל-Google Chat עם הבנת שפה טבעית (NLU) שמבוססת על טכנולוגיית Dialogflow CX.

מגבלות

הגדרה של Google Chat

כדי להגדיר את השילוב של Google Chat לנציג, צריך:

הפעלת Google Chat API

לפני שאתם משתמשים בממשקי Google API, אתם צריכים להפעיל אותם בפרויקט ב- Google Cloud. בכל פרויקט ב- Google Cloudאפשר להפעיל ממשק API אחד או יותר.

  1. ב https://console.cloud.google.com/, מפעילים את Google Chat API ואת Dialogflow API.
  2. מוודאים שממשקי ה-API מופעלים בפרויקט הנכון ב-Cloud ולוחצים על Next.
  3. מוודאים שמפעילים את ממשקי ה-API הנכונים ולוחצים על Enable.

הגדרה דרך Dialogflow CX

  1. נכנסים למסוף Dialogflow CX.
  2. בוחרים את הפרויקט ב- Google Cloud .
  3. בוחרים את הסוכן.
  4. בתפריט הניווט, עוברים לכרטיסייה ניהול.
  5. לוחצים על Integrations (שילובים).
  6. לוחצים על קישור ב-Google Chat.
  7. ממלאים את הפרטים הנדרשים הבאים:
    • שם: השם שמוצג למשתמשים שיוצרים אינטראקציה עם תוכן שנוצר על ידי האפליקציה הזו או צורכים אותו, למשל בהודעות, בחיפוש ובתיוגים באמצעות @. לדוגמה, Dialogflow CX App.
    • כתובת URL של דמות: תמונת הדמות שמוצגת למשתמשים שיוצרים אינטראקציה עם האפליקציה. צריך לציין כתובת URL מסוג HTTPS שמארחת תמונת PNG ריבועית (יחס גובה-רוחב של 1:1). גודל מינימלי מומלץ: 256 על 256 פיקסלים. לדוגמה, https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png.
    • תיאור: תיאור של האפליקציה. לדוגמה, A helpful bot that responds to real human conversation.
    • ‫Environment: הסביבה שאליה רוצים להתחבר. בוחרים סביבה, לפי הצורך.
  8. מזינים כתובות אימייל כדי שהאפליקציה ל-Chat תהיה זמינה לאנשים ולקבוצות ספציפיים, לפי הצורך.
  9. לוחצים על התחלה.

בדיקה

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

לדוגמה:

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

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

אפשר לתמוך בהודעות עם תגובות עשירות באמצעות מטען ייעודי (payload) מותאם אישית במילוי בקשות. בGoogle Chat message API מוסבר על פורמט ההודעה.

הודעת טקסט

המטען הייעודי המותאם אישית הבא מספק הודעת טקסט ב-Google Chat:

{
  "text": "Hello, world"
}

אם אתם משתמשים בתוסף של Chat, המטען הייעודי (payload) המותאם אישית הבא מספק הודעת טקסט ב-Google Chat:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "text": "Your pizza delivery is here!"
        }
      }
    }
  }
}

הודעה בכרטיס

המטען הייעודי (payload) המותאם אישית הבא מספק הודעת כרטיס ב-Google Chat:

{
  "cardsV2": [{
    "cardId": "createCardMessage",
    "card": {
      "header": {
        "title": "A card message!",
        "subtitle": "Sent from Dialogflow CX",
        "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
        "imageType": "CIRCLE"
      },
      "sections": [
        {
          "widgets": [
            {
              "buttonList": {
                "buttons": [
                  {
                    "text": "Read the docs!",
                    "onClick": {
                      "openLink": {
                        "url": "https://developers.google.com/workspace/chat"
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

אם אתם משתמשים בתוסף של Chat, המטען הייעודי (payload) המותאם אישית הבא מספק הודעת כרטיס של Google Chat:

{
  "hostAppDataAction": {
    "chatDataAction": {
      "createMessageAction": {
        "message": {
          "cardsV2": [
            {
              "cardId": "basic1",
              "card": {
                "header": {
                  "title": "This is a card!",
                  "subtitle": "Sent from Conversational Agents (Dialogflow CX)",
                  "imageUrl": "https://developers.google.com/chat/images/chat-product-icon.png",
                  "imageType": "CIRCLE"
                },
                "sections": [
                  {
                    "widgets": [
                      {
                        "buttonList": {
                          "buttons": [
                            {
                              "text": "Open Google!",
                              "color": {
                                "red": 0.101960786,
                                "green": 0.4509804,
                                "blue": 0.9098039
                              },
                              "onClick": {
                                "openLink": {
                                  "url": "http://google.com"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

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

אחרי שמגדירים תשובות ספציפיות לערוץ עם הערוץ DF_CX_GOOGLE_CHAT, הנציג משתמש בהן באופן אוטומטי כשהוא עונה להודעות צ'אט ב-Google Chat.