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

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

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

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

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

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

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

    ไปที่ Chat API

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

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

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

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

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

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

เฉพาะผู้ใช้ Google Workspace เท่านั้นที่ใช้ Google Chat API ได้

เมื่อกำหนดค่าแอป 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

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

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

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

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

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

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

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

ผู้ดูแลระบบต้องให้ขอบเขตการให้สิทธิ์ OAuth ที่จำเป็นแก่แอปสำหรับการดำเนินการนี้

เมื่อ ตรวจสอบสิทธิ์ในฐานะแอป Chat คุณอาจได้รับข้อผิดพลาดต่อไปนี้

<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">

ข้อความแสดงข้อผิดพลาดนี้หมายความว่าผู้ดูแลระบบ Google Workspace ยังไม่ได้ ให้สิทธิ์อนุมัติแบบครั้งเดียวแก่แอป Chat เพื่อใช้ ขอบเขตการให้สิทธิ์ที่ขึ้นต้นด้วยชื่อ https://www.googleapis.com/auth/chat.app.*

วิธีแก้ไขข้อผิดพลาด

  • ขอให้ผู้ดูแลระบบ Google Workspace อนุมัติแอป Chat เมื่อจัดการข้อผิดพลาดนี้ในตรรกะของแอป Chat ให้พิจารณาส่งข้อความเพื่อประกาศว่า แอป Chat ต้องได้รับการอนุมัติจากผู้ดูแลระบบเพื่อดำเนินการ ตามคำขอ เช่น To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
  • หากเมธอด Chat API รองรับ https://www.googleapis.com/auth/chat.botขอบเขตการให้สิทธิ์ที่ไม่ ต้องได้รับการอนุมัติจากผู้ดูแลระบบ ให้ลองใช้เมธอดนั้นแทน หากต้องการตรวจสอบว่าเมธอดใดรองรับขอบเขตการให้สิทธิ์ โปรดดูตรวจสอบสิทธิ์และให้สิทธิ์แอป Google Chat และคำขอ Google Chat API

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

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

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

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

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

    ไปที่ Cloud Functions

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

Logs Explorer จะเปิดขึ้นและเรียกใช้การค้นหาที่แสดงบันทึกของ Cloud Functions รวมถึง ข้อผิดพลาด

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

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

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

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

    ไปที่ Cloud Functions

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

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

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

แก้ไขข้อผิดพลาดที่พบบ่อยของ Cloud Functions

บางครั้งคุณอาจพบข้อผิดพลาดต่อไปนี้เมื่อสร้างแอป 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 การให้บทบาท "ผู้เรียกใช้ Cloud Functions" แก่ "allUsers" หมายความว่า Cloud Function ที่ขับเคลื่อนแอปจะพร้อมใช้งานและเข้าถึงได้แบบสาธารณะโดยไม่ต้องมีการตรวจสอบสิทธิ์ ดูวิธีมอบหมายบทบาทได้ที่ ให้สิทธิ์บทบาทเดียว

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

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