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

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

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

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

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

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

1. ใน คอนโซล Google API ให้คลิกเมนู menu > API และบริการ > API และบริการที่เปิดใช้ > Google Chat API > การกำหนดค่า

   ไปที่การกำหนดค่า Chat API

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

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

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

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

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

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

แก้ปัญหาบริการแชทขั้นสูงใน 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 API ให้ไปที่หน้า Cloud Functions โดยทำดังนี้

   ไปที่ Cloud Functions

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

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

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

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

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

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

   ไปที่ Cloud Functions

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

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

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

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

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

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

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