이 페이지에서는 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 페이지를 엽니다.
- 구성 탭을 클릭합니다.
- 양방향 기능 섹션에서 양방향 기능 사용 설정 전환 버튼을 클릭하여 On(사용)으로 설정합니다.
- 기능에서 다음 체크박스 중 하나 또는 둘 다를 선택합니다.
- 1:1 메시지 수신: 사용자가 채팅 메시지 (DM) 스페이스에서 채팅 앱과 상호작용할 수 있도록 허용합니다. 채팅 앱은 사용자가 DM 스페이스에서 메시지를 보낼 때마다 상호작용 이벤트를 수신합니다.
- 스페이스 및 그룹 대화 참여: 사용자가 두 명 이상의 사용자가 있는 스페이스에 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 앱은 일반적으로 다양한 유형의 상호작용 이벤트:
실시간 대답
상호작용 이벤트를 통해 채팅 앱이 실시간으로 응답할 수 있습니다. 동기식으로. 동기 응답에서는 인증을 포함합니다.
상호작용 이벤트에 대한 동기 응답을 만들려면 다음을 참고하세요. 가이드:
동기식으로 응답하려면 채팅 앱이 응답해야 합니다. 30초 이내에 게시되어야 하며, 응답은 확인할 수 있습니다. 그러지 않으면 채팅 앱에서 비동기식으로 응답합니다.
비동기식으로 응답
채팅 앱이 30분 후에 상호작용 이벤트에 응답해야 하는 경우가 있습니다. 초에 도달하거나 상호작용 이벤트가 발생한 공간 외부에서 작업을 실행할 수 있습니다. 생성됩니다. 예를 들어 채팅 앱이 사용자에게 응답할 수 있습니다. 이 경우 채팅 앱은 Google Chat API를 호출하여 비동기식으로 응답할 수 있습니다.
Chat API를 사용하여 메시지를 만들려면 다음을 참고하세요. 메시지를 작성합니다. 사용 방법에 대한 가이드는 Chat API 메서드에 대한 자세한 내용은 Chat API 개요
관련 주제
- 메시지 보내기
- 대화형 대화상자 열기
- 미리보기 링크
- 사용자가 카드에서 입력한 양식 데이터 읽기
- 슬래시 명령어에 응답
- 채팅 앱의 홈페이지 구축하기
- Chat에서 요청 확인하기
- Google Chat 앱의 양방향 기능 테스트하기