Google Chat พื้นที่

  # Google Chat การบูรณาการสำหรับ Botpress
การบูรณาการนี้ช่วยให้คุณเชื่อมต่อ Botpress แชทบอทกับ Google Chat พื้นที่ที่ช่วยให้การสื่อสารระหว่างบอทของคุณและ Google ราบรื่น Chat ผู้ใช้ ## คุณสมบัติ - ส่งและรับข้อความใน Google Chat ช่องว่าง - การจัดการข้อความอัตโนมัติและการตอบกลับ - รองรับ Google หลายรายการ Chat พื้นที่ - การตรวจสอบสิทธิ์ที่ปลอดภัยโดยใช้บัญชีบริการ Google ## ข้อกำหนดเบื้องต้น 1. บัญชี Google Cloud Platform (GCP) 2. บัญชี Google Chat พื้นที่ที่คุณต้องการวางบอทของคุณ 3. Botpress อินสแตนซ์กับ Google Chat การติดตั้งการรวม ## คำแนะนำการตั้งค่า ### 1. เปิดใช้งาน Google Chat API 1. ไปที่ [Google Cloud Console](https://console.cloud.google.com) 2. ไปที่ "API & Services" > "Library" 3. ค้นหา "Google Chat API" 4. คลิกที่ Google Chat API 5. คลิก "เปิดใช้งาน" เพื่อเปิดใช้งาน API สำหรับโปรเจ็กต์ของคุณ ### 2. สร้างบัญชีบริการ Google 1. ไปที่ [Google Cloud Console](https://console.cloud.google.com) 2. สร้างโปรเจ็กต์ใหม่หรือเลือกโปรเจ็กต์ที่มีอยู่ 3. ไปที่ "IAM & Admin" > "บัญชีบริการ" 4. คลิก "สร้างบัญชีบริการ" 5. กรอกรายละเอียดบัญชีบริการแล้วคลิก "สร้าง" 6. สร้างคีย์ใหม่สำหรับบัญชีบริการ: - คลิกที่บัญชีบริการ - ไปที่แท็บ "คีย์" - คลิก "เพิ่มคีย์" > "สร้างคีย์ใหม่" - เลือกรูปแบบ JSON - ดาวน์โหลดไฟล์คีย์ ### 3. กำหนดค่า Google Chat การตั้งค่าแอป 1. ไปที่ [Google Cloud Console](https://console.cloud.google.com) 2. ไปที่ "API และบริการ" > "Google Chat API" 3. คลิกที่ "การกำหนดค่า" 4. ตั้งค่าแอปของคุณด้วยการตั้งค่าต่อไปนี้: - **ชื่อแอป**: เลือกชื่อสำหรับบอทของคุณ - **คำอธิบาย**: เพิ่มคำอธิบายเกี่ยวกับฟังก์ชันการทำงานของบอทของคุณ - **URL อวาตาร์**: เพิ่ม URL สำหรับภาพอวาตาร์ของบอทของคุณ - **คุณสมบัติ**: - เปิดใช้งานคุณสมบัติแบบโต้ตอบ - เปิดใช้งานการรับข้อความ 1-1 - เปิดใช้งานการเข้าร่วมพื้นที่และการสนทนาแบบกลุ่ม - **URL ปลายทาง HTTP**: ตั้งค่านี้ให้กับคุณ Botpress webhook พบ URL ใน Google Chat การกำหนดค่าการรวม ### 4. กำหนดค่าการรวมใน Botpress
1. ในตัวคุณ Botpress ตัวอย่างเช่น ไปที่ส่วนการรวม 2. ค้นหาและเลือก Google Chat การรวม 3. กำหนดค่าการตั้งค่าต่อไปนี้: - **JSON บัญชีบริการ**: วางเนื้อหาทั้งหมดของไฟล์คีย์บัญชีบริการที่คุณดาวน์โหลด - **ช่องว่างเริ่มต้น**: ป้อน ID ของ Google เริ่มต้นของคุณ Chat ช่องว่าง (ไม่บังคับ) ### 5. เพิ่มบอทลงใน Google ของคุณ Chat Space 1. เปิด Google ของคุณ Chat พื้นที่ 2. คลิกชื่อพื้นที่เพื่อเปิดรายละเอียดพื้นที่ 3. ไปที่ "แอปและการผสานรวม" 4. คลิก "เพิ่มแอป" 5. ค้นหาบอทของคุณโดยใช้อีเมลบัญชีบริการ 6. เพิ่มบอทลงในพื้นที่ของคุณ ## การใช้งาน ### การส่งข้อความ บอทสามารถส่งข้อความไปยัง Google Chat พื้นที่ที่ถูกเพิ่มเข้าไปแล้ว สามารถส่งข้อความได้ดังนี้: - ตอบกลับข้อความของผู้ใช้ - เชิงรุกผ่าน Botpress ตัวแก้ไขโฟลว์ - ผ่านการเรียก API จากโค้ดที่กำหนดเองของคุณ ### การรับข้อความ บอทจะรับและประมวลผลข้อความที่ส่งใน Google โดยอัตโนมัติ Chat พื้นที่ มันจะ: - วิเคราะห์ข้อความขาเข้า - ประมวลผลผ่านของคุณ Botpress กระแสข้อมูล - ส่งการตอบสนองที่เหมาะสมกลับไปยังพื้นที่ ### รูปแบบข้อความ การผสานรวมรองรับข้อความใน Google Chat ช่องว่าง ข้อความอาจรวมถึง: - ข้อความธรรมดา - การจัดรูปแบบพื้นฐาน - ลิงก์ - การกล่าวถึง ## ข้อควรพิจารณาด้านความปลอดภัย - รักษาคีย์บัญชีบริการของคุณให้ปลอดภัยและอย่าแชร์ให้ผู้อื่นทราบ - หมุนเวียนคีย์บัญชีบริการของคุณเป็นประจำ - ใช้หลักการสิทธิ์ขั้นต่ำเมื่อกำหนดบทบาทให้กับบัญชีบริการของคุณ - ตรวจสอบกิจกรรมของบ็อตของคุณและตั้งค่าการบันทึกที่เหมาะสม ## การแก้ไขปัญหา ### ปัญหาทั่วไป 1. **บ็อตไม่ตอบสนอง** - ตรวจสอบว่าบัญชีบริการมีสิทธิ์ที่ถูกต้อง - ตรวจสอบว่าบ็อตถูกเพิ่มเข้าในพื้นที่อย่างถูกต้องหรือไม่ - ตรวจสอบให้แน่ใจว่าการรวมระบบได้รับการกำหนดค่าอย่างถูกต้องใน Botpress
2. **ข้อผิดพลาดในการรับรองความถูกต้อง** - ตรวจสอบว่า JSON ของบัญชีบริการมีรูปแบบที่ถูกต้อง - ตรวจสอบว่าคีย์บัญชีบริการถูกต้องและไม่หมดอายุ - ตรวจสอบให้แน่ใจว่าบัญชีบริการได้เปิดใช้งานขอบเขต API ที่จำเป็น 3. **ปัญหาในการส่งข้อความ** - ตรวจสอบว่า ID พื้นที่ถูกต้อง - ตรวจสอบว่าบอทได้รับอนุญาตให้โพสต์ในพื้นที่หรือไม่ - ตรวจสอบให้แน่ใจว่ารูปแบบข้อความถูกต้อง ## อ้างอิง API สำหรับรายละเอียดเพิ่มเติมเกี่ยวกับ Google Chat API โปรดดูที่[เอกสารอย่างเป็นทางการ](https://developers.google.com/chat/api/reference/rest)