Intercom HITL

  # Intercom Tích hợp HITL Tích hợp này cho phép Botpress sử dụng Intercom với tư cách là nhà cung cấp HITL (Con người trong vòng lặp). Tin nhắn từ bot sẽ xuất hiện trong Intercom và phản hồi của tác nhân sẽ được gửi lại cho bot. ## Tính năng - Tích hợp liền mạch giữa Botpress Và Intercom
- Đồng bộ hóa tin nhắn theo thời gian thực - Hỗ trợ tin nhắn văn bản - Quản lý phiên trò chuyện tự động - Webhook -xử lý sự kiện dựa trên - Phân công tác nhân và quản lý cuộc trò chuyện ## Cấu hình Tích hợp yêu cầu cấu hình sau: - `accessToken`: Của bạn Intercom Mã thông báo truy cập (cần thiết để xác thực API) ## Intercom Thiết lập ứng dụng cho Botpress Tích hợp Hướng dẫn này hướng dẫn bạn thiết lập và cấu hình Intercom để cho phép tích hợp với Botpress chatbot. ### Hướng dẫn từng bước #### 1. Tạo một Intercom Ứng dụng * Điều hướng đến [https://app. intercom .com/](https://app. intercom .com/) * Đăng nhập vào Intercom tài khoản * Vào **Ứng dụng** trong nhà phát triển hub
* Nhấp vào **"Tạo ứng dụng"** * Nhập tên ứng dụng của bạn (ví dụ: " Botpress Tích hợp HITL") * Nhấp vào **"Tạo ứng dụng"** #### 2. Sao chép Mã truy cập * Trong bảng điều khiển ứng dụng của bạn, hãy đi tới **Xác thực** * Sao chép **Mã truy cập** được hiển thị trong phần Mã truy cập * Trong ** Botpress Intercom cấu hình tích hợp**, dán Mã thông báo truy cập này #### 3. Cấu hình Webhooks ##### a. Sự kiện hội thoại Webhook
* Đi tới **Webhooks** trong bảng điều khiển ứng dụng của bạn * Nhấp vào **"Thêm Webhook "** * Đặt ** Webhook URL** đến ** của bạn Botpress Intercom tích hợp webhook URL** * **Chỉ đăng ký những sự kiện sau:** * `conversation.admin.assigned` * `conversation.admin.closed` * `conversation.admin.replied` * Nhấp vào **"Lưu Webhook "** ### Tóm tắt các yêu cầu Botpress Cấu hình * **Mã thông báo truy cập**: Từ Intercom Xác thực ứng dụng * ** Webhook URL**: Được cung cấp bởi Botpress
## Cách sử dụng 1. Cấu hình tích hợp với Intercom Mã thông báo truy cập 2. Bắt đầu phiên trò chuyện bằng hành động `startHitl` 3. Tin nhắn từ bot sẽ xuất hiện trong Intercom các cuộc trò chuyện 4. Phản hồi của tác nhân trong Intercom sẽ được gửi lại cho bot 5. Trạng thái hội thoại được quản lý tự động giữa Botpress Và Intercom
> **Lưu ý:** Khi bắt đầu phiên HITL, nếu email của người dùng không tồn tại dưới dạng liên hệ trong Intercom , một liên hệ mới sẽ được tự động tạo. Nếu email đã tồn tại, liên hệ hiện tại sẽ được sử dụng cho quy trình HITL. ## Hỗ trợ Để được hỗ trợ, vui lòng liên hệ Botpress nhóm hoặc tham khảo [ Intercom Tài liệu API](https://developers. intercom .com/docs). ## Khắc phục sự cố ### Các vấn đề thường gặp 1. ** Webhook không nhận được sự kiện**: Đảm bảo webhook URL có thể truy cập công khai và được cấu hình đúng cách 2. **Lỗi xác thực**: Xác minh Mã thông báo truy cập của bạn là chính xác và có các quyền cần thiết 3. **Tin nhắn không đồng bộ hóa**: Kiểm tra xem cuộc trò chuyện đã được tạo đúng cách chưa và liên hệ có tồn tại trong Intercom
### Chế độ gỡ lỗi Bật ghi nhật ký gỡ lỗi trong Botpress cấu hình để khắc phục sự cố tích hợp.