이 페이지는 Cloud Translation API를 통해 번역되었습니다.

개요

서비스와 리소스를 Google Chat에서 바로 사용할 수 있는 Google Chat 앱을 빌드하여 사용자가 대화를 나가지 않고도 정보를 얻고 작업을 실행할 수 있도록 합니다.

Google Chat은 다음을 제공하여 팀 공동작업을 지원합니다.

사용자 간의 채팅 메시지
스페이스 내의 대화목록 형식 대화
프로젝트별, 팀별 또는 기타 기준으로 토론 공간을 할당할 수 있는 채팅 스페이스
스페이스에 참여하거나 채팅 메시지에 응답할 수 있는 채팅 앱

메시지 및 스페이스

Google Chat과 Chat 앱 간의 상호작용은 특정 스페이스의 컨텍스트에서 메시지를 사용하여 이루어집니다. 예를 들어 Chat 앱은 특정 Chat 스페이스에 텍스트 (메시지 유형)를 보낼 수 있습니다.

메시지에는 Chat 앱 상호작용, 텍스트, 카드가 포함되며 스페이스에는 채팅방과 채팅 메시지가 포함됩니다.

위의 다이어그램은 메시지와 스페이스에 사용할 수 있는 다양한 유형의 상호작용 및 컨텍스트를 보여줍니다.

Google Chat과 Chat 앱 간의 메시지는 정의된 메시지 형식을 따르며, 각 메시지는 구성요소가 사용자 ID, 스타일, 콘텐츠, 메시지의 기타 측면을 지정하는 JSON 객체로 구성됩니다. 채팅 앱은 다음 유형의 메시지를 보낼 수 있습니다.
- 텍스트 메시지에는 제한된 텍스트 형식이 적용된 일반 텍스트 콘텐츠가 포함됩니다.
- 카드 메시지는 스페이스에 표시할 카드의 형식, 콘텐츠, 동작을 정의합니다. 예를 들어 카드 메시지에는 사용자로부터 정보를 수집하는 대화상자를 여는 링크가 포함된 버튼이 포함될 수 있습니다.
  
  카드 작성 도구를 사용하여 Chat 앱의 메시지 및 사용자 인터페이스를 디자인하고 미리 볼 수 있습니다.
  카드 작성 도구 열기
Google Chat에서 스페이스는 다음과 같은 컨텍스트를 가질 수 있습니다.
- 이름이 지정된 스페이스 또는 그룹 스페이스는 여러 사용자에게 표시됩니다.
- 채팅 메시지는 해당 스페이스의 사용자에게만 표시됩니다.

사용 사례

Chat과 같은 대화형 플랫폼에 Chat 앱을 추가하면 사용자가 맥락을 변경하지 않고도 질문하고 명령을 실행할 수 있습니다. 백엔드에서 Chat 앱은 다른 시스템에 액세스하여 해당 시스템의 중개자 역할을 할 수 있습니다.

통합된 인지 환경을 유지하면서 다양한 리소스와 도구에 대한 액세스를 제공하는 이 기능은 다음을 비롯한 다양한 유형의 애플리케이션에 프레임워크를 제공할 수 있습니다.

워크플로 관리
설정 및 구성
주문 생성
검색
데이터 수집

Chat 스페이스 내에서 Chat 앱에 요청할 수 있는 작업의 예는 다음과 같습니다.

정보 탐색: Chat 앱은 사용자가 입력한 정형 또는 자유 텍스트 쿼리를 기반으로 정보를 검색할 수 있습니다.
티켓 제출 - Chat 앱은 사용자가 제공한 정보를 사용하여 이슈 신고 또는 기타 아티팩트를 생성할 수 있습니다.
협업 조정 - Chat 앱은 '팀 추억'을 제공하거나 리소스를 예약하는 등 팀원들이 서로 상호작용하는 방식을 개선할 수 있습니다.

Chat 앱 빌드

이 섹션에서는 빌드할 수 있는 Chat 앱 유형을 설명합니다.

빌드하는 각 Chat 앱에 대해 Google Cloud 콘솔에서 별도의 Google Cloud 프로젝트를 만들어야 합니다. 채팅 앱을 배포하고 다른 Google Chat 사용자와 공유하려면 Google Workspace Marketplace에 게시하고 등록합니다. 자세한 내용은 Chat 앱의 배포 만들기 및 관리하기를 참고하세요.

양방향 채팅 앱

많은 Chat 앱에서는 사용자가 Chat 앱에 메시지를 보내고 직접 상호작용할 수 있습니다. 대화형 Chat 앱은 다음 작업을 할 수 있습니다.

@멘션, 슬래시 명령어 또는 채팅 메시지로 채팅 메시지 또는 카드 메시지에 응답합니다.
사용자가 양식 데이터 작성과 같은 다단계 프로세스를 완료할 수 있도록 대화상자를 엽니다.
사용자가 대화에서 바로 조치를 취할 수 있는 유용한 정보가 포함된 카드를 첨부하여 링크를 미리 봅니다.

사용자와 상호작용하려면 Chat 앱이 상호작용 이벤트를 수신하고 이에 응답할 수 있어야 합니다. 대화형 Chat 앱을 빌드하려면 Google Chat 앱 상호작용 이벤트 수신 및 응답을 참고하세요.

비대화형 Chat 앱

Google Chat 앱은 사용자가 Chat 앱과 직접 상호작용할 수 없지만 Chat 앱이 Google Chat API를 직접 호출하는 사용자에게는 비대화형일 수도 있습니다. 예를 들어 스페이스에서 메시지를 전송하지만 사용자가 Chat 앱에 응답할 수 없는 Chat 앱을 만들 수 있습니다. 이러한 유형의 Chat 앱 아키텍처는 알람 보고와 같은 작업에 유용합니다. 자세한 내용은 Google Chat API 개요를 참고하세요.

이벤트 기반 Chat 앱

Chat 앱은 Google Workspace Events API를 사용하여 Chat 리소스에 관한 이벤트를 구독할 수 있습니다. 구독을 사용하면 Chat 앱에서 구독된 Google Workspace 리소스의 변경사항을 나타내는 이벤트에 관한 정보를 수신할 수 있습니다. 예를 들어 채팅 앱이 구독 중인 스페이스의 변경사항에 응답할 수 있습니다(예: 스페이스에 추가된 신규 회원에게 환영 메시지 보내기). 자세한 내용은 Google Chat 이벤트 구독을 참고하세요.

Chat 앱 아키텍처 선택

Chat API는 앱을 Chat 스페이스에 통합하는 여러 가지 방법을 제공하지만 Chat 앱 로직을 구현하는 특정 방법은 제공하거나 지시하지 않습니다. 명령어 기반 채팅 앱을 만들거나 원하는 모든 종류의 언어 처리 및 AI 서비스 또는 모듈을 사용할 수 있으며, 다음을 비롯한 다양한 플랫폼에서 이를 실행할 수 있습니다.

AppSheet
Google Apps Script
Dialogflow
Pub/Sub
Google Cloud 또는 온프레미스 HTTP 서버

자세한 내용은 Chat 앱 아키텍처 선택을 참고하세요.

앱의 사용자 데이터 액세스

Chat 앱이 호출되면 누가 호출하는지, 어떤 맥락에서 호출하는지, 호출자를 어떻게 처리할지 알아야 합니다. 이 기본 ID 데이터 이외의 데이터에 액세스하려면 Chat 앱에 인증을 통해 액세스 권한을 부여해야 합니다.

기본적으로 Chat 앱은 앱을 호출하는 사용자 또는 앱을 호출하는 메시지에서 @멘션된 사용자의 기본 ID만 읽을 수 있습니다. 이 정보에는 사용자의 표시 이름, 사용자 ID, 이메일 주소, 아바타 이미지가 포함됩니다.
링크를 미리 보는 Chat 앱의 경우 Chat 앱은 Chat 앱의 구성된 URL 패턴과 일치하는 메시지에 추가된 URL을 읽을 수 있습니다.
Chat 앱이 모든 메시지 또는 스페이스의 구성원 목록 읽기와 같은 향상된 기능을 사용자에게 제공하기 위해 다른 데이터에 액세스해야 하는 경우 해당 데이터에 액세스할 수 있도록 인증을 설정합니다. 사용자 데이터에 액세스하는 경우 Chat 앱에서 사용자에게 액세스 권한을 요청하는 메시지를 표시하며 사용자는 이 권한을 부여해야 합니다. 자세한 내용은 Chat 앱을 다른 서비스 및 도구와 연결을 참고하세요.

개요