Giải pháp khắc phục lỗi Webhook trong Workspace Studio

Bạn đã tạo một quy trình trong Google Workspace Studio và đã thêm bước đó. Gửi webhook Và yêu cầu không bao giờ đến được đích. Hoặc có thể quy trình đang hoạt động bình thường và giờ thì xảy ra lỗi. Trước khi thay đổi URL một cách mù quáng, nên điều tra kỹ hơn. Quá trình thi hành án dừng lại ở thời điểm nào?: quyền truy cập vào bước đó, một yêu cầu phê duyệt đang chờ xử lý, cấu hình của yêu cầu hoặc phản hồi từ dịch vụ bên ngoài.

Workspace Studio sử dụng bước này để gửi một Yêu cầu HTTP tới một địa chỉ cụ thểChức năng này có thể được sử dụng để thông báo cho một công cụ nội bộ, tạo bản ghi trong một ứng dụng khác hoặc gửi dữ liệu đến một dịch vụ không có trình kết nối trực tiếp. Giải pháp phụ thuộc vào việc tắc nghẽn xảy ra trong Google Workspace hay trên máy chủ nhận yêu cầu.

Kiểm tra xem quản trị viên đã bật webhook chưa.

Si Gửi webhook Nó không xuất hiện trong các bước có sẵn; hãy bắt đầu với quyền hạn của tổ chức. Google cho biết tính năng này... bị vô hiệu hóa theo mặc định Và người quản trị phải kích hoạt tính năng này cho đơn vị tổ chức có liên quan. Đường dẫn là: Bảng điều khiển quản trị > Ứng dụng > Google Workspace > Workspace Studio > Cài đặt Webhook.

Hãy kiểm tra xem tài khoản của bạn có quyền truy cập vào tính năng này hay không: Google tiếp tục xác định việc truyền webhook là một tính năng trong bản xem trước giới hạnNếu bạn không phải là quản trị viên, hãy cung cấp cho quản trị viên Workspace tên của bước bị thiếu, tài khoản của bạn và đơn vị tổ chức mà bạn thuộc về. Điều này sẽ cho phép họ xác minh các thiết lập phù hợp mà không ảnh hưởng đến quyền hạn của các nhóm khác.

Xem lại danh sách các URL được cho phép và các phê duyệt.

Trong một số phiên bản, người quản trị có thể giới hạn các điểm đến bên ngoài bằng cách sử dụng một danh sách các tên miền và URL được cho phépNếu bước đó tồn tại nhưng bạn không thể kết nối đến một điểm cuối cụ thể, hãy xác nhận rằng tên miền hoặc URL của bạn có trong danh sách đó. Cài đặt này được quản lý từ các tùy chọn nhập và truy xuất URL của Drive và Docs.

Hạn chế này Nó không hoạt động giống nhau ở tất cả các phiên bản.Danh sách cho phép webhook có sẵn trong các phiên bản như Business Plus, Enterprise Standard và Plus, cũng như Education Standard và Plus. Trong các phiên bản không cung cấp tùy chọn này, việc bật webhook cho phép kết nối đến các URL hợp lệ mà không cần áp dụng danh sách cho phép này. Do đó, bạn nên kiểm tra phiên bản và chính sách của tổ chức mình trước khi quyết định sử dụng.

Dòng chảy cũng có thể đang chờ đợi một phê duyệt của người dùngGoogle coi việc gửi dữ liệu đến điểm cuối bên ngoài là một hành động nhạy cảm và yêu cầu xem xét và xác nhận theo mặc định. Nếu quá trình tự động hóa có vẻ bị kẹt, hãy mở Studio và kiểm tra các yêu cầu phê duyệt đang chờ xử lý trước khi kết luận rằng máy chủ đã gặp sự cố.

Hãy cấu hình URL, phương thức và dữ liệu gửi đi một cách chính xác.

Mở luồng vào studio.workspace.google.com và kiểm tra bước Gửi webhook. Địa chỉ phải là hoàn chỉnh và tĩnhTrường này chấp nhận URL bắt đầu bằng http:// o https://nhưng nó không cho phép chèn biến vào chính URL. HTTPS là tùy chọn được khuyến nghị. Để tránh gửi thông tin chưa được mã hóa; đây không phải là yêu cầu bắt buộc của lĩnh vực này.

• Phương thức HTTP: Hãy chọn phương thức mà API mục tiêu mong đợi. Studio cung cấp các phương thức GET, POST, PUT, PATCH và DELETE; POST là phương thức mặc định.
• Nội dung yêu cầu: Thông tin này là tùy chọn và được gửi dưới dạng văn bản. Đối với nhiều API, nên sử dụng JSON, lưu ý đến dấu ngoặc kép, dấu ngoặc nhọn và tên trường mà dịch vụ yêu cầu.
• Biến số: Bạn có thể bao gồm dữ liệu từ các bước trước đó trong phần thân. Hãy kiểm tra kết quả khi một biến chứa dấu ngoặc kép, xuống dòng hoặc các ký tự khác có thể làm hỏng định dạng JSON.
• Yêu cầu GET: Studio sẽ bỏ qua phần thân yêu cầu khi sử dụng phương thức này. Nếu dịch vụ yêu cầu dữ liệu trong phần thân, hãy kiểm tra xem tài liệu của dịch vụ đó hỗ trợ phương thức nào.

Tạo một thực thi kiểm thử Và hãy nhớ rằng nó sẽ gửi một yêu cầu thực tế đến đích đến. Nếu bước này thành công, phản hồi của nó sẽ được lưu dưới dạng biến văn bản để sử dụng sau này trong cùng một quy trình.

Sử dụng tab Hoạt động để xác định vấn đề.

Sau mỗi lần thực thi, hãy mở Hoạt động Trong Workspace Studio. Nếu yêu cầu thành công, bạn có thể xem lại dữ liệu đã gửi và phản hồi đã nhận. Nếu thất bại, Studio sẽ hiển thị thông báo lỗi. mã lỗi và phản hồi URL đíchThông tin này cho phép chúng ta phân biệt giữa sự cố cấu hình trong luồng xử lý và lỗi từ chối do dịch vụ bên ngoài gây ra.

Un 400 Điều này thường cho thấy người nhận không chấp nhận yêu cầu như được viết ra; họ xem xét lại phương thức và nội dung. Trong trường hợp... 401 hoặc 403Hãy kiểm tra các yêu cầu truy cập dịch vụ và các hạn chế của tổ chức bạn. 404 Nó yêu cầu bạn xác minh tuyến đường điểm cuối. Nếu một 429Kiểm tra giới hạn yêu cầu của bạn; lỗi 5xx Những thông báo này thường cho thấy có vấn đề với dịch vụ nhận tín hiệu. Phản hồi cụ thể từ điểm cuối sẽ hữu ích hơn là chỉ dựa vào con số để phân tích.

Các nhà quản trị cũng có thể tham khảo Nhật ký sự kiện Workspace Studio Để điều tra các yêu cầu webhook. Quyền truy cập vào một số dữ liệu nhất định, chẳng hạn như URL được yêu cầu, bị hạn chế vì nó có thể chứa thông tin nhạy cảm.

Đừng nhầm lẫn webhook của Studio với webhook đến từ Google Chat.

Bước Gửi webhook Workspace Studio thực hiện yêu cầu đến một URL bên ngoài. webhook Google Chat đếnNgược lại, đó là một URL được tạo trong một không gian để hệ thống khác đăng tin nhắn vào đó. Chúng là các yếu tố riêng biệt, mặc dù bạn có thể sử dụng URL trò chuyện làm đích đến cho luồng Studio.

Nếu mục tiêu của bạn là đăng quảng cáo trên Google Chat, trước tiên hãy kiểm tra xem bước 1 đã đủ chưa. Đăng tải trong một không gian Từ Studio. Nếu bạn cần sử dụng webhook đến, bạn phải tạo nó từ Ứng dụng và tích hợp Các webhook này được thiết lập để tạo không gian lưu trữ và giữ URL của nó ở chế độ riêng tư, bao gồm cả khóa và mã thông báo. Chúng được sử dụng để gửi tin nhắn đến không gian lưu trữ, nhưng không cho phép trò chuyện với người dùng.

Google Chat áp dụng hạn mức dùng chung cho các webhook đến. một yêu cầu mỗi giây và mỗi không gianGiới hạn này áp dụng cho Chat; đây không phải là giới hạn chung cho bước Gửi Webhook trong Workspace Studio. Nếu lỗi xảy ra khi đăng nhiều thông báo liên tiếp lên cùng một không gian, hãy kiểm tra hạn mức này cùng với phản hồi yêu cầu.

Nếu lỗi xảy ra không thường xuyên, hãy kiểm tra hạn mức lưu lượng.

Workspace Studio cho phép bạn tạo tối đa... 25 luồng dữ liệu mỗi người dùng, với tối đa là 20 bước cho mỗi quy trìnhNgoài ra, nó còn áp dụng giới hạn tổng số lần thực thi trong mỗi khoảng thời gian 24 giờ. Nếu bạn đạt đến giới hạn này, các lần thực thi tiếp theo sẽ thất bại cho đến khi bộ đếm được đặt lại.

Nếu webhook chỉ gặp lỗi sau nhiều lần kích hoạt, hãy kiểm tra Hoạt động Kiểm tra cả giới hạn của Studio và giới hạn của dịch vụ mục tiêu. Việc tinh chỉnh trình kích hoạt—ví dụ: giới hạn nó cho người gửi hoặc sự kiện cụ thể—có thể ngăn chặn các yêu cầu không cần thiết. Nếu lỗi xảy ra trong lần chạy đầu tiên, hãy bắt đầu bằng cách kiểm tra quyền, các phê duyệt đang chờ xử lý và phản hồi của điểm cuối.