Phần này mô tả các vấn đề thường gặp khi bạn tạo và kiểm thử ứng dụng Chat.
Thông báo dạng thẻ, hộp thoại hoặc bản xem trước liên kết không hiển thị hoặc hoạt động như dự kiến
Để được trợ giúp khắc phục lỗi về thẻ, hãy xem bài viết Khắc phục lỗi và sửa thẻ.
Ứng dụng không phản hồi
Nếu bạn nhắn tin cho ứng dụng Chat và ứng dụng này phản hồi "Ứng dụng không phản hồi", hãy xác minh cấu hình của ứng dụng Chat:
Trong bảng điều khiển Google Cloud, hãy nhấp vào Trình đơn > Các sản phẩm khác > Google Workspace > Thư viện sản phẩm > Google Chat API > Quản lý > Cấu hình.
Trong phần Trạng thái của ứng dụng, hãy nhớ chọn Đang hoạt động – người dùng có thể sử dụng.
Trong phần Tính năng tương tác, hãy đảm bảo rằng các chế độ cài đặt phù hợp với chức năng của ứng dụng. Nếu ứng dụng Chat của bạn tương tác với người dùng, hãy nhớ bật chế độ Bật các tính năng tương tác:
- Theo mặc định, các ứng dụng có thể phản hồi tin nhắn trực tiếp của người dùng.
- Nếu ứng dụng của bạn phản hồi tin nhắn trong không gian và cuộc trò chuyện nhóm, hãy chọn Tham gia không gian và cuộc trò chuyện nhóm.
- Trong mục Connection settings (Chế độ cài đặt kết nối), hãy đảm bảo rằng bạn đã đặt chính xác HTTP endpoint URL (URL điểm cuối HTTP), Deployment ID (Mã nhận dạng triển khai) của dự án Apps Script, Topic Name (Tên chủ đề) của Cloud Pub/Sub hoặc tác nhân Dialogflow và bạn đã triển khai các mục này.
- Trong phần Chế độ hiển thị, hãy đảm bảo rằng người dùng phù hợp có quyền truy cập vào ứng dụng bằng địa chỉ email hoặc một nhóm trong miền Google Workspace. Nếu ứng dụng được triển khai bằng Bộ công cụ phát triển phần mềm Google Workspace Marketplace, thì bạn không cần phải thiết lập chế độ hiển thị vì chế độ cài đặt của Google Workspace Marketplace sẽ được ưu tiên.
Nếu ứng dụng được xuất bản bằng Bộ công cụ phát triển phần mềm Google Workspace Marketplace, hãy xem lại chế độ cài đặt Google Workspace Marketplace.
Nhấp vào Lưu.
Hãy thử nhắn tin lại cho ứng dụng.
Google Chat API chỉ dành cho người dùng Google Workspace
Khi định cấu hình ứng dụng Chat, bạn có thể gặp lỗi Google Chat API is only available to Google Workspace users. Thông báo này có nghĩa là Tài khoản Google mà bạn đã dùng để định cấu hình Chat API không thuộc một tổ chức Google Workspace. Để tạo ứng dụng Chat hoặc sử dụng API Chat, bạn phải sử dụng tài khoản Google Workspace.
Xin lưu ý rằng người dùng Google Chat có thể sử dụng các ứng dụng Chat mà không cần tài khoản Google Workspace. Để tìm hiểu thêm về cách người dùng khám phá và cài đặt ứng dụng Chat, hãy xem bài viết Tạo ứng dụng Google Chat có tính tương tác.
Người dùng có thể bị loại trừ khỏi không gian
Nếu quản trị viên Google Workspace không cho phép người dùng bật hoặc tắt nhật ký trò chuyện, thì có thể có những lúc người dùng không thể tham gia hoặc ở lại một không gian do xung đột giữa chế độ cài đặt ở cấp người dùng (buộc bật hoặc tắt nhật ký trò chuyện) và một không gian kế thừa chế độ cài đặt bắt buộc ở cấp tổ chức.
Ví dụ: nếu người dùng có chế độ cài đặt nhật ký trò chuyện trong Chat được đặt thành "bật" bắt buộc và một không gian có chế độ cài đặt nhật ký trò chuyện trong Chat được đặt thành "tắt" bắt buộc, thì người dùng đó có thể không tham gia được không gian. Ngoài ra, người dùng đó có thể bị xoá khỏi không gian nếu họ tham gia trước khi xảy ra xung đột và sau đó đăng tin nhắn trong không gian sau khi xảy ra xung đột.
Trong trường hợp này và các trường hợp khác có xung đột giữa các chế độ cài đặt nhật ký trò chuyện, Chat API có thể không tạo được thành viên hoặc việc tạo tin nhắn có xác thực người dùng có thể xoá người dùng đã xác thực có chế độ cài đặt nhật ký trò chuyện xung đột khỏi không gian.
Để tìm hiểu thêm, hãy xem bài viết Người dùng có thể bị loại khỏi không gian trong Trung tâm trợ giúp dành cho quản trị viên Google Workspace.
Khắc phục sự cố với dịch vụ Chat nâng cao trong Google Apps Script
Xem trang Apps Script về Dịch vụ Chat nâng cao.
Người dùng không thể thêm ứng dụng Chat vào không gian
Nếu người dùng gặp thông báo lỗi This organization's administrator must allow users to install this Chat app khi cố gắng thêm một ứng dụng Chat vào một không gian, thì lỗi này có thể là do một trong những lý do sau:
- Tổ chức đã vô hiệu hoá các ứng dụng Chat.
- Tổ chức chưa thêm ứng dụng Chat cụ thể này vào danh sách cho phép của tổ chức.
Nếu người dùng gặp phải thông báo lỗi này khi cố gắng tương tác với một ứng dụng Chat, thì có thể là do tổ chức cấp quyền truy cập cho một đơn vị tổ chức phụ mà không bật quyền truy cập cho đơn vị tổ chức mẹ.
Để biết thông tin về cách giải quyết vấn đề này, hãy xem bài viết Cho phép người dùng cài đặt các ứng dụng trong Chat.
Quản trị viên phải cấp cho ứng dụng phạm vi uỷ quyền OAuth cần thiết cho hành động này
Khi xác thực dưới dạng ứng dụng Chat, bạn có thể gặp lỗi sau:
<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.">
Thông báo lỗi này có nghĩa là quản trị viên Google Workspace chưa cấp quyền phê duyệt một lần cho ứng dụng Chat để sử dụng các phạm vi uỷ quyền bắt đầu bằng tên https://www.googleapis.com/auth/chat.app.*.
Cách giải quyết lỗi:
- Yêu cầu quản trị viên Google Workspace phê duyệt ứng dụng Chat của bạn. Khi xử lý lỗi này trong logic ứng dụng Chat, hãy cân nhắc việc gửi một thông báo cho biết ứng dụng Chat cần được quản trị viên phê duyệt để thực hiện hành động được yêu cầu, chẳng hạn như:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>. - Nếu phương thức Chat API hỗ trợ phạm vi uỷ quyền
https://www.googleapis.com/auth/chat.bot(không yêu cầu sự phê duyệt của quản trị viên), hãy cân nhắc sử dụng phương thức này. Để kiểm tra xem một phương thức hỗ trợ những phạm vi uỷ quyền nào, hãy xem phần Xác thực và uỷ quyền cho các ứng dụng Google Chat và yêu cầu API Google Chat.
Khắc phục lỗi Cloud Functions
Nếu ứng dụng trò chuyện được triển khai bằng Cloud Functions và không hoạt động, thì các phần sau đây sẽ giúp bạn khắc phục sự cố và giải quyết vấn đề.
Kiểm tra nhật ký Cloud Functions
Bước đầu tiên là kiểm tra nhật ký Cloud Functions để xem có lỗi không.
Trong Google Cloud Console, hãy chuyển đến trang Cloud Functions:
Để mở nhật ký, hãy tìm Cloud Function (Hàm trên đám mây) của ứng dụng Chat, sau đó nhấp vào Hiện các thao tác > Xem nhật ký.
Trình khám phá nhật ký sẽ mở ra và chạy một truy vấn cho thấy nhật ký của Cloud Functions, bao gồm cả lỗi.
Nếu thông tin mặc định được ghi nhật ký không đủ để gỡ lỗi ứng dụng, bạn có thể thêm thông tin ghi nhật ký bổ sung từ mã Cloud Functions. Xem phần Xem và ghi nhật ký Hàm trên đám mây.
Kiểm tra lỗi Cloud Functions
Ngoài nhật ký, Cloud Functions cũng có thể báo cáo các lỗi gặp phải trong khi chạy.
Trong Google Cloud Console, hãy chuyển đến trang Cloud Functions:
Nhấp vào Cloud Functions của ứng dụng Chat.
Trên trang Chi tiết về hàm, các lỗi được liệt kê trong mục Lỗi.
Để khắc phục thêm một lỗi, hãy nhấp vào lỗi đó.
Khắc phục các lỗi thường gặp về Cloud Functions
Đôi khi, bạn sẽ gặp phải các lỗi sau đây khi tạo một ứng dụng trò chuyện bằng Cloud Functions.
Hàm ChatApp trong khu vực REGION_NAME thuộc dự án PROJECT_NAME đã tồn tại
Khi triển khai một Cloud Function, bạn có thể gặp lỗi Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. Thông báo này có nghĩa là một Cloud Function khác có cùng tên với Cloud Function mà bạn đang triển khai. Đổi tên rồi triển khai lại hàm. Xác minh rằng ứng dụng Chat sử dụng URL kích hoạt cho Cloud Function của bạn, chứ không phải URL kích hoạt của Cloud Function có sẵn.
Một hoặc nhiều người dùng có tên trong chính sách không thuộc về một khách hàng được phép
Khi triển khai một Cloud Function, bạn có thể nhận được lỗi The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer." Nếu gặp lỗi này rồi nhắn tin cho ứng dụng Chat, bạn sẽ nhận được thông báo lỗi cho biết ứng dụng không phản hồi vì Google Chat không thể truy cập vào máy chủ lưu trữ Cloud Function. Thông báo này có nghĩa là người dùng có tên "allUsers" không có quyền gọi Cloud Function.
Việc cấp vai trò "Trình gọi hàm Cloud" cho "allUsers" có nghĩa là Hàm Cloud hỗ trợ ứng dụng này được cung cấp công khai và có thể truy cập mà không cần xác thực. Để tìm hiểu cách chỉ định vai trò, hãy xem phần Cấp một vai trò duy nhất.
Lỗi này có thể có nghĩa là dự án trên Google Cloud bị hạn chế theo miền. Để biết thêm thông tin về các ràng buộc đối với chế độ hạn chế theo miền, hãy tham khảo bài viết Hạn chế danh tính theo miền.
Để giải quyết vấn đề này, hãy xác minh rằng Cloud Function của bạn cho phép các lệnh gọi chưa được xác thực. Để tìm hiểu cách cho phép các lệnh gọi chưa được xác thực cho một Cloud Function hiện có, hãy tham khảo phần Cho phép truy cập công khai (chưa được xác thực).