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