# Botpress Google Chat 통합 Botpress
이 통합을 통해 Botpress 챗봇을 Google Chat 공간과 연결하여 봇과 Google Chat 사용자 간에 원활한 커뮤니케이션을 할 수 있습니다.
기능
- Google Chat 스페이스에서 메시지 주고받기
- 자동 메시지 처리 및 응답
- 여러 개의 Google Chat 스페이스 지원
- Google 서비스 계정을 사용한 보안 인증
전제 조건
- Google 클라우드 플랫폼(GCP) 계정
- 봇을 배포할 Google Chat 공간
- 구글 Chat 연동이 설치된 Botpress 인스턴스
설정 지침
1. Google Chat API 활성화
- 구글 클라우드 콘솔](https://console.cloud.google.com)로 이동합니다.
- "API 및 서비스" > "라이브러리"로 이동합니다.
- "Google Chat API"를 검색합니다.
- Google Chat API를 클릭합니다.
- "사용"을 클릭하여 프로젝트의 API를 활성화합니다.
2. Google 서비스 계정 만들기
- 구글 클라우드 콘솔](https://console.cloud.google.com)로 이동합니다.
- 새 프로젝트를 생성하거나 기존 프로젝트를 선택합니다.
- "IAM & 관리자" > "서비스 계정"으로 이동합니다.
- "서비스 계정 만들기"를 클릭합니다.
- 서비스 계정 세부 정보를 입력하고 "만들기"를 클릭합니다.
- 서비스 계정의 새 키를 생성합니다:
- 서비스 계정을 클릭합니다.
- "키" 탭으로 이동합니다.
- "키 추가" > "새 키 만들기"를 클릭합니다.
- JSON 형식을 선택합니다.
- 키 파일을 다운로드합니다.
3. Google Chat 앱 설정 구성
- 구글 클라우드 콘솔](https://console.cloud.google.com)로 이동합니다.
- "API 및 서비스" > "Google Chat API"로 이동합니다.
- "구성"을 클릭합니다.
- 다음 설정으로 앱을 설정합니다:
- 앱 이름**: 봇의 이름을 선택합니다.
- 설명**: 봇의 기능에 대한 설명을 추가합니다.
- 아바타 URL**: 봇의 아바타 이미지 URL을 추가합니다.
- 기능:
- 대화형 기능 사용 설정
- 1-1 메시지 수신 사용 설정하기
- 스페이스 및 그룹 대화 참여 활성화
- HTTP 엔드포인트 URL**: 구글 Chat 연동 구성에 있는 Botpress webhook URL로 설정합니다.
4. Botpress
연동 구성하기 Botpress
- Botpress 인스턴스에서 연동 섹션으로 이동합니다.
- 구글 Chat 연동 기능을 찾아 선택합니다.
- 다음 설정을 구성합니다:
- 서비스 계정 JSON: 다운로드한 서비스 계정 키 파일의 전체 내용을 붙여넣습니다.
- 기본 공간**: 기본 Google Chat 스페이스의 ID를 입력합니다(선택 사항).
5. Google Chat 공간에 봇 추가하기
- Google Chat 공간을 엽니다.
- 스페이스 이름을 클릭하여 스페이스 세부 정보를 엽니다.
- "앱 및 연동"으로 이동합니다.
- "앱 추가"를 클릭합니다.
- 서비스 계정 이메일을 사용하여 봇을 검색합니다.
- 내 스페이스에 봇을 추가합니다.
사용 방법
메시지 보내기
봇은 추가된 모든 Google Chat 공간에 메시지를 보낼 수 있습니다. 메시지를 보낼 수 있습니다:
- 사용자 메시지에 대한 응답으로
- Botpress 플로우 에디터를 통해 사전에
- 사용자 지정 코드에서 API 호출을 통해
메시지 수신
봇은 Google Chat 공간에서 전송된 메시지를 자동으로 수신하고 처리합니다. 처리합니다:
- 수신 메시지 구문 분석
- Botpress 플로우를 통해 처리
- 적절한 응답을 스페이스로 다시 보내기
메시지 형식
이 통합은 Google Chat 스페이스에서 문자 메시지를 지원합니다. 메시지에는 다음이 포함될 수 있습니다:
- 일반 텍스트
- 기본 서식
- 링크
- 멘션
보안 고려 사항
- 서비스 계정 키를 안전하게 보관하고 공개적으로 공유하지 마세요.
- 서비스 계정 키를 정기적으로 교체하세요.
- 서비스 계정에 역할을 할당할 때 최소 권한 원칙을 사용하세요.
- 봇의 활동을 모니터링하고 적절한 로깅을 설정하세요.
문제 해결
일반적인 문제
- 봇이 응답하지 않음
- 서비스 계정에 올바른 권한이 있는지 확인합니다.
- 봇이 스페이스에 제대로 추가되었는지 확인합니다.
- Botpress 연동이 올바르게 구성되었는지 확인합니다. Botpress
- 인증 오류
- 서비스 계정 JSON의 형식이 올바른지 확인하세요.
- 서비스 계정 키가 유효하고 만료되지 않았는지 확인합니다.
- 서비스 계정에 필요한 API 범위가 활성화되어 있는지 확인합니다.
- 메시지 전달 문제
- 스페이스 ID가 올바른지 확인
- 봇이 스페이스에 게시할 수 있는 권한이 있는지 확인합니다.
- 메시지 형식이 유효한지 확인
API 참조
Google Chat API에 대한 자세한 내용은 공식 문서를 참조하세요.