Phần này mô tả các vấn đề thường gặp mà bạn có thể gặp phải khi tạo và thử nghiệm ứng dụng trong Chat.
Thông báo thẻ, hộp thoại hoặc bản xem trước đường liên kết không hiển thị hoặc 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 – 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 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:
- 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 bạn đặt URL ứng dụng, Mã triển khai của dự án Apps Script, Tên chủ đề trên Cloud Pub/Sub hoặc tác nhân Dialogflow đượ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ể nhận được
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 một
hoặc dùng API Chat, bạn phải sử dụng
Google Workspace
tài khoản.
Xin lưu ý rằng người dùng Google Chat có thể dùng các ứng dụng trong 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 nhắn tin, xem phần Xuất bản Ứ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 buộc phải "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ị loại bỏ khỏi không gian nếu họ đã tham gia trước khi xung đột xảy ra, sau đó họ đă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 tình huống 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 một tin nhắn có quy trình xác thực người dùng có thể xoá người dùng đã xác thực bằng 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 trừ 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ụ 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 không gian, lỗi này
có thể là do một trong những nguyên nhân sau gây ra:
- Tổ chức đã tắt các ứng dụng trong 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.
Khắc phục lỗi về Hàm đá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
Bước đầu tiên, hãy kiểm tra nhật ký 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ý Chức năng đám mây, bao gồm .
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 về Hàm đám mây
Ngoài nhật ký, Chức năng đám mây cũng có thể báo cáo lỗi gặp phải khi đang 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 đá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.
Để 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ề Hàm đám mây
Đôi khi gặp phải các lỗi sau đây khi tạo Ứng dụng nhắn tin có Cloud Functions.
Hàm ChatApp ở khu vực REGION_NAME trong dự án PROJECT_NAME đã tồn tại
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 đám mây của bạn chứ không phải URL kích hoạt của hàm đám mây 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ề khách hàng được cho phép
Khi triển khai một Chức năng đá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 thì bạn hãy thông báo
Trong ứng dụng Chat, bạn gặp lỗi cho biết ứng dụng không phản hồi do Google
Chat không thể kết nối với máy chủ lưu trữ Chức năng đá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.
Cung cấp "allUsers" "Trình gọi hàm đám mây" có nghĩa là Đám mây
Hàm hỗ trợ ứng dụng có sẵn công khai và có thể truy cập được mà không cần
xác thực. Để tìm hiểu cách chỉ định vai trò, hãy xem
Cấp cho 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. Cho thông tin khác về những ràng buộc hạn chế đối với miền, hãy tham khảo Giới hạn 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).