Google Chat

Dialogflow CX의 Google Chat 통합을 사용하면 Dialogflow CX 기술을 기반으로 자연어를 이해할 수 있는 Google Chat 앱을 만들 수 있습니다.

제한사항

이 통합에서는 에이전트 기본 언어의 텍스트 입력만 지원됩니다.

Google Chat 설정

에이전트에 대해 Google Chat 통합을 설정하려면 다음이 필요합니다.

Google Chat에 액세스할 수 있는 Google Workspace 계정
Google Cloud 프로젝트

Google Chat API 사용 설정

Google API를 사용하려면 먼저 Google Cloud프로젝트에서 사용 설정해야 합니다. 단일 Google Cloud프로젝트에서 하나 이상의 API를 사용 설정할 수 있습니다.

https://console.cloud.google.com/에서 Google Chat API 및 Dialogflow API를 사용 설정합니다.
올바른 Cloud 프로젝트에서 API를 사용 설정하는지 확인한 후 다음을 클릭합니다.
올바른 API를 사용 설정했는지 확인한 후 사용 설정을 클릭합니다.

Dialogflow CX에서 설정

Dialogflow CX 콘솔로 이동합니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
탐색 메뉴에서 관리 탭으로 이동합니다.
통합을 선택합니다.
Google Chat에서 연결을 클릭합니다.
다음 필수 정보를 입력합니다.
- 이름: 메시지, 검색, @멘션과 같은 이 앱에서 만든 콘텐츠와 상호작용하거나 콘텐츠를 사용하는 사용자에게 표시되는 이름입니다. 예를 들면 Dialogflow CX App입니다.
- 아바타 URL: 앱과 상호작용하는 사용자에게 표시되는 아바타 이미지입니다. 정사각형 (가로세로 비율 1:1) PNG 이미지를 호스팅하는 HTTPS URL을 지정합니다. 권장 최소 크기: 256x256픽셀 예를 들면 https://developers.google.com/workspace/chat/images/quickstart-app-avatar.png입니다.
- 설명: 앱에 대한 설명입니다(예: A helpful bot that responds to real human conversation).
- 환경: 연결할 환경입니다. 적절히 환경을 선택합니다.
이메일 주소를 입력하여 이 Chat 앱을 특정 사용자 및 그룹에서 사용할 수 있도록 설정합니다.
시작을 클릭합니다.

테스트

구성된 앱을 테스트하려면 Google Chat 스페이스에서 앱을 멘션하거나 채팅 메시지를 보냅니다.

예를 들면 다음과 같습니다.

Google Chat을 엽니다.
새 채팅을 클릭합니다.
사용자 1명 이상 추가 필드에 Chat 앱의 이름을 입력합니다.
검색 결과에서 채팅 앱을 선택합니다. 채팅 메시지가 열립니다.

리치 응답 메시지

fulfillment의 커스텀 페이로드를 사용하여 리치 응답 메시지를 지원할 수 있습니다. 메시지 형식에 관한 자세한 내용은 Google Chat 메시지 API를 참조하세요.

문자 메시지

다음 커스텀 페이로드는 Google Chat 문자 메시지를 제공합니다.

{
  "text": "Hello, world"
}

Chat 부가기능을 사용하는 경우 다음 커스텀 페이로드는 Google Chat 문자 메시지를 제공합니다.

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

카드 메시지

다음 커스텀 페이로드는 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 부가기능을 사용하는 경우 다음 커스텀 페이로드는 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"
                                }
                              }
                            }
                          ]
                        }
                      }
                    ]
                  }
                ]
              }
            }
          ]
        }
      }
    }
  }
}

채널별 응답

구성된 경우 에이전트가 Google Chat 메시지에 응답할 때 DF_CX_GOOGLE_CHAT 채널을 사용하는 채널별 응답이 자동으로 사용됩니다.