- Intercom การรวม HITL การรวมนี้ช่วยให้ Botpress ที่จะใช้ Intercom ในฐานะผู้ให้บริการ HITL (Human in the Loop) ข้อความจากบอทจะปรากฏใน Intercom และคำตอบของตัวแทนจะถูกส่งกลับไปยังบอท ## คุณสมบัติ - การผสานรวมที่ราบรื่นระหว่าง Botpress และ Intercom - การซิงโครไนซ์ข้อความแบบเรียลไทม์ - รองรับข้อความตัวอักษร - การจัดการเซสชันการสนทนาอัตโนมัติ - Webhook การจัดการเหตุการณ์ตาม - การกำหนดตัวแทนและการจัดการการสนทนา ## การกำหนดค่า การรวมต้องมีการกำหนดค่าต่อไปนี้: - `accessToken`: ของคุณ Intercom โทเค็นการเข้าถึง (จำเป็นสำหรับการตรวจสอบสิทธิ์ API) ## Intercom การตั้งค่าแอปสำหรับ Botpress การบูรณาการ คู่มือนี้จะแนะนำคุณเกี่ยวกับการตั้งค่าและการกำหนดค่าของ Intercom เพื่อเปิดใช้งานการบูรณาการกับของคุณ Botpress แชทบอท ### คำแนะนำทีละขั้นตอน #### 1. สร้าง Intercom แอป * ไปที่ [https://app. intercom .com/](https://app. intercom .com/) * ลงชื่อเข้าใช้ของคุณ Intercom บัญชี * ไปที่ **แอป** ในนักพัฒนา hub * คลิก **"สร้างแอป"** * ป้อนชื่อแอปของคุณ (เช่น " Botpress การรวม HITL) * คลิก **สร้างแอป"** #### 2. คัดลอกโทเค็นการเข้าถึง * ในแดชบอร์ดแอปของคุณ ไปที่ **การรับรองความถูกต้อง** * คัดลอก **โทเค็นการเข้าถึง** ที่แสดงในส่วนโทเค็นการเข้าถึง * ใน ** Botpress Intercom การกำหนดค่าการรวม** วางโทเค็นการเข้าถึงนี้ #### 3. กำหนดค่า Webhooks ##### ก. เหตุการณ์การสนทนา Webhook * ไปที่ **Webhooks** ในแดชบอร์ดแอปของคุณ * คลิก **"เพิ่ม" Webhook "** * ตั้งค่า ** Webhook URL** ไปยัง** ของคุณ Botpress Intercom การบูรณาการ webhook URL** * **สมัครรับเฉพาะกิจกรรมเหล่านี้:** * `conversation.admin.assigned` * `conversation.admin.closed` * `conversation.admin.replied` * คลิก **"บันทึก Webhook "** ### สรุปความต้องการ Botpress กำหนดค่า * **โทเค็นการเข้าถึง**: จาก Intercom การตรวจสอบสิทธิ์แอป * ** Webhook URL**: จัดทำโดย Botpress ## การใช้งาน 1. กำหนดค่าการบูรณาการกับของคุณ Intercom โทเค็นการเข้าถึง 2. เริ่มเซสชันการสนทนาโดยใช้การดำเนินการ `startHitl` 3. ข้อความจากบอทจะปรากฏใน Intercom บทสนทนา 4. การตอบสนองของตัวแทนใน Intercom จะถูกส่งกลับไปที่บอท 5. สถานะการสนทนาจะถูกจัดการโดยอัตโนมัติระหว่าง Botpress และ Intercom > **หมายเหตุ:** เมื่อเริ่มเซสชัน HITL หากอีเมลของผู้ใช้ไม่มีอยู่ในรายชื่อติดต่อใน Intercom ระบบจะสร้างรายชื่อติดต่อใหม่โดยอัตโนมัติ หากมีอีเมลอยู่แล้ว รายชื่อติดต่อที่มีอยู่จะถูกใช้สำหรับกระบวนการ HITL ## ฝ่ายสนับสนุน หากต้องการความช่วยเหลือ โปรดติดต่อ Botpress ทีมหรืออ้างอิงถึง [ Intercom เอกสารประกอบ API](https://developers. intercom .com/docs) ## การแก้ไขปัญหา ### ปัญหาทั่วไป 1. ** Webhook ไม่ได้รับเหตุการณ์**: ให้แน่ใจว่าคุณ webhook URL สามารถเข้าถึงได้สาธารณะและมีการกำหนดค่าอย่างถูกต้อง 2. **ข้อผิดพลาดในการรับรองความถูกต้อง**: ตรวจสอบว่าโทเค็นการเข้าถึงของคุณถูกต้องและมีสิทธิ์ที่จำเป็น 3. **ข้อความไม่ซิงค์**: ตรวจสอบว่าการสนทนาถูกสร้างขึ้นอย่างถูกต้องและมีผู้ติดต่ออยู่ใน Intercom ### โหมดดีบัก เปิดใช้งานการบันทึกการดีบักในของคุณ Botpress การกำหนดค่าเพื่อแก้ไขปัญหาการรวมระบบ