# LiveChat HITL 통합 이 통합을 통해 Botpress LiveChat을 HITL(휴먼 인 더 루프) 제공업체로 사용할 수 있습니다. 봇의 메시지가 LiveChat에 표시되고 상담원의 응답이 봇으로 다시 전송됩니다. ## 기능 - Botpress LiveChat 간의 원활한 통합 - 실시간 메시지 동기화 - 문자 메시지 지원 - 자동 채팅 세션 관리 - Webhook 이벤트 처리 ## 구성 연동하려면 다음 구성이 필요합니다: - `clientId`: LiveChat 클라이언트 ID - `조직Id`: LiveChat 조직 ID - `웹훅시크릿`: webhook 인증을 위한 비밀키 ## Botpress 연동을 위한 라이브챗 앱 설정 이 가이드는 Botpress 챗봇과의 연동을 위해 [platform.text.com](https://platform.text.com)을 통해 LiveChat 앱을 만들고 구성하는 방법을 안내합니다. > 📹 **비디오 가이드**: Loom](https://www.loom.com/share/c291c86a10e3496791dd32f6c0b0c64c?sid=84100a6a-b699-4363-89f2-194458c4a8ad)에서 단계별 설정 가이드를 시청하세요. 단계별 지침 ### 단계별 지침 #### 1. 새 앱 만들기 * https://platform.text.com/console/apps](https://platform.text.com/console/apps)로 이동합니다. * "앱 만들기"**를 클릭합니다. * 앱 이름을 입력합니다. * 상품으로 **라이브챗**이 선택되었는지 확인합니다. * "앱 만들기"**를 클릭합니다. #### 2. 앱 인증 블록 추가하기 **블록**으로 이동합니다. **"빌딩 블록 추가"**를 클릭합니다. **앱 권한 부여 → 서버 측 앱**을 선택합니다. **클라이언트 ID**를 복사합니다. Botpress 라이브챗 연동 설정**에 이 클라이언트 ID를 붙여넣습니다. * 다음 범위를 추가합니다: ``` chats.conversation--all:rw ``` **중요:** 이 블록의 **리디렉션 URI** 필드에 Botpress webhook URL**을 추가하세요. #### 3. 조직 ID 추가하기 * https://platform.text.com/console/settings/account]로 이동(https://platform.text.com/console/settings/account) **조직 ID**를 복사합니다. * 이를 Botpress 라이브챗 연동 설정**에 붙여넣습니다. #### 4. 웹훅 구성하기 ##### a. 수신 이벤트 Webhook **블록** 섹션에서 Chat 웹훅** 블록을 추가합니다. Webhook URL**을 Botpress 라이브챗 연동 webhook URL**로 설정합니다. **비밀키를 생성**하고 Botpress 구성에서 동일한 키를 사용합니다. * 다음을 설정합니다: **유형**: '라이선스' **트리거**: `incoming_event` * **필터**: `author_type = 에이전트` **저장**을 클릭합니다. ##### b. Chat 비활성화 Webhook * 다른 Chat 웹훅** 블록을 추가합니다. * 동일한 webhook URL**과 **비밀키**를 사용합니다. * 설정합니다: **트리거**: '채팅_비활성화' * **유형**: `라이센스` **저장** 클릭 ##### c. Chat 전송 Webhook Chat 웹훅** 블록을 하나 더 추가합니다. * 동일한 webhook URL**과 **비밀키**를 사용합니다. * 설정합니다: **트리거**: '채팅_전송' * **유형**: `라이센스` **저장** 클릭 #### 5. 앱 설정 완료 ##### a. 아이콘 추가 ** 리스팅 세부 정보** 섹션으로 이동합니다. * 앱의 **임의 아이콘**을 업로드합니다(모든 이미지 사용 가능). ##### b. 앱 설치 **비공개 설치** 탭으로 이동합니다. **"앱 설치"**를 클릭합니다. ### 필수 Botpress 설정 요약 **클라이언트 ID**: 앱 인증 블록에서 **조직 ID**: 계정 설정에서 **비밀 키**: webhook 설정에서 Webhook URL**: Botpress 제공 * **범위**: `chats.conversation--all:rw` **리디렉션 URI**: 앱 인증 블록에 Botpress webhook URL을 포함해야 합니다. ## 사용법 1. LiveChat 자격 증명과의 통합을 구성합니다. 2. 'startHitl` 액션을 사용하여 채팅 세션 시작하기 3. 봇의 메시지가 LiveChat에 나타납니다. 4. LiveChat의 상담원 응답이 봇으로 다시 전송됩니다. ## 이벤트 연동 서비스는 다음과 같은 LiveChat 이벤트를 처리합니다: - 수신_이벤트`: 상담원의 새 메시지 - 채팅이 비활성화됨`: Chat 세션 종료 - 채팅 전송됨`: Chat 다른 상담원에게 전달되었습니다. ## 보안 - 비밀 키를 사용한 Webhook 인증 - API 호출을 위한 OAuth2 인증 - 안전한 토큰 관리 ## 지원 지원 문의는 Botpress 팀에 문의하거나 [LiveChat API 문서](https://developers.livechat.com/docs/)를 참조하세요.
