Google Chat 스페이스

  # Botpress
Google Chat 통합 Botpress

이 통합을 통해 Botpress 챗봇을 Google Chat 공간과 연결하여 봇과 Google Chat 사용자 간에 원활한 커뮤니케이션을 할 수 있습니다.

## 기능

- Google Chat 스페이스에서 메시지 주고받기
- 자동 메시지 처리 및 응답
- 여러 개의 Google Chat 스페이스 지원
- Google 서비스 계정을 사용한 보안 인증

## 전제 조건

1. Google 클라우드 플랫폼(GCP) 계정
2. 봇을 배포할 Google Chat 공간
3. 구글 Chat 연동이 설치된 Botpress 인스턴스

## 설정 지침

### 1. Google Chat API 활성화

1. 구글 클라우드 콘솔](https://console.cloud.google.com)로 이동합니다.
2. "API 및 서비스" > "라이브러리"로 이동합니다.
3. "Google Chat API"를 검색합니다.
4. Google Chat API를 클릭합니다.
5. "사용"을 클릭하여 프로젝트의 API를 활성화합니다.

### 2. Google 서비스 계정 만들기

1. 구글 클라우드 콘솔](https://console.cloud.google.com)로 이동합니다.
2. 새 프로젝트를 생성하거나 기존 프로젝트를 선택합니다.
3. "IAM & 관리자" > "서비스 계정"으로 이동합니다.
4. "서비스 계정 만들기"를 클릭합니다.
5. 서비스 계정 세부 정보를 입력하고 "만들기"를 클릭합니다.
6. 서비스 계정의 새 키를 생성합니다:
   - 서비스 계정을 클릭합니다.
   - "키" 탭으로 이동합니다.
   - "키 추가" > "새 키 만들기"를 클릭합니다.
   - JSON 형식을 선택합니다.
   - 키 파일을 다운로드합니다.

### 3. Google Chat 앱 설정 구성

1. 구글 클라우드 콘솔](https://console.cloud.google.com)로 이동합니다.
2. "API 및 서비스" > "Google Chat API"로 이동합니다.
3. "구성"을 클릭합니다.
4. 다음 설정으로 앱을 설정합니다:
   - 앱 이름**: 봇의 이름을 선택합니다.
   - 설명**: 봇의 기능에 대한 설명을 추가합니다.
   - 아바타 URL**: 봇의 아바타 이미지 URL을 추가합니다.
   - **기능**:
     - 대화형 기능 사용 설정
     - 1-1 메시지 수신 사용 설정하기
     - 스페이스 및 그룹 대화 참여 활성화
   - HTTP 엔드포인트 URL**: 구글 Chat 연동 구성에 있는 Botpress webhook URL로 설정합니다.

### 4. Botpress
연동 구성하기 Botpress

1. Botpress 인스턴스에서 연동 섹션으로 이동합니다.
2. 구글 Chat 연동 기능을 찾아 선택합니다.
3. 다음 설정을 구성합니다:
   - **서비스 계정 JSON**: 다운로드한 서비스 계정 키 파일의 전체 내용을 붙여넣습니다.
   - 기본 공간**: 기본 Google Chat 스페이스의 ID를 입력합니다(선택 사항).

### 5. Google Chat 공간에 봇 추가하기

1. Google Chat 공간을 엽니다.
2. 스페이스 이름을 클릭하여 스페이스 세부 정보를 엽니다.
3. "앱 및 연동"으로 이동합니다.
4. "앱 추가"를 클릭합니다.
5. 서비스 계정 이메일을 사용하여 봇을 검색합니다.
6. 내 스페이스에 봇을 추가합니다.

## 사용 방법

### 메시지 보내기

봇은 추가된 모든 Google Chat 공간에 메시지를 보낼 수 있습니다. 메시지를 보낼 수 있습니다:
- 사용자 메시지에 대한 응답으로
- Botpress 플로우 에디터를 통해 사전에
- 사용자 지정 코드에서 API 호출을 통해

### 메시지 수신

봇은 Google Chat 공간에서 전송된 메시지를 자동으로 수신하고 처리합니다. 처리합니다:
- 수신 메시지 구문 분석
- Botpress 플로우를 통해 처리
- 적절한 응답을 스페이스로 다시 보내기

### 메시지 형식

이 통합은 Google Chat 스페이스에서 문자 메시지를 지원합니다. 메시지에는 다음이 포함될 수 있습니다:
- 일반 텍스트
- 기본 서식
- 링크
- 멘션

## 보안 고려 사항

- 서비스 계정 키를 안전하게 보관하고 공개적으로 공유하지 마세요.
- 서비스 계정 키를 정기적으로 교체하세요.
- 서비스 계정에 역할을 할당할 때 최소 권한 원칙을 사용하세요.
- 봇의 활동을 모니터링하고 적절한 로깅을 설정하세요.

## 문제 해결

### 일반적인 문제

1. **봇이 응답하지 않음**
   - 서비스 계정에 올바른 권한이 있는지 확인합니다.
   - 봇이 스페이스에 제대로 추가되었는지 확인합니다.
   - Botpress
연동이 올바르게 구성되었는지 확인합니다. Botpress

2. **인증 오류**
   - 서비스 계정 JSON의 형식이 올바른지 확인하세요.
   - 서비스 계정 키가 유효하고 만료되지 않았는지 확인합니다.
   - 서비스 계정에 필요한 API 범위가 활성화되어 있는지 확인합니다.

3. **메시지 전달 문제**
   - 스페이스 ID가 올바른지 확인
   - 봇이 스페이스에 게시할 수 있는 권한이 있는지 확인합니다.
   - 메시지 형식이 유효한지 확인

## API 참조

Google Chat API에 대한 자세한 내용은 [공식 문서](https://developers.google.com/chat/api/reference/rest)를 참조하세요.