Định cấu hình ứng dụng Google Chat

Trang này giải thích cách định cấu hình và triển khai ứng dụng Google Chat dưới dạng tiện ích bổ sung Google Workspace.

Để triển khai và thử nghiệm tiện ích bổ sung Google Workspace mở rộng Chat, bạn phải bật và định cấu hình ứng dụng Chat bằng API Google Chat. Các chế độ cài đặt cấu hình API Chat là nơi bạn chỉ định tất cả thông tin chi tiết về ứng dụng Chat, bao gồm tên, hình đại diện, quá trình triển khai và các tính năng tương tác mà bạn muốn sử dụng.

Điều kiện tiên quyết

Chọn tên hiển thị, hình đại diện và nội dung mô tả cho ứng dụng Chat

Tên, hình đại diện và nội dung mô tả của ứng dụng Chat sẽ xuất hiện với người dùng trong giao diện người dùng của Chat. Để tương tác với các ứng dụng Chat, người dùng sẽ thấy hoặc sử dụng thông tin này theo những cách sau:

  • @đề cập đến ứng dụng Chat để thêm ứng dụng đó vào một không gian hoặc gửi tin nhắn cho ứng dụng đó.
  • Tìm và bắt đầu tin nhắn trực tiếp với ứng dụng Chat. Trong trình đơn Ứng dụng, tin nhắn trực tiếp sẽ hiển thị tên và hình đại diện của ứng dụng Chat.
  • Trên thanh soạn tin, người dùng có thể duyệt xem các ứng dụng Chat và xem tên, hình đại diện và nội dung mô tả của các ứng dụng đó.

Trước khi định cấu hình ứng dụng Chat, bạn phải chuẩn bị các thông tin sau:

Trường Mô tả Định dạng
Tên ứng dụng Tên hiển thị của ứng dụng Chat. Tối đa 25 ký tự chữ và số
URL hình đại diện Hình ảnh xuất hiện dưới dạng hình đại diện của ứng dụng Chat avatar. URL HTTPS trỏ đến hình ảnh đồ hoạ hình vuông (PNG hoặc JPEG). Kích thước đề xuất là 256 x 256 pixel trở lên.
Mô tả Nội dung mô tả ngắn gọn về mục đích của ứng dụng Chat. Tối đa 40 ký tự chữ và số

Trong phần sau, bạn sẽ chỉ định thông tin này trong các chế độ cài đặt cấu hình trong API Chat.

Định cấu hình ứng dụng Chat trong bảng điều khiển Cloud

Trong bảng điều khiển Cloud của Google, bạn sẽ định cấu hình thông tin chi tiết về ứng dụng Chat xuất hiện với người dùng trong Chat, bao gồm tên hiển thị, hình đại diện và nội dung mô tả. Những thông tin chi tiết này chỉ xuất hiện trong Chat. Để xuất bản ứng dụng Chat lên Marketplace, bạn cũng phải chỉ định thông tin chi tiết xuất hiện trong trang thông tin của ứng dụng Chat trên Marketplace.

Khi có chi tiết ứng dụng Chat, hãy mở dự án trên đám mây và định cấu hình API Chat:

  1. Trong bảng điều khiển Google Cloud, hãy chuyển đến trang API Chat rồi nhấp vào trang Cấu hình:

    Chuyển đến trang Cấu hình API Chat

  2. Trong phần Thông tin ứng dụng, hãy điền thông tin vào các trường Tên ứng dụng, URL hình đại diện, và Nội dung mô tả.

  3. Trong phần Tính năng tương tác, hãy nhấp vào Bật tính năng tương tác để chuyển sang vị trí bật rồi hoàn tất các bước sau:

    1. Trong phần Chức năng, hãy chọn Tham gia không gian và cuộc trò chuyện nhóm để người dùng có thể cài đặt và sử dụng ứng dụng Chat.

      Theo mặc định, người dùng có thể cài đặt và nhắn tin với ứng dụng Chat trong một không gian riêng giữa người dùng và ứng dụng Chat. Người dùng cũng có thể thêm và tương tác với ứng dụng Chat trong các không gian có nhiều người.

    2. Trong phần Cài đặt kết nối, hãy chọn kiến trúc mà bạn muốn sử dụng để nhận các đối tượng sự kiện từ Chat:

      • Để sử dụng dịch vụ HTTP, hãy chọn URL điểm cuối HTTP rồi cung cấp một URL.
      • Để sử dụng dự án Google Apps Script, hãy chọn Apps Script rồi cung cấp mã nhận dạng quá trình triển khai cho dự án.
      • Để sử dụng nhân viên hỗ trợ Dialogflow, hãy chọn Dialogflow, chọn Dialogflow CX hoặc Dialogflow ES rồi cung cấp tên tài nguyên của nhân viên hỗ trợ.
      • Để sử dụng Pub/Sub, hãy chọn Cloud Pub/Sub rồi nhập tên chủ đề.

    3. Không bắt buộc: Để nhận các đối tượng sự kiện đến nhiều điểm cuối hoặc hàm, hãy chuyển đến phần Cài đặt kết nối > Trình kích hoạt rồi cung cấp hoặc cập nhật các hàm gọi lại cho các trình kích hoạt Chat sau:

      • Đã thêm vào không gian: Người dùng thêm ứng dụng Chat vào một cuộc trò chuyện nhóm hoặc không gian, hoặc cài đặt ứng dụng Chat cho tin nhắn 1:1.
      • Tin nhắn: Người dùng gửi tin nhắn cho ứng dụng Chat. Ví dụ: gửi tin nhắn trực tiếp cho ứng dụng Chat hoặc @đề cập đến ứng dụng Chat trong một không gian có nhiều người.
      • Đã xoá khỏi không gian: Người dùng gỡ cài đặt hoặc xoá ứng dụng Chat khỏi một không gian.
      • Lệnh ứng dụng: Người dùng sử dụng lệnh nhanh hoặc lệnh dấu gạch chéo từ ứng dụng Chat.

    4. Không bắt buộc: Thêm các tính năng tương tác khác, chẳng hạn như lệnh nhanh, lệnh dấu gạch chéo, hoặc bản xem trước đường liên kết.

    5. Trong phần Khả năng hiển thị, hãy chỉ định email của bạn để bạn có thể cài đặt và thử nghiệm ứng dụng Chat trước khi xuất bản lên Google Workspace Marketplace. Bạn có thể chỉ định tối đa 5 cá nhân hoặc một hoặc nhiều Nhóm Google trong tổ chức Google Workspace của bạn.

  4. Không bắt buộc: Trong phần Nhật ký, hãy đánh dấu vào hộp Ghi lại lỗi vào Cloud Logging để sử dụng Cloud Logging. Để biết thêm thông tin, hãy xem bài viết Truy vấn nhật ký lỗi cho các ứng dụng Chat trong tài liệu về API Chat.

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

Sau khi bạn lưu cấu hình, bất kỳ ai mà bạn chỉ định trong chế độ cài đặt Khả năng hiển thị của API Chat đều có thể cài đặt, thử nghiệm hoặc sử dụng ứng dụng Chat. Để bắt đầu thử nghiệm và gỡ lỗi ứng dụng Chat, hãy xem bài viết Thử nghiệm các tính năng tương tác cho ứng dụng Google Chat trong tài liệu về API Chat.

Những điều cần cân nhắc đối với các tiện ích bổ sung Google Workspace hiện có

Các ứng dụng Chat yêu cầu cấu hình khác so với các tiện ích bổ sung Google Workspace mở rộng các ứng dụng khác của Google Workspace. Nếu tiện ích bổ sung của bạn mở rộng các ứng dụng khác của Google Workspace, hãy cân nhắc các yêu cầu sau để định cấu hình ứng dụng Chat:

  • Cả cá nhân và quản trị viên Google Workspace đều phải có thể cài đặt tiện ích bổ sung của bạn trên Marketplace. Bạn định cấu hình các chế độ cài đặt cài đặt này trong SDK Google Workspace Marketplace.
  • Các ứng dụng Chat không sử dụng tên và biểu trưng mà bạn định cấu hình cho các ứng dụng khác của Google Workspace trong đối tượng addons.common của tệp kê khai.
  • Đối với các tiện ích bổ sung được xuất bản lên Google Workspace Marketplace, bạn không thể lưu bản nháp của bất kỳ thay đổi nào đối với các chế độ cài đặt cấu hình API Google Chat. Sau khi bạn cập nhật và lưu các chế độ cài đặt cấu hình API Chat, ứng dụng Chat đã cập nhật sẽ có sẵn cho tất cả người dùng hiện tại. Để cập nhật trang thông tin của bạn trên Marketplace, bạn có thể tạo bản nháp trước khi gửi mọi thay đổi.

  • Nếu bạn tạo tiện ích bổ sung bằng Apps Script:

  • Nếu bạn tạo tiện ích bổ sung bằng dịch vụ HTTP, hãy bỏ qua mọi thông tin chi tiết về cấu hình ứng dụng Chat trong tệp kê khai và các quá trình triển khai mà bạn tạo bằng API tiện ích bổ sung Google Workspace. Các quá trình triển khai HTTP mà bạn chỉ định trong SDK Google Workspace Marketplace chỉ được dùng cho các ứng dụng khác của Google Workspace.