Khắc phục và khắc phục lỗi của ứng dụng Google Chat

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à kiểm thử ứng dụng 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ư dự kiến

Để được trợ giúp khắc phục lỗi thẻ, hãy xem bài viết Khắc phụ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:

  1. Trong Google API Console, hãy nhấp vào Menu > API và Dịch vụ > API và Dịch vụ đã bật > Google Chat API > Cấu hình.

    Chuyển đến phần cấu hình Chat API

  2. 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 – dành cho người dùng.

  3. 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 Bật tính năng tương tác:

    1. 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.
    2. 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.
    3. Trong phần Chế độ cài đặt kết nối, hãy đảm bảo rằng URL điểm cuối HTTP, dự án Apps Script Mã triển khai, Cloud Pub/Sub Tên chủ đề hoặc tác nhân Dialogflow được đặt đúng cách và đã được triển khai.
    4. Trong phần Chế năng hiển thị, hãy đảm bảo rằng 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 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ì không cần chế độ cài đặt hiển thị vì chế độ cài đặt của Google Workspace Marketplace sẽ được ưu tiên.

  4. Nếu ứng dụng được xuất bản bằng SDK Google Workspace Marketplace, hãy xem lại chế độ cài đặt của Google Workspace Marketplace.

  5. Nhấp vào Lưu.

  6. Thử nhắn tin cho ứng dụng một lần nữa.

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ể nhận được 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 Chat API, 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 ứ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 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ý Chat, thì có thể có những trường hợp 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 một người dùng có chế độ cài đặt nhật ký trò chuyện bị buộc "bật" 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 vào 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 một 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 chế độ cài đặt nhật ký trò chuyện, Chat API có thể không tạo được tư cách thành viên hoặc việc tạo tin nhắn bằng tính năng 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 Chat 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ụ 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 ứng dụng Chat vào không gian, thì lỗi này có thể do một trong những lý do sau:

  • Tổ chức đã tắt 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 thông báo lỗi này khi cố gắng tương tác với ứ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 con 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 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 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ể nhận được 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:

Khắc phục lỗi Cloud Functions

Nếu ứng dụng Chat được triển khai bằng Cloud Functions và không hoạt động, thì các phần sau đây sẽ giúp khắc phục sự cố và sửa lỗi.

Kiểm tra nhật ký Cloud Functions

Bước đầu tiên là kiểm tra nhật ký Cloud Functions để tìm lỗi.

  1. Trong Google API Console, hãy chuyển đến trang Cloud Functions:

    Chuyển đến Cloud Functions

  2. Để mở nhật ký, hãy tìm Cloud Functions của ứng dụng Chat, sau đó nhấp vào Hiển thị 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 hiển thị nhật ký 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 tính năng ghi nhật ký bổ sung từ mã Cloud Functions. Xem bài viết Xem và ghi nhật ký Cloud Functions.

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.

  1. Trong Google API Console, hãy chuyển đến trang Cloud Functions:

    Chuyển đến Cloud Functions

  2. Nhấp vào Cloud Functions của ứng dụng Chat.

  3. Trên trang thông tin chi tiết Hàm, các lỗi được liệt kê trong phần Lỗi.

  4. Để 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 của Cloud Functions

Đôi khi, bạn sẽ gặp phải các lỗi sau đây khi tạo ứng dụng Chat bằng Cloud Functions.

Hàm ChatApp trong khu vực REGION_NAME trong dự án PROJECT_NAME đã tồn tại

Khi triển khai Cloud Functions, bạn có thể nhận được 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 Functions khác có cùng tên với Cloud Functions mà bạn đang triển khai. Hãy đổ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 Functions của bạn, chứ không phải URL kích hoạt của Cloud Functions đã tồn tại.

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ề một khách hàng được phép

Khi triển khai Cloud Functions, 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 bạn 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 Functions. 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 Functions. Việc cấp cho "allUsers" vai trò "Cloud Functions Invoker" (Trình gọi Cloud Functions) có nghĩa là Cloud Functions cung cấp năng lượng cho ứng dụng được 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 bài viết Cấp một vai trò duy nhất.

Lỗi này có thể có nghĩa là dự án trên đám mây của Google bị hạn chế theo miền. Để biết thêm thông tin về cá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 Cloud Functions 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 Cloud Functions hiện có, hãy tham khảo bài viết Cho phép truy cập công khai (chưa xác thực).