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