แก้ปัญหาและแก้ไขข้อผิดพลาดของแอป Google Chat

ส่วนนี้จะอธิบายปัญหาที่พบได้ทั่วไปขณะสร้างและทดสอบแอป Chat

ข้อความในการ์ด กล่องโต้ตอบ หรือการแสดงตัวอย่างลิงก์ไม่แสดงผลหรือทํางานตามที่คาดไว้

หากต้องการความช่วยเหลือในการแก้ปัญหาข้อผิดพลาดของการ์ด โปรดดูหัวข้อแก้ปัญหาและแก้ไขการ์ด

แอปไม่ตอบสนอง

หากคุณส่งข้อความถึงแอป Chat แล้วแอปตอบกลับว่า "แอปไม่ตอบสนอง" ยืนยันการกำหนดค่าของแอป Chat ดังนี้

  1. ในคอนโซล Google Cloud ให้คลิกเมนู > ผลิตภัณฑ์อื่นๆ > Google Workspace > คลังผลิตภัณฑ์ > Google Chat API > จัดการ > การกำหนดค่า

    ไปที่ Chat API

  2. ในส่วนสถานะแอป ให้ตรวจสอบว่าคุณเลือกเผยแพร่ - พร้อมใช้งานสำหรับผู้ใช้

  3. ในส่วนฟีเจอร์แบบอินเทอร์แอกทีฟ ให้ตรวจสอบว่าการตั้งค่าเหมาะสมกับฟังก์ชันการทำงานของแอป หากแอป Chat ของคุณโต้ตอบกับผู้ใช้ คุณจะต้องเปิดตัวเลือกเปิดใช้ฟีเจอร์แบบอินเทอร์แอกทีฟ แล้วทำดังนี้

    1. หากแอปตอบกลับข้อความ ให้เลือกรับข้อความแบบ 1:1
    2. ในส่วนการตั้งค่าการเชื่อมต่อ ให้ตรวจสอบว่ามีการตั้งค่า URL ของแอป รหัสการทำให้ใช้งานได้ของโปรเจ็กต์ Apps Script, ชื่อหัวข้อ Cloud Pub/Sub หรือ Agent ของ Dialogflow อย่างถูกต้องและทำให้ใช้งานได้แล้ว
    3. ในส่วนระดับการเข้าถึง ให้ตรวจสอบว่าผู้ใช้ที่เหมาะสมมีสิทธิ์เข้าถึงแอปด้วยอีเมลหรือกลุ่มในโดเมน Google Workspace หากใช้งานแอปกับ SDK ของ Google Workspace Marketplace ก็ไม่จำเป็นต้องตั้งค่าระดับการเข้าถึงเนื่องจากการตั้งค่า Google Workspace Marketplace จะมีความสำคัญเหนือกว่า

  4. หากเผยแพร่แอปด้วย SDK ของ Google Workspace Marketplace ให้ตรวจสอบการตั้งค่า Google Workspace Marketplace

  5. คลิกบันทึก

  6. ลองส่งข้อความถึงแอปอีกครั้ง

Google Chat API มีให้บริการแก่ผู้ใช้ Google Workspace เท่านั้น

เมื่อกำหนดค่าแอป Chat คุณอาจได้รับ ข้อผิดพลาด Google Chat API is only available to Google Workspace users ข้อความนี้ หมายความว่าบัญชี Google ที่คุณใช้กำหนดค่า Chat API ไม่ได้อยู่ในองค์กร Google Workspace วิธีสร้าง แอป Chat หรือใช้ Chat API คุณต้องใช้ Google Workspace บัญชี

โปรดทราบว่าผู้ใช้ Google Chat สามารถใช้แอปใน Chat ได้โดยไม่ต้องมี Google Workspace ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีที่ผู้ใช้ค้นพบและติดตั้ง แอป Chat โปรดดูที่เผยแพร่ แอป Google Chat

ระบบอาจนำผู้ใช้ออกจากพื้นที่ทำงาน

หากผู้ดูแลระบบ Google Workspace ไม่อนุญาตให้ผู้ใช้เปิดหรือปิดประวัติการแชท อาจมีบางครั้งที่ผู้ใช้เข้าร่วมหรืออยู่ในพื้นที่ทำงานไม่ได้ เนื่องจากเกิดความขัดแย้งระหว่างการตั้งค่าระดับผู้ใช้ที่บังคับให้เปิดหรือปิดประวัติการแชทกับพื้นที่ทำงานที่รับช่วงการตั้งค่าการบังคับใช้ในระดับองค์กร

เช่น หากผู้ใช้ตั้งค่าประวัติการแชทที่บังคับให้ "เปิด" และพื้นที่ทำงานมีการตั้งค่าประวัติการแชทโดยบังคับให้ "ปิด" ผู้ใช้รายนั้นอาจไม่สามารถเข้าร่วมพื้นที่ทำงานได้ นอกจากนี้ ระบบอาจนำผู้ใช้ดังกล่าวออกจากพื้นที่ทำงานหากผู้ใช้เข้าร่วมก่อนที่จะมีการเกิดข้อขัดแย้ง แล้วโพสต์ข้อความในพื้นที่ทำงานหลังเกิดข้อขัดแย้ง

ในสถานการณ์นี้ และสถานการณ์อื่นๆ ที่มีความขัดแย้งระหว่างการตั้งค่าประวัติ Chat API อาจสร้างการเป็นสมาชิกไม่ได้ หรือการสร้างข้อความที่มีการตรวจสอบสิทธิ์ผู้ใช้อาจนำผู้ใช้ที่ได้รับการตรวจสอบสิทธิ์ซึ่งมีการตั้งค่าประวัติการแชทที่ขัดแย้งกันออกจากพื้นที่ทำงาน

โปรดดูข้อมูลเพิ่มเติมที่หัวข้อผู้ใช้สามารถยกเว้นผู้ใช้จากพื้นที่ทำงานได้ในศูนย์ช่วยเหลือสำหรับผู้ดูแลระบบ Google Workspace

แก้ปัญหาบริการ Chat ขั้นสูงใน Google Apps Script

ดูหน้า Apps Script เกี่ยวกับ บริการ Chat ขั้นสูง

ผู้ใช้เพิ่มแอป Chat ไปยังพื้นที่ทำงานไม่ได้

หากผู้ใช้พบข้อความแสดงข้อผิดพลาด This organization's administrator must allow users to install this Chat app เมื่อพยายามเพิ่มแอป Chat ไปยังพื้นที่ทำงาน ข้อผิดพลาดนี้ อาจเกิดจากสาเหตุข้อใดข้อหนึ่งต่อไปนี้

  • องค์กรได้ปิดใช้แอปใน Chat
  • องค์กรยังไม่ได้เพิ่มรายการนี้ แชทไปยังรายการที่อนุญาตขององค์กร

หากผู้ใช้พบข้อความแสดงข้อผิดพลาดนี้เมื่อพยายามโต้ตอบกับ แอปใน Chat อาจเกิดจากองค์กร ให้สิทธิ์เข้าถึงหน่วยขององค์กรย่อย โดยไม่ต้องเปิดใช้งานสำหรับ หน่วยขององค์กรระดับบนสุด

สำหรับข้อมูลเกี่ยวกับวิธีแก้ไขปัญหานี้ โปรดดูที่ อนุญาตให้ผู้ใช้ติดตั้งแอปใน Chat

แก้ปัญหาข้อผิดพลาดของ Cloud Function

ในกรณีที่มีการใช้แอป Chat ร่วมกับ Cloud Functions และ ไม่ทำงาน ส่วนต่อไปนี้จะช่วยแก้ปัญหาได้

ตรวจสอบบันทึกของ Cloud Function

ในขั้นตอนแรก ให้ตรวจสอบบันทึก Cloud Functions เพื่อหาข้อผิดพลาด

  1. ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Functions แล้วทำดังนี้

    ไปที่ Cloud Functions

  2. หากต้องการเปิดบันทึก ให้ค้นหาระบบคลาวด์ของแอป Chat แล้วคลิก แสดงการดำเนินการ > ดูบันทึก

เครื่องมือสำรวจบันทึกจะเปิดและเรียกใช้การค้นหาที่แสดงบันทึก Cloud Function ซึ่งรวมถึง

หากข้อมูลเริ่มต้นที่บันทึกไว้ไม่เพียงพอที่จะแก้ไขข้อบกพร่องของแอป คุณสามารถเพิ่ม การบันทึกเพิ่มเติมจากโค้ด Cloud Function โปรดดูดูและเขียนระบบคลาวด์ บันทึกฟังก์ชัน

ตรวจสอบข้อผิดพลาดของ Cloud Function

นอกเหนือจากบันทึกแล้ว Cloud Function ยังอาจรายงานข้อผิดพลาดที่พบขณะที่ วิ่งอยู่

  1. ในคอนโซล Google Cloud ให้ไปที่หน้า Cloud Functions แล้วทำดังนี้

    ไปที่ Cloud Functions

  2. คลิก Cloud Function ของแอป Chat

  3. ในหน้ารายละเอียดฟังก์ชัน ข้อผิดพลาดจะแสดงอยู่ในส่วนข้อผิดพลาด

  4. หากต้องการแก้ไขข้อผิดพลาดเพิ่มเติม ให้คลิกข้อผิดพลาดนั้น

แก้ไขข้อผิดพลาดทั่วไปของ Cloud Function

บางครั้งอาจพบข้อผิดพลาดต่อไปนี้เมื่อสร้าง แอป Chat ที่มี Cloud Functions

มีฟังก์ชัน ChatApp ในภูมิภาค REGION_NAME ในโปรเจ็กต์ PROJECT_NAME อยู่แล้ว

เมื่อทำให้ Cloud Function ใช้งานได้ คุณอาจได้รับข้อผิดพลาด Function ChatApp in region REGION_NAME in project PROJECT_NAME already exists ข้อความนี้หมายความว่า Cloud Function อื่นมีชื่อเหมือนกับฟังก์ชัน ที่กำลังนำไปใช้ เปลี่ยนชื่อ และ ทำให้ฟังก์ชันใช้งานได้อีกครั้ง ยืนยันว่าแอป Chat ใช้ URL ทริกเกอร์สำหรับ Cloud Function ไม่ใช่ URL ทริกเกอร์ของ Cloud Function ที่มีอยู่แล้ว

ผู้ใช้อย่างน้อย 1 รายที่มีชื่อในนโยบายไม่ใช่ของลูกค้าที่ได้รับอนุญาต

เมื่อทำให้ Cloud Function ใช้งานได้ คุณอาจได้รับข้อผิดพลาด The operation cannot be completed on the function: "One or more users named in the policy do not belong to a permitted customer." หากได้รับข้อผิดพลาดนี้ จากนั้นให้ส่งข้อความถึง แอป Chat คุณจะเห็นข้อผิดพลาดที่ระบุว่าแอปไม่ตอบสนองเนื่องจาก Google Chat เข้าถึงเซิร์ฟเวอร์ที่โฮสต์ Cloud Function ไม่ได้ ข้อความนี้หมายความว่า ผู้ใช้ชื่อ "allUsers" ไม่มีสิทธิ์เรียกใช้ Cloud Function การให้สิทธิ์ "allUsers" "ผู้เรียกใช้ Cloud Functions" หมายความว่าระบบคลาวด์ ฟังก์ชันที่ขับเคลื่อนแอปจะพร้อมใช้งานแบบสาธารณะและเข้าถึงได้ การตรวจสอบสิทธิ์ ดูวิธีมอบหมายบทบาทได้ที่ มอบหมายบทบาทเดียว

ข้อผิดพลาดนี้อาจหมายความว่าโปรเจ็กต์ Google Cloud มีการจำกัดโดเมน สำหรับ ข้อมูลเพิ่มเติมเกี่ยวกับข้อจำกัดของโดเมนได้ที่ การจำกัดข้อมูลประจำตัวตามโดเมน

หากต้องการแก้ไขปัญหานี้ ให้ตรวจสอบว่า Cloud Function อนุญาตการแจ้งเตือนที่ไม่ผ่านการตรวจสอบสิทธิ์ คำขอ หากต้องการดูวิธีอนุญาตคำขอที่ไม่ผ่านการตรวจสอบสิทธิ์สำหรับ Cloud Function โปรดดู การอนุญาตการเข้าถึงแบบสาธารณะ (ไม่ได้ตรวจสอบสิทธิ์)