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

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

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