# Botpress HITL 통합
이 통합을 통해 Botpress 봇을 Brevo의 대화 플랫폼과 연결하여 HITL(Human-in-the-Loop) 설정을 활성화할 수 있습니다. 즉, Botpress 봇이 초기 사용자 상호작용을 처리하고 필요한 경우 Brevo의 인간 상담원에게 원활하게 대화를 에스컬레이션할 수 있습니다.
## 작동 방식
사용자가 Botpress 봇과 상호 작용하면 대화가 Brevo의 인간 상담원에게 전달될 수 있습니다. 그러면 상담원이 대화를 이어받아 개인화된 지원을 제공할 수 있습니다. Botpress 사용자의 메시지는 Brevo 상담원에게 전달되며, 그 반대의 경우도 마찬가지입니다.
## 주요 제한 사항
이 연동 서비스를 사용할 때 다음 제한 사항에 유의하세요:
- **메시지 속성:** Botpress 사용자가 Brevo 상담원에게 보내는 메시지는 연동으로 구성된 Brevo 상담원 계정에서 보내는 것처럼 표시됩니다. 그러나 이러한 메시지를 구분하기 위해 메시지 앞에Botpress 사용자:"가 추가됩니다. 예: Botpress 사용자: 안녕하세요, 주문에 대한 도움이 필요합니다.`
- 상태 업데이트:** Botpress 사용자는 상담원 배정 관련 알림이나 상태 업데이트를 자동으로 받지 않습니다(예: "상담원 John이 채팅에 참여했습니다").
## 설정 가이드
Botpress HITL 연동을 구성하려면 다음이 필요합니다:
1. **Brevo API 키:**
- 공식 도움말 페이지의 지침에 따라 Brevo API 키를 생성하고 관리할 수 있습니다: [API 키 생성 및 관리](https://help.brevo.com/hc/en-us/articles/209467485-Create-and-manage-your-API-keys)
2. **IP 차단 비활성화:**
- Botpress 브레보 간의 원활한 통신을 위해서는 브레보 계정에서 IP 차단을 비활성화해야 합니다.
- Brevo IP 인증](https://app.brevo.com/security/authorised_ips)으로 이동하여 Botpress 환경의 요청을 허용하기 위해 IP 차단이 비활성화되어 있는지 확인합니다.
3. **Brevo 에이전트 ID:**
- 연동에서 메시지를 주고받는 데 사용할 Brevo 에이전트 계정을 지정해야 합니다.
- Brevo 에이전트 설정 페이지로 이동합니다: [Brevo 상담원 설정](https://conversations-app.brevo.com/settings/agents)
- 연동에서 사용하려는 상담원을 식별하고 해당 상담원 ID를 복사합니다.
## Webhook 설정(필수)
Botpress 연동에서 Brevo로부터 이벤트를 수신하려면, Brevo에서 webhook 설정해야 합니다:
1. Brevo 대시보드에서 **연동 > 웹훅**으로 이동합니다([직접 링크](https://conversations-app.brevo.com/settings/integrations/webhooks)).
2. 새 webhook 클릭합니다(또는 기존 웹후크 편집).
3. URL** 필드에 Botpress Brevo 연동 webhook 엔드포인트를 입력합니다. 예시:
```
https://webhook.botpress.cloud/ff43meb9-a102-4201-b045-fc498dc1f52b
```
4. 이벤트 유형**에서
- `대화 시작`
- `대화내용`
- `대화 조각`
5. 저장**을 클릭하여 webhook 활성화합니다.
> **주:** URL이 Botpress 연동 엔드포인트와 일치하는지, 모든 필수 이벤트 유형이 전체 기능에 대해 선택되어 있는지 확인하세요.
이 설정이 완료되면 Botpress 연동 서비스가 Brevo로부터 실시간 이벤트를 수신하고 그에 따라 처리할 수 있습니다.
이러한 세부 정보를 확보한 후에는 연동 서비스의 특정 설정 지침에 따라 Botpress 환경 내에서 연동 서비스 구성을 진행할 수 있습니다.
