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를 사용 설정할 수 있습니다.

Google Cloud 콘솔에서 Google Chat API 및 Dialogflow API를 사용 설정합니다.
올바른 Cloud 프로젝트에서 API를 사용 설정했는지 확인한 후 다음을 클릭합니다.
올바른 API를 사용 설정했는지 확인한 다음 사용 설정을 클릭합니다.

대화형 에이전트(Dialogflow CX)에서 설정

Dialogflow CX 콘솔로 이동합니다.
Google Cloud 프로젝트를 선택합니다.
에이전트를 선택합니다.
관리 탭을 선택합니다.
왼쪽 사이드바 메뉴에서 통합을 클릭합니다.
Google Chat에서 연결을 클릭합니다.
다음 필수 정보를 입력합니다.
- 이름: 메시지, 검색, @멘션과 같은 이 앱에서 만든 콘텐츠와 상호작용하거나 콘텐츠를 사용하는 사용자에게 표시되는 이름입니다. 예를 들면 Conversational Agents (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입니다.
적절히 환경을 선택합니다.
해당하는 경우 특정 사용자 및 그룹에서 이 채팅 앱을 사용할 수 있도록 하려면 이메일 주소를 입력합니다.
시작을 클릭합니다.

테스트

구성된 앱을 테스트하려면 Google Chat 스페이스에서 앱을 멘션하거나 DM을 전송합니다. 예를 들면 다음과 같습니다.

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

리치 응답 메시지

리치 응답 메시지는 fulfillment의 커스텀 페이로드를 사용해 지원됩니다. 메시지 형식은 Google Chat 메시지 API를 참조하세요.

문자 메시지

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

{
  "text": "Hello, world"
}

카드 메시지

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

{
  'cardsV2': [{
    'cardId': 'createCardMessage',
    'card': {
      'header': {
        'title': 'A card message!',
        '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': 'Read the docs!',
                    'onClick': {
                      'openLink': {
                        'url': 'https://developers.google.com/workspace/chat'
                      }
                    }
                  }
                ]
              }
            }
          ]
        }
      ]
    }
  }]
}

채널별 응답

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