Phần này mô tả các vấn đề thường gặp mà bạn có thể gặp phải trong khi xây dựng và kiểm thử ứng dụng Chat.
Tin nhắn thẻ, hộp thoại hoặc bản xem trước đường liên kết không hiển thị hoặc không hoạt động như mong đợi
Để được trợ giúp khắc phục lỗi thẻ, hãy xem phần Khắc phục sự cố 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 là "Ứng dụng không phản hồi" 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 > Sản phẩm khác > Google Workspace > Thư viện sản phẩm > API Google Chat > Quản lý > Cấu hình.
Trong phần Trạng thái ứng dụng, hãy đảm bảo rằng bạn đã chọn Trực tiếp – dành cho người 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 tuỳ chọn Bật tính năng tương tác:
- Nếu ứng dụng của bạn phản hồi tin nhắn, hãy nhớ chọn Nhận tin nhắn 1:1.
- Trong phần Cài đặt kết nối, hãy đảm bảo rằng URL điểm cuối HTTP, Mã triển khai của dự án Apps Script, Tên chủ đề của Cloud Pub/Sub hoặc tác nhân Dialogflow được thiết lập chính xác và được triển khai.
- Trong phần Chế độ hiển thị, hãy đảm bảo những người dùng thích hợp có quyền truy cập vào ứng dụng bằng địa chỉ email hoặc nhóm trong miền Google Workspace. Nếu triển khai ứng dụng bằng SDK Google Workspace Marketplace, thì bạn không cần cài đặt chế độ hiển thị vì các 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 SDK Google Workspace Marketplace, hãy xem lại các chế độ cài đặt của Google Workspace Marketplace.
Nhấp vào Lưu.
Hãy thử nhắn tin lại cho ứng dụng.
API Google Chat 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. Tin nhắn này
có nghĩa là Tài khoản Google mà bạn đã sử dụng để định cấu hình
API Chat 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 Phát hành ứng dụng Google Chat.
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ì đôi khi người dùng không thể tham gia hoặc ở lại trong 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 buộc phải "bật" chế độ cài đặt Nhật ký trò chuyện và một không gian có chế độ cài đặt Nhật ký trò chuyện bị buộc "tắt" 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, 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ý, API Chat có thể không tạo được gói 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ý Chat xung đột khỏi không gian.
Để tìm hiểu thêm, hãy xem bài viết Có thể loại trừ người dùng 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ụ Advanced Chat (Trò chuyện nâng cao) trong Google Apps Script
Xem trang Apps Script về Dịch vụ trò chuyện 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 ứ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 đã tắt ứng dụng Chat.
- Tổ chức chưa thêm cụ thể này Ứng dụng nhắn tin với danh sách cho phép của tổ chức.
Nếu người dùng gặp thông báo lỗi này khi cố gắng tương tác với Ứng dụng Chat, lỗi này có thể do tổ chức gây ra cấp quyền truy cập vào đơn vị tổ chức con mà không cần bật đơn vị đó 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 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 bắt buộc đối với hành động này
Thời gian 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 khắc phục lỗi này:
- Yêu cầu quản trị viên Google Workspace cấp quyền cho ứng dụng Chat. Khi xử lý lỗi này trong logic ứng dụng Chat, hãy cân nhắc gửi thông báo thông báo rằng ứ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 API Chat hỗ trợ phạm vi uỷ quyền
https://www.googleapis.com/auth/chat.botkhông yêu cầu quản trị viên phê duyệt, hãy cân nhắc sử dụng phạm vi này. Để kiểm tra xem phương thức nào hỗ trợ phạm vi uỷ quyền, hãy xem phần Xác thực và uỷ quyền cho ứng dụng Google Chat và các yêu cầu API Google Chat.
Khắc phục lỗi về Hàm trên đám mây
Nếu ứng dụng Chat được triển khai bằng Cloud Functions và thiết bị không hoạt động, các phần sau đây sẽ giúp khắc phục sự cố.
Kiểm tra nhật ký Chức năng đám mây
Trước tiên, hãy kiểm tra nhật ký của Cloud Functions để tìm lỗi.
Trong bảng điều khiển Google Cloud, hãy truy cập vào trang Cloud Functions:
Để mở nhật ký, hãy tìm Đám mây của ứng dụng Chat Hàm, sau đó nhấp vào Hiển thị hành động > Xem nhật ký.
Trình khám phá nhật ký sẽ mở và chạy một truy vấn hiển thị nhật ký của Hàm trên đám mây, bao gồm cả lỗi.
Nếu thông tin mặc định đã ghi lại không đủ để gỡ lỗi ứng dụng, bạn có thể thêm ghi nhật ký bổ sung từ mã Chức năng đám mây của bạn. Xem phần Xem và ghi đám mây Nhật ký hàm.
Kiểm tra lỗi Cloud Functions
Ngoài nhật ký, Hàm trên đám mây cũng có thể báo cáo các lỗi gặp phải trong khi chạy.
Trong bảng điều khiển Google Cloud, hãy truy cập vào trang Cloud Functions:
Nhấp vào Chức năng trên đám mây của ứng dụng Chat.
Trên trang chi tiết về Hàm, các lỗi được liệt kê trong phần Lỗi.
Để khắc phục thêm lỗi, hãy nhấp vào lỗi đó.
Khắc phục các lỗi thường gặp về Hàm đám mây
Đôi khi, bạn có thể gặp phải các lỗi sau khi tạo ứng dụng Chat bằng Cloud Functions.
Đã tồn tại hàm ChatApp ở khu vực REGION_NAME trong dự án PROJECT_NAME
Khi triển khai một Chức năng đám mây, 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 Hàm đám mây khác trùng tên với
bạn đang triển khai. Thay đổi tên và
triển khai lại hàm này. Xác minh rằng ứng dụng Chat sử dụng URL kích hoạt cho Hàm trên đám mây, chứ không phải URL kích hoạt của Hàm trên đám mây hiện có.
Một hoặc nhiều người dùng được nêu tên trong chính sách không thuộc về khách hàng được phép
Khi triển khai một Hàm trên đám mây, bạn có thể gặp 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 gửi tin nhắn đến ứ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ể kết nối với máy chủ lưu trữ Hàm trên đám mây. Thông báo này có nghĩa là
người dùng có tên là "allUsers" không có quyền gọi Hàm đám mây.
Việc cấp cho "allUsers" vai trò "Trình gọi hàm trên đám mây" có nghĩa là Hàm trên đám mây hỗ trợ ứng dụng sẽ đượ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ò.
Lỗi này có thể khiến dự án trên Google Cloud bị hạn chế về miền. Để biết thêm thông tin về các quy tắc ràng buộc 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 sự cố này, hãy xác minh rằng Chức năng đám mây của bạn cho phép chưa được xác thực các lệnh gọi. Để tìm hiểu cách cho phép lệnh gọi chưa được xác thực đối với một lệnh gọi hiện có Chức năng đám mây, tham khảo Cho phép truy cập công khai (chưa được xác thực).