วิธีแก้ปัญหา Webhook ล้มเหลวใน Workspace Studio

คุณได้สร้างโฟลว์ใน Google Workspace Studio แล้ว และได้เพิ่มขั้นตอนเรียบร้อยแล้ว ส่งเว็บฮุค และคำขอไม่ถึงปลายทาง หรือบางทีขั้นตอนการทำงานอาจเคยราบรื่นดี แต่ตอนนี้เกิดข้อผิดพลาดขึ้น ก่อนที่จะเปลี่ยน URL โดยไม่ตรวจสอบให้ดีเสียก่อน การดำเนินการจะหยุดลงเมื่อใด?: การเข้าถึงขั้นตอน การอนุมัติที่รอดำเนินการ การกำหนดค่าคำขอ หรือการตอบกลับจากบริการภายนอก

Workspace Studio ใช้ขั้นตอนนี้เพื่อส่ง คำขอ HTTP ไปยังที่อยู่เฉพาะสามารถใช้เพื่อแจ้งเตือนเครื่องมือภายใน สร้างบันทึกในแอปพลิเคชันอื่น หรือส่งข้อมูลไปยังบริการที่ไม่มีตัวเชื่อมต่อโดยตรง วิธีแก้ปัญหานั้นขึ้นอยู่กับว่าปัญหาเกิดขึ้นภายใน Google Workspace หรือบนเซิร์ฟเวอร์ที่รับคำขอ

ตรวจสอบว่าผู้ดูแลระบบได้เปิดใช้งานเว็บฮุคแล้วหรือไม่

Si ส่งเว็บฮุค ขั้นตอนดังกล่าวไม่ปรากฏในรายการที่มีให้เลือก โปรดเริ่มต้นด้วยการขอสิทธิ์จากองค์กร Google ระบุว่าฟีเจอร์นี้คือ... ปิดใช้งานโดยค่าเริ่มต้น และผู้ดูแลระบบจะต้องเปิดใช้งานสำหรับหน่วยงานที่เกี่ยวข้อง โดยไปที่ เส้นทางคือ คอนโซลผู้ดูแลระบบ > แอป > Google Workspace > Workspace Studio > การตั้งค่า Webhook

โปรดตรวจสอบด้วยว่าบัญชีของคุณสามารถเข้าถึงฟีเจอร์นี้ได้หรือไม่: Google ยังคงระบุว่าการส่งผ่าน webhook เป็นฟีเจอร์หนึ่งในหลายๆ ด้าน ตัวอย่างแบบจำกัดหากคุณไม่ใช่ผู้ดูแลระบบ โปรดแจ้งชื่อขั้นตอนที่ขาดหายไป บัญชีของคุณ และหน่วยงานที่คุณสังกัด ให้กับผู้ดูแลระบบ Workspace เพื่อให้พวกเขาสามารถตรวจสอบการตั้งค่าที่เกี่ยวข้องได้โดยไม่กระทบต่อสิทธิ์การเข้าถึงของทีมอื่น

ตรวจสอบรายชื่อ URL ที่อนุญาตและการอนุมัติ

ในบางเวอร์ชัน ผู้ดูแลระบบสามารถจำกัดปลายทางภายนอกได้โดยใช้ รายชื่อโดเมนและ URL ที่อนุญาตหากมีขั้นตอนดังกล่าวอยู่ แต่คุณไม่สามารถเชื่อมต่อกับปลายทางที่ระบุได้ โปรดตรวจสอบว่าโดเมนหรือ URL ของคุณอยู่ในรายการนั้นหรือไม่ การตั้งค่านี้จัดการได้จากตัวเลือกการนำเข้าและดึงข้อมูล URL ของ Drive และ Docs

ข้อจำกัดนี้ มันไม่ได้ทำงานเหมือนกันในทุกเวอร์ชันรายการอนุญาตเว็บฮุค (Webhook Allowlist) มีให้ใช้งานในเวอร์ชันต่างๆ เช่น Business Plus, Enterprise Standard และ Plus รวมถึง Education Standard และ Plus ในเวอร์ชันที่ไม่มีการควบคุมนี้ การเปิดใช้งานเว็บฮุคจะอนุญาตให้เชื่อมต่อกับ URL ที่ถูกต้องโดยไม่ต้องใช้รายการอนุญาตนี้ ดังนั้นจึงควรตรวจสอบเวอร์ชันและนโยบายขององค์กรของคุณก่อน

กระแสอาจกำลังรออยู่เช่นกัน การอนุมัติของผู้ใช้Google ถือว่าการส่งข้อมูลไปยังปลายทางภายนอกเป็นการกระทำที่ละเอียดอ่อน และโดยปกติแล้วจะต้องมีการตรวจสอบและยืนยัน หากระบบอัตโนมัติดูเหมือนจะติดขัด ให้เปิด Google Studio และตรวจสอบคำขออนุมัติที่รอดำเนินการก่อนที่จะสรุปว่าเซิร์ฟเวอร์ล้มเหลว

ตั้งค่า URL, วิธีการ และข้อมูลที่ส่งให้ถูกต้อง

เปิดการไหลเข้า สตูดิโอ.เวิร์กสเปซ.กูเกิล.com และตรวจสอบขั้นตอน "ส่งเว็บฮุค" ที่อยู่ควรเป็น สมบูรณ์และคงที่ช่องนี้รับ URL ที่ขึ้นต้นด้วย http:// o https://แต่ไม่อนุญาตให้แทรกตัวแปรลงใน URL โดยตรง HTTPS เป็นตัวเลือกที่แนะนำ เพื่อหลีกเลี่ยงการส่งข้อมูลที่ไม่ได้เข้ารหัส ซึ่งไม่ใช่ข้อกำหนดของสาขานี้

• วิธีการ HTTP: เลือกตัวเลือกที่ API เป้าหมายต้องการ Studio มีตัวเลือก GET, POST, PUT, PATCH และ DELETE โดยค่าเริ่มต้นคือ POST
• เนื้อหาของคำขอ: เป็นตัวเลือกเสริมและจะถูกส่งเป็นข้อความ สำหรับ API หลายๆ ตัว แนะนำให้ใช้ JSON โดยต้องเคารพเครื่องหมายอัญประกาศ วงเล็บปีกกา และชื่อฟิลด์ที่บริการนั้นๆ กำหนด
• ตัวแปร: คุณสามารถรวมข้อมูลจากขั้นตอนก่อนหน้าไว้ในส่วนเนื้อหาได้ ตรวจสอบผลลัพธ์เมื่อตัวแปรมีเครื่องหมายอัญประกาศ ตัวแบ่งบรรทัด หรืออักขระอื่นๆ ที่อาจทำให้รูปแบบ JSON เสียหาย
• คำขอ GET: โปรแกรม Studio จะไม่สนใจส่วนเนื้อหาของคำขอด้วยวิธีนี้ หากบริการนั้นต้องการข้อมูลในส่วนเนื้อหา โปรดตรวจสอบว่าเอกสารประกอบของบริการนั้นรองรับวิธีการใด

สร้าง การดำเนินการทดสอบ และอย่าลืมว่าขั้นตอนนี้จะส่งคำขอจริงไปยังปลายทาง หากขั้นตอนทำงานสำเร็จ การตอบกลับจะถูกแปลงเป็นตัวแปรข้อความเพื่อนำไปใช้ในขั้นตอนเดียวกันในภายหลัง

ใช้แท็บกิจกรรมเพื่อระบุปัญหา

หลังจากดำเนินการแต่ละครั้ง ให้เปิด กิจกรรม ใน Workspace Studio หากการร้องขอสำเร็จ คุณสามารถตรวจสอบข้อมูลที่ส่งและคำตอบที่ได้รับ หากล้มเหลว Studio จะแสดงข้อความแจ้งเตือน รหัสข้อผิดพลาดและการตอบสนอง URL ปลายทางข้อมูลนี้ช่วยให้เราสามารถแยกแยะความแตกต่างระหว่างปัญหาการกำหนดค่าในขั้นตอนการทำงานและการปฏิเสธที่เกิดจากบริการภายนอกได้

Un 400 โดยปกติแล้ว นี่แสดงว่าผู้รับไม่ยอมรับคำขอตามที่เขียนไว้ พวกเขาจะตรวจสอบวิธีการและเนื้อหาอีกครั้ง ในกรณีที่... 401 หรือ 403ตรวจสอบข้อกำหนดการเข้าถึงของบริการและข้อจำกัดขององค์กรของคุณ 404 ระบบจะแจ้งให้คุณตรวจสอบเส้นทางปลายทาง หาก 429ตรวจสอบขีดจำกัดการร้องขอของคุณ; ข้อผิดพลาด 5xx โดยปกติแล้ว ตัวเลขเหล่านี้บ่งชี้ถึงปัญหาที่เกิดขึ้นกับบริการปลายทาง การตอบสนองที่เฉพาะเจาะจงจากปลายทางนั้นมีประโยชน์มากกว่าการตีความตัวเลขเพียงอย่างเดียว

ผู้ดูแลระบบยังสามารถปรึกษาหารือกับ บันทึกเหตุการณ์ของ Workspace Studio เพื่อตรวจสอบคำขอเว็บฮุค การเข้าถึงข้อมูลบางอย่าง เช่น URL ที่ร้องขอ จะถูกจำกัด เนื่องจากอาจมีข้อมูลที่ละเอียดอ่อน

อย่าสับสนระหว่าง webhook ของ Studio กับ webhook ขาเข้าจาก Google Chat

ขั้นตอน ส่งเว็บฮุค Workspace Studio ส่งคำขอไปยัง URL ภายนอก เว็บฮุค Google Chat ขาเข้าในทางตรงกันข้าม มันเป็น URL ที่สร้างขึ้นภายในพื้นที่สำหรับระบบอื่นเพื่อโพสต์ข้อความลงไป ทั้งสองอย่างเป็นองค์ประกอบที่แยกจากกัน แม้ว่าคุณจะสามารถใช้ URL ของแชทเป็นปลายทางสำหรับโฟลว์ของ Studio ได้ก็ตาม

หากเป้าหมายของคุณคือการลงโฆษณาใน Google Chat ก่อนอื่นให้ตรวจสอบว่าขั้นตอนที่ 1 เพียงพอหรือไม่ เผยแพร่ในพื้นที่ จาก Studio หากคุณต้องการใช้ webhook ขาเข้า คุณต้องสร้างมันจากที่นี่ แอปและการผสานรวม ของพื้นที่นั้นและเก็บ URL ไว้เป็นส่วนตัว ซึ่งประกอบด้วยคีย์และโทเค็น เว็บฮุคเหล่านี้ใช้สำหรับส่งข้อความไปยังพื้นที่นั้น แต่ไม่อนุญาตให้สนทนากับผู้ใช้

Google Chat ใช้โควต้าร่วมกันสำหรับเว็บฮุคขาเข้า หนึ่งคำขอต่อวินาที และต่อพื้นที่ข้อจำกัดนี้ใช้กับแชท ไม่ใช่ข้อจำกัดทั่วไปสำหรับขั้นตอนการส่ง Webhook ใน Workspace Studio หากเกิดข้อผิดพลาดเมื่อโพสต์ประกาศจำนวนมากติดต่อกันในพื้นที่เดียวกัน โปรดตรวจสอบโควต้าดังกล่าวพร้อมกับคำตอบของคำขอ

หากข้อผิดพลาดเกิดขึ้นเป็นระยะ ให้ตรวจสอบโควต้าการไหลของข้อมูล

Workspace Studio ช่วยให้คุณสร้างได้สูงสุดถึง 25 โฟลว์ต่อผู้ใช้, สูงสุด 20 ขั้นตอนต่อกระบวนการนอกจากนี้ ระบบยังกำหนดขีดจำกัดรวมของจำนวนการเรียกใช้งานในแต่ละช่วงเวลา 24 ชั่วโมง หากคุณถึงขีดจำกัดนี้ การเรียกใช้งานครั้งต่อไปจะล้มเหลวจนกว่าตัวนับจะถูกรีเซ็ต

หาก webhook ล้มเหลวหลังจากมีการเปิดใช้งานหลายครั้ง ให้ตรวจสอบ... กิจกรรม ตรวจสอบทั้งข้อจำกัดของ Studio และของบริการเป้าหมาย การปรับแต่งทริกเกอร์ เช่น การจำกัดให้เฉพาะผู้ส่งหรือเหตุการณ์ที่กำหนด จะช่วยป้องกันการร้องขอที่ไม่จำเป็น หากเกิดข้อผิดพลาดในการทำงานครั้งแรก ให้เริ่มต้นด้วยการตรวจสอบสิทธิ์ การอนุมัติที่รออยู่ และการตอบสนองของปลายทาง