구글 Chat 스페이스 통합 | Botpress Hub

# 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
  1. 인증 오류
  • 서비스 계정 JSON의 형식이 올바른지 확인하세요.
  • 서비스 계정 키가 유효하고 만료되지 않았는지 확인합니다.
  • 서비스 계정에 필요한 API 범위가 활성화되어 있는지 확인합니다.
  1. 메시지 전달 문제
  • 스페이스 ID가 올바른지 확인
  • 봇이 스페이스에 게시할 수 있는 권한이 있는지 확인합니다.
  • 메시지 형식이 유효한지 확인

API 참조

Google Chat API에 대한 자세한 내용은 공식 문서를 참조하세요.