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

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

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

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

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

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

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

    ไปที่ Chat API

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

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

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

  4. หากเผยแพร่แอปด้วย Google Workspace Marketplace SDK ให้ตรวจสอบการตั้งค่า 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

ผู้ดูแลระบบต้องให้สิทธิ์ 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 Function

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

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

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

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

    ไปที่ Cloud Functions

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

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

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

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

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

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