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 trê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 "Ứ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 Google Cloud Console, 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 ứng dụng, hãy đảm bảo rằng bạn đã 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 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 bạn đã thiết lập đú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 và đã triển khai các thông tin này.
- 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 ứng dụng được triển khai bằng SDK 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 Google Workspace Marketplace sẽ được ưu tiên.
Nếu ứng dụng được phát hành 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ử gửi lại tin nhắn 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
. 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 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ý Chat, thì đôi khi người dùng có thể 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 chế độ cài đặt nhật ký trò chuyện của một người dùng được buộc "bật" và chế độ cài đặt nhật ký trò chuyện của một không gian được buộc "tắt", thì người dùng đó có thể không thể tham gia 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 một ứng dụng trong Chat vào không gian, thì lỗi này có thể do một trong những lý do sau gây ra:
- Tổ chức đã tắt ứ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 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ì nguyên nhân có thể là do tổ chức cấp quyền truy cập cho một đơn vị tổ chức con mà không bật ứng dụng đó 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 nhắn tin.
Quản trị viên phải cấp cho ứng dụng phạm vi uỷ quyền OAuth bắt buộc 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
cho phép ứ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 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.bot
không yêu cầu quản trị viên phê duyệt, hãy cân nhắc sử dụng phương thức đó. Để 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 nhưng không hoạt động, các phần sau đây sẽ giúp bạn 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 Google Cloud Console, hãy chuyển đến trang Cloud Functions:
Để mở nhật ký, hãy tìm Chức năng đám mây của ứng dụng Chat, sau đó nhấp vào Hiện 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 tính năng ghi nhật ký bổ sung từ mã Hàm đám mây. Xem phần Xem và ghi nhật ký Chức năng đám mây.
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 hàm, các lỗi được liệt kê trong mục Lỗi.
Để tiếp tục khắc phục lỗi, hãy nhấp vào lỗi đó.
Khắc phục các lỗi thường gặp với Hàm trên đám mây
Đôi khi, sẽ xảy ra các lỗi sau đây khi xây dựng ứ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 Hàm trên đá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 trên đám mây khác có cùng tên với hàm mà bạn đang triển khai. Thay đổ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 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 "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 vấn đề này, hãy xác minh rằng Hàm trên đám mây của bạn cho phép các lệnh gọi chưa xác thực. Để tìm hiểu cách cho phép các lệnh gọi chưa xác thực cho một Hàm trên đám mây hiện có, hãy tham khảo phần Cho phép quyền truy cập công khai (chưa xác thực).