Intercom HITL

  # Intercom HITL 통합

이 통합을 통해 Botpress  Intercom HITL(휴먼 인 더 루프) 제공업체로 사용할 수 있습니다. 봇의 메시지가 Intercom 표시되고 상담원의 응답이 봇으로 다시 전송됩니다.

## 기능

- Botpress  Intercom
 간의 원활한 통합
- 실시간 메시지 동기화
- 문자 메시지 지원
- 자동 대화 세션 관리
- Webhook 이벤트 처리
- 상담원 배정 및 대화 관리

## 구성

연동하려면 다음과 같은 구성이 필요합니다:

- 액세스 토큰`: Intercom 액세스 토큰(API 인증에 필요)

## Botpress 연동을 위한 Intercom 앱 설정

이 가이드는 Botpress 챗봇과 연동하기 위한 Intercom 설정 및 구성 방법을 안내합니다.

단계별 지침 ### 단계별 지침

#### 1. Intercom 앱 만들기

*intercomintercom로 이동합니다.
* Intercom 계정에 로그인합니다.
* 개발자 hub
**앱**으로 이동합니다.
**"앱 만들기"**를 클릭합니다.
* 앱 이름을 입력합니다(예:Botpress HITL Integration").
* "앱 만들기"**를 클릭합니다.

#### 2. 액세스 토큰 복사

* 앱 대시보드에서 **인증**으로 이동합니다.
* 액세스 토큰 섹션에 표시된 **액세스 토큰**을 복사합니다.
* Botpress Intercom 연동 설정**에 이 액세스 토큰을 붙여넣습니다.

#### 3. 웹훅 구성하기

##### a. 대화 이벤트 Webhook

* 앱 대시보드에서 **웹훅**으로 이동합니다.
**" Webhook 추가"**를 클릭합니다.
Webhook URL**을 Botpress Intercom 연동 webhook URL**로 설정합니다.
**이 이벤트만 구독하세요**.
  * `conversation.admin.assigned`
  * `conversation.admin.closed`
  * `대화.admin.replied`
**" Webhook 저장"**을 클릭합니다.

### 필수 Botpress 설정 요약

* **액세스 토큰**: Intercom 앱 인증에서
Webhook URL**: Botpress
제공 Botpress

## 사용법

1. Intercom 액세스 토큰과의 통합을 구성합니다.
2. 'startHitl' 액션을 사용하여 대화 세션을 시작합니다.
3. 봇의 메시지가 Intercom 대화에 나타납니다.
4. Intercom 상담원 응답이 봇으로 다시 전송됩니다.
5. Botpress  Intercom
간의 대화 상태가 자동으로 관리됩니다. Intercom

> **주:** HITL 세션 시작 시 사용자의 이메일이 Intercom 연락처로 존재하지 않으면 자동으로 새 연락처가 생성됩니다. 이메일이 이미 존재하는 경우 기존 연락처가 HITL 프로세스에 사용됩니다.

## 지원

지원 문의는 Botpress 팀에 문의하거나Intercom API 문서]intercom 참조하세요.

## 문제 해결

### 일반적인 문제

1. **Webhook 이벤트를 수신하지 못함**: webhook URL이 공개적으로 액세스할 수 있고 올바르게 구성되었는지 확인하세요.
2. **인증 오류**: 액세스 토큰이 올바른지, 필요한 권한이 있는지 확인합니다.
3. **메시지가 동기화되지 않음**: 대화가 제대로 생성되었는지, 연락처가 Intercom
존재하는지 확인합니다. Intercom

### 디버그 모드

 Botpress 구성에서 디버그 로깅을 활성화하여 연동 문제를 해결하세요.