이 페이지에서는 외부 트리거를 사용하여 Chat 스페이스에 비동기 메시지를 전송하도록 웹훅을 설정하는 방법을 설명합니다. 예를 들어 서버가 다운되면 Chat에서 대기 중인 직원에게 알리도록 모니터링 애플리케이션을 구성할 수 있습니다. 채팅 앱을 사용하여 동기 메시지를 보내려면 메시지 보내기를 참조하세요.
이러한 유형의 아키텍처 설계에서는 통신이 단방향이기 때문에 사용자가 웹훅 또는 연결된 외부 애플리케이션과 상호작용할 수 없습니다. 웹훅은 대화형이 아닙니다. 사용자 또는 Chat 앱 상호작용 이벤트에 응답하거나 사용자의 메시지를 수신할 수 없습니다. 메시지에 응답하려면 웹훅 대신 채팅 앱을 빌드하세요.
웹훅은 엄밀히 말해 채팅 앱이 아니지만 표준 HTTP 요청을 사용하여 웹훅은 애플리케이션을 연결하지만, 이 페이지에서는 편의상 웹훅이라고 합니다. 각 웹훅은 등록된 Chat 스페이스에서만 작동합니다. 수신 웹훅은 모든 사용자가 채팅 앱을 사용 설정한 경우에만 채팅 메시지에서 작동합니다. Google Workspace Marketplace에 웹훅을 게시할 수 없습니다.
다음 다이어그램은 Chat에 연결된 웹훅의 아키텍처를 보여줍니다.
위의 다이어그램에서 채팅 앱에는 다음과 같은 정보 흐름이 있습니다.
- 채팅 앱 로직은 프로젝트 관리 시스템이나 티켓팅 도구와 같은 외부 서드 파티 서비스에서 정보를 수신합니다.
- 채팅 앱 로직은 웹훅 URL을 사용하여 특정 Chat 스페이스에 메시지를 보낼 수 있는 클라우드 또는 온프레미스 시스템에서 호스팅됩니다.
- 사용자는 특정 Chat 스페이스에서 채팅 앱의 메시지를 수신할 수 있지만 채팅 앱과 상호작용할 수는 없습니다.
기본 요건
Python
- Chat에 액세스할 수 있는 Google Workspace 계정 Google Workspace 조직에서는 사용자가 수신 웹훅을 추가 및 사용하도록 허용해야 합니다.
- Python 3.10.7 이상
httplib2
라이브러리 필요한 경우 다음 명령줄 인터페이스 (CLI) 명령어를 실행하여pip
를 사용하는 라이브러리를 설치합니다.pip install httplib2
기존 Chat 스페이스
Node.js
- Chat에 액세스할 수 있는 Google Workspace 계정 Google Workspace 조직에서는 사용자가 수신 웹훅을 추가 및 사용하도록 허용해야 합니다.
- Node.js 및 npm이 설치됨
- 기존 Chat 스페이스
Java
- Chat에 액세스할 수 있는 Google Workspace 계정 Google Workspace 조직에서는 사용자가 수신 웹훅을 추가 및 사용하도록 허용합니다.
- 자바 11 이상
- Apache Maven
- 기존 Chat 스페이스
Apps Script
- Chat에 액세스할 수 있는 Google Workspace 계정 Google Workspace 조직에서는 사용자가 수신 웹훅을 추가 및 사용하도록 허용합니다.
- 기존 Chat 스페이스
웹훅 만들기
웹훅을 만들려면 메시지를 수신하려는 Chat 스페이스에 웹훅을 등록한 다음 메시지를 전송하는 스크립트를 작성합니다.
수신 웹훅 등록
- 브라우저에서 Chat을 엽니다. Chat 모바일 앱에서는 웹훅을 구성할 수 없습니다.
- 웹훅을 추가할 스페이스로 이동합니다.
- 스페이스 제목 옆에 있는 펼치기 화살표를 클릭하고 앱 및 통합을 클릭합니다.
Add webhooks(웹훅 추가)를 클릭합니다.
이름 필드에
Quickstart Webhook
를 입력합니다.아바타 URL 필드에
https://developers.google.com/chat/images/chat-product-icon.png
를 입력합니다.저장을 클릭합니다.
웹훅 URL을 복사하려면
더보기를 클릭한 다음 링크 복사를 클릭합니다.
웹훅 스크립트 작성
웹훅 스크립트 예시는 웹훅 URL에 POST
요청을 전송하여 웹훅이 등록된 공간에 메시지를 전송합니다. Chat API는 Message
인스턴스로 응답합니다.
웹훅 스크립트를 만드는 방법을 알아보려면 언어를 선택하세요.
Python
작업 디렉터리에서
quickstart.py
라는 파일을 만듭니다.quickstart.py
에 다음 코드를 붙여넣습니다.url
변수의 값을 웹훅을 등록할 때 복사한 웹훅 URL로 바꿉니다.
Node.js
작업 디렉터리에서
index.js
라는 파일을 만듭니다.index.js
에 다음 코드를 붙여넣습니다.url
변수의 값을 웹훅을 등록할 때 복사한 웹훅 URL로 바꿉니다.
Java
작업 디렉터리에서
pom.xml
라는 파일을 만듭니다.pom.xml
에 다음을 복사하여 붙여넣습니다.작업 디렉터리에 다음과 같은 디렉터리 구조
src/main/java
를 만듭니다.src/main/java
디렉터리에서App.java
라는 파일을 만듭니다.App.java
에 다음 코드를 붙여넣습니다.URL
변수의 값을 웹훅을 등록할 때 복사한 웹훅 URL로 바꿉니다.
Apps Script
브라우저에서 Apps Script로 이동합니다.
새 프로젝트를 클릭합니다.
다음 코드를 붙여넣습니다.
url
변수의 값을 웹훅을 등록할 때 복사한 웹훅 URL로 바꿉니다.
웹훅 스크립트 실행
CLI에서 스크립트를 실행합니다.
Python
python3 quickstart.py
Node.js
node index.js
Java
mvn compile exec:java -Dexec.mainClass=App
Apps Script
- 실행을 클릭합니다.
코드를 실행하면 웹훅은 등록한 공간에 메시지를 전송합니다.
메시지 대화목록 시작 또는 답장
spaces.messages.thread.threadKey
를 메시지 요청 본문의 일부로 지정합니다. 스레드를 시작하는지 또는 스레드에 응답하는지에 따라threadKey
에 다음 값을 사용합니다.스레드를 시작하는 경우
threadKey
를 임의의 문자열로 설정하되 스레드에 답장을 게시하려면 이 값을 기록해 둡니다.스레드에 응답하는 경우 스레드가 시작되었을 때 설정된
threadKey
를 지정합니다. 예를 들어 초기 메시지에서MY-THREAD
을 사용한 대화목록에 답글을 게시하려면MY-THREAD
를 설정합니다.
지정된
threadKey
를 찾을 수 없는 경우 스레드 동작을 정의합니다.대화목록에 답장하거나 새 대화목록을 시작합니다. 웹훅 URL에
messageReplyOption=REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD
매개변수를 추가합니다. 이 URL 매개변수를 전달하면 Chat에서 지정된threadKey
를 사용하여 기존 스레드를 찾습니다. 이벤트가 발견되면 메시지는 해당 대화목록에 답장으로 게시됩니다. 아무것도 찾을 수 없으면 메시지는threadKey
에 상응하는 새 스레드를 시작합니다.대화목록에 답장하거나 아무 작업도 하지 않습니다. 웹훅 URL에
messageReplyOption=REPLY_MESSAGE_OR_FAIL
매개변수를 추가합니다. 이 URL 매개변수를 전달하면 Chat에서 지정된threadKey
를 사용하여 기존 스레드를 찾습니다. 이벤트가 발견되면 메시지는 해당 대화목록에 답장으로 게시됩니다. 아무것도 찾을 수 없으면 메시지가 전송되지 않습니다.
자세한 내용은
messageReplyOption
를 참고하세요.
다음 코드 샘플은 메시지 스레드를 시작하거나 메시지 스레드에 응답합니다.