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

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

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

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

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

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

  1. ในคอนโซล Google API ให้คลิกเมนู > API และบริการ > API และบริการที่เปิดใช้ > 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 API ให้ไปที่หน้า Cloud Functions โดยทำดังนี้

    ไปที่ Cloud Functions

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

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

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

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

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