개요

서비스와 리소스를 Google Chat에 바로 가져오는 Google Chat 앱을 빌드하면 사용자가 대화를 떠나지 않고도 정보를 얻고 조치를 취할 수 있습니다.

Google Chat은 다음과 같은 기능을 통해 팀 공동작업을 지원합니다.

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

메시지 및 스페이스

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

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

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

  • Google Chat과 채팅 앱 간의 메시지는 정의된 메시지 형식을 따르며, 여기서 각 메시지는 JSON 객체로 구성됩니다. 이 객체에는 구성요소가 사용자 ID, 스타일, 콘텐츠 및 기타 여러 측면을 지정합니다. 채팅 앱에서는 다음 유형의 메시지를 보낼 수 있습니다.

    • 문자 메시지에는 텍스트 형식이 제한된 일반 텍스트 콘텐츠가 포함됩니다.
    • 카드 메시지는 공간에 표시할 카드의 형식, 콘텐츠, 동작을 정의합니다. 예를 들어 카드 메시지에는 사용자로부터 정보를 수집하는 대화상자를 여는 링크가 있는 버튼이 포함될 수 있습니다.


      카드 빌더로 카드를 디자인하고 미리 봅니다.

      카드 빌더 열기

  • Google Chat에서 스페이스는 다음과 같은 컨텍스트를 사용할 수 있습니다.

    • 이름이 지정된 스페이스 또는 그룹 스페이스는 여러 사용자에게 표시됩니다.
    • 채팅 메시지는 해당 스페이스의 사용자에게만 표시됩니다.

사용 사례

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

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

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

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

  • 정보 검색 — 채팅 앱은 사용자가 입력한 구조화된 쿼리 또는 자유 텍스트 쿼리를 기반으로 정보를 검색할 수 있습니다.
  • 파일 티켓 - 채팅 앱은 사용자가 제공한 정보를 사용하여 이슈 보고서 또는 기타 아티팩트를 생성할 수 있습니다.
  • 작업 조정 - 채팅 앱은 '팀 메모리'를 제공하거나 리소스를 예약하는 등 팀원 간의 상호작용을 개선할 수 있습니다.

채팅 앱 빌드

이 섹션에서는 빌드할 수 있는 몇 가지 채팅 앱 유형을 설명합니다.

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

대화형 채팅 앱

많은 채팅 앱에서 사용자가 직접 메시지를 보내고 채팅 앱과 상호작용할 수 있습니다. 대화형 채팅 앱은 다음 중 하나를 실행할 수 있습니다.

  • @멘션, 슬래시 명령어 또는 채팅 메시지에 SMS나 카드 메시지로 응답하세요.
  • 대화상자를 열어 사용자가 양식 데이터 작성과 같은 다단계 프로세스를 완료할 수 있도록 지원합니다.
  • 링크 미리보기: 사용자가 대화에서 바로 작업을 실행할 수 있도록 유용한 정보가 포함된 카드를 첨부해 링크를 미리 볼 수 있습니다.

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

비대화형 채팅 앱

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

이벤트 기반 채팅 앱

채팅 앱은 Google Workspace Events API를 사용하여 Chat 리소스에 대한 이벤트를 구독할 수 있습니다. 구독을 통해 채팅 앱은 구독한 Google Workspace 리소스의 변경사항을 나타내는 이벤트에 대한 정보를 수신할 수 있습니다. 예를 들어 채팅 앱은 스페이스에 추가된 새로운 멤버에게 환영 메시지를 보내는 등 채팅 앱이 구독하는 스페이스의 변경사항에 응답할 수 있습니다. 자세한 내용은 Google Chat 이벤트 구독을 참고하세요.

채팅 앱 아키텍처 선택

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

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

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

사용자 데이터에 대한 앱 액세스 권한

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

  • 기본적으로 채팅 앱은 앱을 호출하는 동일한 메시지에서 자신을 호출한 사용자나 @멘션된 사용자의 기본 ID만 읽을 수 있습니다. 이 정보에는 사용자의 표시 이름, 사용자 ID, 이메일 주소, 아바타 이미지가 포함됩니다.
  • 링크를 미리 보는 채팅 앱의 경우 채팅 앱은 채팅 앱의 구성된 URL 패턴과 일치하는 메시지에 추가된 URL을 읽을 수 있습니다.

  • 채팅 앱에서 사용자에게 향상된 기능(예: 스페이스의 모든 메시지 또는 구성원 목록 읽기)을 제공하기 위해 다른 데이터에 액세스해야 하는 경우 채팅 앱에서 데이터에 액세스할 수 있도록 인증을 설정합니다. 사용자 데이터에 액세스하는 경우 채팅 앱은 사용자에게 액세스 권한을 요청하라는 메시지를 표시하고 사용자가 이를 부여해야 합니다. 자세한 내용은 다른 서비스 및 도구와 채팅 앱 연결을 참고하세요.

Google Chat API가 실제로 작동하는 모습을 보고 싶으신가요?
Google Workspace 개발자 채널에서는 도움말, 유용한 정보, 최신 기능에 대한 동영상을 제공합니다.