채팅 앱을 다른 서비스 및 도구와 연결하기

이 페이지에서는 Google Chat 앱을 Google Chat 외부의 서비스 또는 도구와 연결하는 방법을 설명합니다. 채팅 앱은 그 자체로 강력하지만 다른 시스템과 함께 작동하는 경우가 많으며 계정을 연결하거나 데이터 액세스를 승인하거나 추가 데이터를 표시하거나 사용자 환경설정을 구성하기 위해 호환 애플리케이션이 필요합니다.

사용자에게 채팅 앱 구성 요청

요청을 완료하기 위해 채팅 앱에서 직접 완료할 수 없는 추가 구성이 필요한 경우 일반 응답의 일부로 구성 URL을 사용자에게 반환하거나 다음 형식으로 비공개로 제시합니다.

{
  "actionResponse": {
    "type": "REQUEST_CONFIG",
    "url": "CONFIGURATION_URL"
  }
}

이렇게 하면 Google Chat에서 사용자에게 비공개 메시지를 표시하도록 지시합니다. 여기서 CONFIGURATION_URL는 사용자가 추가 인증, 승인 또는 구성을 위해 방문할 수 있는 링크입니다. REQUEST_CONFIG 응답은 일반 응답 메시지와 상호 배타적입니다. 텍스트, 카드 또는 기타 속성은 모두 무시됩니다.

구성 요청 완료

채팅 앱이 수신하는 모든 MESSAGE 상호작용 이벤트에는 configCompleteRedirectUrl 매개변수도 포함됩니다. 이 URL은 프로세스 완료 시 사용할 수 있도록 구성 URL에 인코딩되어야 합니다. 이 URL로 리디렉션하면 구성 요청이 처리되었음을 Google Chat에 알립니다.

채팅 앱이 시작되면 수신된 특정 메시지에 따라 흐름이 달라집니다. 채팅 앱은 @app help와 같은 메시지에 대한 응답으로 추가 구성을 요구하지 않고 메시지로 응답해야 합니다.

사용자가 원본 메시지에 제공된 configCompleteRedirectUrl로 성공적으로 리디렉션되면 Google Chat은 다음 단계를 수행합니다.

  1. 시작하는 사용자에게 표시되었던 메시지를 지웁니다.
  2. 원본 메시지를 공개로 변환하여 스페이스의 다른 구성원에게 표시합니다.
  3. 원래 메시지를 동일한 채팅 앱에 두 번째로 보냅니다.

configCompleteRedirectUrl 방문은 단일 사용자 메시지에만 영향을 미칩니다. 사용자가 채팅 앱에 여러 번 메시지를 보내려고 하여 메시지가 여러 번 수신된 경우, 특정 메시지를 클릭하고 인증 및 구성 프로세스를 완료하면 해당 메시지에만 영향을 미칩니다. 다른 메시지는 변경되지 않습니다.

MESSAGE 상호작용 이벤트가 이러한 방식으로 재전송되는 경우 원래 이벤트와 동일해야 합니다. 그러나 MESSAGE 상호작용 이벤트가 다를 수 있는 몇 가지 상황이 있습니다. 예를 들어 메시지에 채팅 앱 A와 채팅 앱 B가 모두 언급된 경우, 채팅 앱 A가 채팅 앱 B로 인증하기 전에 일반 메시지로 응답하는 경우 사용자는 메시지를 수정할 수 있습니다. 이 경우 채팅 앱 B는 사용자가 인증과 구성을 완료하면 수정된 메시지 텍스트를 수신합니다.

Chat 외부에서 Chat 사용자 인증하기

API의 OAuth 승인 요청과 같은 일부 경우에는 앱에서 사용자 ID를 유지하면서 Chat 외부의 URL에 연결해야 합니다. 이 경우 사용자를 식별하는 가장 좋은 방법은 Google 로그인으로 대상 앱을 보호하는 것입니다.

로그인 중에 발급된 ID 토큰을 사용하여 사용자 ID를 가져옵니다. sub 클레임에는 사용자의 고유 ID가 포함되며 Google Chat의 사용자 ID와 연결될 수 있습니다.

두 ID가 정확히 일치하지는 않지만 강제 변환될 수 있습니다. sub 클레임의 값을 Google Chat users/{user}로 강제 변환하려면 값 앞에 users/를 붙입니다. 예를 들어 123의 클레임 값은 Chat 앱에 보내는 메시지에서 사용자 이름 users/123와 동일합니다.

  • MyProfile 앱 예시는 Google 로그인 응답의 ID 토큰을 사용하여 사용자를 식별합니다.