Google Chat

השילוב של Dialogflow CX עם Google Chat מאפשר לכם ליצור אפליקציות ל-Google Chat עם הבנה של שפה טבעית שמבוססת על טכנולוגיית 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 מופעלים בפרויקט הנכון בענן ולוחצים על הבא.

  3. מוודאים שמפעילים את ממשקי ה-API הנכונים ולוחצים על הפעלה.

הגדרה מ-Dialogflow CX

  1. עוברים אל מסוף Dialogflow CX.
  2. בוחרים את הפרויקט Google Cloud .
  3. בוחרים את הסוכן.
  4. לוחצים על הכרטיסייה ניהול.
  5. בתפריט הצד הימני, לוחצים על שילובים.
  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.
  8. בוחרים סביבה לפי הצורך.
  9. מזינים כתובות אימייל כדי שהאפליקציה הזו ל-Chat תהיה זמינה לאנשים ולקבוצות ספציפיים, לפי הצורך.
  10. לוחצים על התחלה.

בדיקה

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

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

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

הודעות התשובה המתקדמות נתמכות באמצעות Custom Payload ב-Fulfillment. מידע על פורמט ההודעות זמין במאמר בנושא Google Chat message API.

הודעת טקסט

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

{
  "text": "Hello, world"
}

המטען הייעודי (payload) המותאם אישית הבא מספק הודעת טקסט ב-Google Chat אם אתם משתמשים בתוסף ל-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'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

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

{
  "host_app_data_action": {
    "chat_data_action": {
      "create_message_action": {
        "message": {
          "cardsV2": [
            {
              "card_id": "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.