Trang này cung cấp thông tin tổng quan về cách tạo tiện ích bổ sung cho Google Workspace để mở rộng Google Chat.
Các tiện ích bổ sung của Google Workspace có thể mở rộng Chat và giúp người dùng làm bất kỳ việc nào sau đây:
- Xem trước đường liên kết trong tin nhắn trên Chat và thực hiện hành động mà không cần rời khỏi cuộc trò chuyện.
- Tự động hoá hoặc thực hiện các thao tác trên các ứng dụng của Google Workspace.
- Nhận cảnh báo hoặc thông báo về các công cụ hoặc dịch vụ bên ngoài.
Cách tiện ích bổ sung của Google Workspace hoạt động trong Chat
Trong Chat, tiện ích bổ sung sẽ xuất hiện dưới dạng ứng dụng Google Chat đối với người dùng. Để tương tác với người dùng, các ứng dụng Chat có thể làm như sau:
- Gửi tin nhắn có chứa văn bản, thẻ và các phần tử tương tác trên giao diện người dùng.
- Trả lời lệnh nhanh.
- Phản hồi lệnh dấu gạch chéo.
- Mở hộp thoại để giúp người dùng hoàn tất các quy trình nhiều bước, chẳng hạn như điền dữ liệu vào biểu mẫu.
- Xem trước đường liên kết trong tin nhắn bằng cách đính kèm thẻ chứa thông tin hữu ích để người dùng có thể thực hiện hành động ngay trong cuộc trò chuyện.
Bắt đầu
Để bắt đầu tạo các tiện ích bổ sung cho Google Workspace hoạt động trong Chat, hãy xem tài liệu sau:
- Hãy thử hướng dẫn bắt đầu nhanh để tạo một ứng dụng Chat cơ bản bằng Google Apps Script hoặc dịch vụ HTTP.
- Định cấu hình một ứng dụng Chat và các tính năng tương tác của ứng dụng đó bằng API Chat.
- Tìm hiểu về những cách bạn có thể tạo giao diện Trò chuyện bằng cách sử dụng các trình kích hoạt, thao tác và đối tượng sự kiện của tiện ích bổ sung.
Các hạn chế và vấn đề đã biết
Các tính năng sau đây của Chat và tiện ích bổ sung không hoạt động:
- Các cấu trúc ứng dụng Chat Dialogflow, Pub/Sub và AppSheet hiện không dùng được. Thay vào đó, bạn phải tạo ứng dụng Chat bằng Apps Script hoặc một dịch vụ HTTP.
- Dịch vụ thẻ của Apps Script. Để sử dụng Thao tác trong cuộc trò chuyện và tạo thẻ, hãy trả về các đối tượng JSON. Để xem ví dụ, hãy xem phần Mở hộp thoại tương tác và Xem trước đường liên kết.
- Thẻ uỷ quyền tuỳ chỉnh. Để xác thực và cấp quyền cho dịch vụ của bạn từ Chat, ứng dụng Chat phải trả về một thẻ uỷ quyền cơ bản.
- Trang chủ của tiện ích bổ sung trong thanh bên của Chat. Nếu bạn đã định cấu hình một trình kích hoạt trang chủ cho tiện ích bổ sung, thì trang chủ sẽ chỉ xuất hiện trong thanh bên của các ứng dụng Google Workspace khác mà tiện ích bổ sung của bạn mở rộng.
- Trang chủ của ứng dụng Chat xuất hiện trong thẻ Trang chủ của tin nhắn trực tiếp bằng ứng dụng Chat.
Nếu bạn đang cập nhật một tiện ích bổ sung hiện có của Google Workspace, hãy cân nhắc các yêu cầu về cấu hình sau đây đối với ứng dụng Chat:
- Chế độ cài đặt khi cài đặt Google Workspace Marketplace phải cho phép cả cá nhân và quản trị viên Google Workspace cài đặt tiện ích bổ sung.
- Mọi chế độ cài đặt cấu hình chung trong tệp kê khai (
addons.common
) của tiện ích bổ sung đều bị bỏ qua trong Chat. Để định cấu hình tiện ích bổ sung hoạt động trong Chat, bạn phải bật và định cấu hình Chat API. Để biết các bước, hãy xem phần Định cấu hình ứng dụng Google Chat. - Để triển khai và kiểm thử một tiện ích bổ sung trong Chat, bạn phải sử dụng chế độ cài đặt Visibility (Khả năng hiển thị) của Chat API. Mọi chế độ cài đặt về khả năng hiển thị hoặc kiểm thử mà bạn đã định cấu hình trong Google Workspace Marketplace SDK đều sẽ bị bỏ qua. Để triển khai phiên bản thử nghiệm của tiện ích bổ sung trong Chat, hãy xem phần Kiểm thử các tính năng tương tác cho ứng dụng Google Chat trong tài liệu về Chat API.
- Nếu tiện ích bổ sung của bạn được xuất bản lên Google Workspace Marketplace, thì bạn không thể lưu bản nháp của bất kỳ thay đổi nào đối với chế độ cài đặt cấu hình Google Chat API. Khi bạn cập nhật chế độ cài đặt cấu hình Chat API, tất cả người dùng hiện tại sẽ có thể sử dụng ứng dụng Chat đã cập nhật ngay lập tức. Để 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.