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

사용자 상호작용을 수신하고 이에 응답

이 페이지에서는 Google Chat 앱에서 사용자 상호작용에 응답(일명 Google Chat 앱) 상호작용 이벤트를 참조하세요.

Google Chat 앱 상호작용 이벤트는 사용자가 채팅하는 사용자가 채팅 앱을 호출하거나 상호작용하는 방법(예: 채팅 앱을 @멘션하거나 있습니다. 사용자가 채팅 앱과 상호작용할 때 Google Chat은 채팅 앱에 상호작용 이벤트를 전송합니다. 채팅 앱은 이벤트를 사용하여 응답을 작성합니다

예를 들어 채팅 앱은 상호작용 이벤트를 사용하여 있습니다.

상호작용 이벤트의 예	채팅 앱의 일반적인 응답
사용자가 다음과 같은 방법으로 채팅 앱을 호출합니다. @멘션하거나 슬래시 명령어를 사용합니다.	이 채팅 앱이 말하는 내용을 처리하여 만들 수 있습니다. 예를 들어 채팅 앱이 `/about` 명령어를 채팅 앱에서 할 수 있습니다.
사용자가 채팅 앱을 추가할 때 있습니다.	채팅 앱에서 온보딩 메시지를 작성해 주세요. 있습니다.
사용자가 스페이스의 채팅 앱	이 채팅 앱에서 수신 알림을 모두 삭제함 스페이스에 대해 설정된 모든 사용자 (예: webhook의 근간을 설정하고 모든 클러스터에 내부 저장소에 저장합니다
사용자가 광고 서버에서 보낸 카드 또는 대화상자의 버튼을 클릭하면 채팅 앱	채팅 앱은 인코더-디코더 아키텍처를 반환하거나 다른 카드 또는 대화상자를 반환할 수 있습니다.

Google Chat에서는 사용자 상호작용 유형별로 상호작용 이벤트를 추가하여 이벤트 유형을 조정할 수 있습니다. 예를 들어 Google Chat은 ADDED_TO_SPACE: 사용자가 채팅 앱을 스페이스에 추가하여 채팅 앱은 메시지를 보낼 수 있습니다 지원되는 상호작용 이벤트를 모두 보려면 다음을 참고하세요. EventType 참조 문서를 참조하세요.

이 페이지에서는 다음 작업을 수행하는 방법을 설명합니다.

이벤트를 수신하도록 채팅 앱을 구성합니다.
인프라에서 상호작용 이벤트를 처리합니다.
적절한 경우 상호작용 이벤트에 응답합니다.

채팅 앱 상호작용 이벤트 수신

이 섹션에서는 채팅 앱

상호작용 이벤트를 수신하도록 채팅 앱 구성

모든 채팅 앱이 대화형은 아닙니다. 예를 들어 수신 웹훅은 발신 메시지와 사용자에게 응답할 수 없습니다. 대화형 환경을 구축하는 경우 채팅 앱을 사용하는 경우, 채팅 앱 상호작용 수신, 처리, 응답 이벤트를 수신합니다. 채팅 앱 설계에 관한 자세한 내용은 다음을 참고하세요. 채팅 앱 구현 아키텍처

대화형 채팅 앱을 빌드했다면 Google Chat에서 채팅 메시지를 보낼 수 있도록 Google Chat API를 구성해야 합니다 상호작용 이벤트:

Google Cloud 콘솔에서 Google Chat API 페이지를 엽니다.
Google Chat API 페이지로 이동
구성 탭을 클릭합니다.
양방향 기능 섹션에서 양방향 기능 사용 설정 전환 버튼을 클릭하여 On(사용)으로 설정합니다.
기능에서 다음 체크박스 중 하나 또는 둘 다를 선택합니다.
1. 1:1 메시지 수신: 사용자가 채팅 메시지 (DM) 스페이스에서 채팅 앱과 상호작용할 수 있도록 허용합니다. 채팅 앱은 사용자가 DM 스페이스에서 메시지를 보낼 때마다 상호작용 이벤트를 수신합니다.
2. 스페이스 및 그룹 대화 참여: 사용자가 두 명 이상의 사용자가 있는 스페이스에 Chat 앱을 추가하고 삭제할 수 있습니다. 채팅 앱은 스페이스에서 추가되거나 삭제될 때마다, 그리고 사용자가 스페이스에서 @멘션 또는 슬래시 명령어를 사용할 때마다 상호작용 이벤트를 수신합니다.
연결 설정에서 Google Chat이 채팅 앱 상호작용 이벤트를 전송하는 위치를 지정합니다.
선택사항: 슬래시 명령어에서 하나 이상의 슬래시 명령어를 추가하고 구성합니다. 자세한 내용은 슬래시 명령어 설정을 참고하세요.
선택사항: 링크 미리보기에서 채팅 앱이 미리 볼 수 있는 URL 패턴을 하나 이상 추가하고 구성합니다. 자세한 내용은 미리보기 링크를 참고하세요.
저장을 클릭합니다.

이제 채팅 앱이 상호작용을 수신하도록 구성되었습니다. Google Chat의 일정입니다.

서비스에 대한 HTTP 호출 재시도 처리

서비스에 대한 HTTPS 요청이 실패하는 경우 (예: 시간 초과, 임시 네트워크 2xx가 아닌 HTTPS 상태 코드인 경우) Google Chat에서 전송을 다시 시도할 수 있습니다. 몇 분 이내에 몇 회 재생될 수 있습니다 (확실히 보장되지는 않음). 그 결과 채팅 앱이 다음 시간 이후에 동일한 메시지를 특정 상황에서 발생합니다 요청이 성공적으로 완료되었지만 잘못된 Google Chat은 요청을 다시 시도하지 않습니다.

상호작용 이벤트 처리 또는 응답

이 섹션에서는 Google Chat 앱이 어떻게 처리하고 응답할 수 있는지 설명합니다. 상호작용 이벤트입니다.

채팅 앱이 상호작용 이벤트를 수신한 후 Google Chat을 사용하면 다양한 방식으로 응답할 수 있습니다. 대부분의 경우 양방향 채팅 앱이 사용자에게 메시지로 응답합니다. Google Chat 앱이 데이터에서 일부 정보를 조회할 수도 있습니다. 상호작용 이벤트 정보를 기록하거나 다른 모든 것을 기록해야 합니다. 기본적으로 이 처리 동작은 Google Chat 앱

채팅 앱은 각 상호작용 이벤트에 대해 요청 본문을 수신합니다. 이벤트를 나타내는 JSON 페이로드입니다. 이 응답을 처리하는 데 사용됩니다 이벤트 페이로드의 예시는 다음을 참조하세요. 채팅 앱 상호작용 이벤트 유형.

다음 다이어그램은 Google Chat 앱은 일반적으로 다양한 유형의 상호작용 이벤트:

Google Chat 앱이 상호작용 이벤트를 처리하는 방식을 보여주는 아키텍처

실시간 대답

상호작용 이벤트를 통해 채팅 앱이 실시간으로 응답할 수 있습니다. 동기식으로. 동기 응답에서는 인증을 포함합니다.

상호작용 이벤트에 대한 동기 응답을 만들려면 다음을 참고하세요. 가이드:

동기식으로 응답하려면 채팅 앱이 응답해야 합니다. 30초 이내에 게시되어야 하며, 응답은 확인할 수 있습니다. 그러지 않으면 채팅 앱에서 비동기식으로 응답합니다.

비동기식으로 응답

채팅 앱이 30분 후에 상호작용 이벤트에 응답해야 하는 경우가 있습니다. 초에 도달하거나 상호작용 이벤트가 발생한 공간 외부에서 작업을 실행할 수 있습니다. 생성됩니다. 예를 들어 채팅 앱이 사용자에게 응답할 수 있습니다. 이 경우 채팅 앱은 Google Chat API를 호출하여 비동기식으로 응답할 수 있습니다.

Chat API를 사용하여 메시지를 만들려면 다음을 참고하세요. 메시지를 작성합니다. 사용 방법에 대한 가이드는 Chat API 메서드에 대한 자세한 내용은 Chat API 개요