Google Chat

미리보기

이 제품 또는 기능에는 서비스별 약관의 일반 서비스 약관 섹션에 있는 'GA 이전 제공 서비스 약관'이 적용됩니다. GA 이전 제품 및 기능은 '있는 그대로' 제공되며 지원이 제한될 수 있습니다. 자세한 내용은 출시 단계 설명을 참조하세요.

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

참고: 타사 통합을 사용하면 요청과 최종 사용자 데이터가 Google과 타사 모두에 전송됩니다. Google이 이러한 요청을 처리하는 데는 에이전트 버전의 서비스 약관, SLA, 가격 책정, 할당량이 적용됩니다. 타사의 요청 처리에는 타사의 서비스 약관, SLA, 가격 책정, 할당량이 적용됩니다.

제한사항

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

Google Chat 설정

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

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

Google Chat API 사용 설정

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

1. Google Cloud 콘솔에서 Google Chat API 및 Dialogflow API를 사용 설정합니다.

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

3. 올바른 API를 사용 설정했는지 확인한 후 사용 설정을 클릭합니다.

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

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

테스트

참고: 통합을 테스트하기 전에 프로젝트에 결제가 사용 설정되어 있는지 확인합니다.

구성된 앱을 테스트하려면 Google Chat 스페이스에서 언급하거나 DM을 보냅니다. 예를 들면 다음과 같습니다.

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

참고: 결과 목록에 채팅 앱이 표시되지 않으면 Google Workspace 계정에서 채팅 앱을 사용할 수 있도록 설정했는지 확인하세요.

리치 응답 메시지

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

참고: 커스텀 페이로드에 지정되지 않은 경우 스페이스 및 스레드 객체가 입력 메시지의 리소스 ID와 함께 자동으로 삽입됩니다.

문자 메시지

다음 커스텀 페이로드는 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 채널을 사용하는 채널별 응답이 자동으로 사용됩니다.

관련 주제

• 자연어를 이해하고 대답하는 대화형 에이전트(Dialogflow CX) Google Chat 앱 빌드