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 mở rộng Chat có thể 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à 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 với người dùng dưới dạng ứng dụng Google Chat. Để tương tác với người dùng, ứng dụng Chat có thể làm như sau:
- Gửi thông báo chứa văn bản, thẻ và các phần tử giao diện người dùng tương tác.
- 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 các thẻ có thông tin hữu ích để người dùng có thể hành động ngay trong cuộc trò chuyện.
Bắt đầu
Để bắt đầu xây dựng các tiện ích bổ sung của 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 ứ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 các cách bạn có thể tạo giao diện Chat bằng cách sử dụng các trình kích hoạt, hành động 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 tính năng Trò chuyện và tiện ích bổ sung không hoạt động:
- Dialogflow và Pub/Sub. Bạn phải tạo các tiện ích bổ sung mở rộng Chat bằng Apps Script hoặc dịch vụ HTTP.
- Card Service (Dịch vụ thẻ) của Apps Script. Để sử dụng Thao tác trò chuyện và tạo thẻ, hãy trả về các đối tượng JSON. Để biết 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ủ tiện ích bổ sung trong thanh bên của ứng dụng Chat. Nếu bạn đã định cấu hình 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 trong ứ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 các ứng dụng Chat:
- Chế độ cài đặt của 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 phổ biến 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. - Nếu đang xây dựng bằng dịch vụ HTTP, bạn phải bật API tiện ích bổ sung của Google Workspace. Các tài nguyên REST
deploymentvàprojectchỉ áp dụng cho các hoạt động triển khai tiện ích bổ sung trong các ứng dụng khác của Google Workspace. - Để triển khai và kiểm thử tiện ích bổ sung trong Chat, bạn phải sử dụng chế độ cài đặt Chế độ hiển thị của Chat API. Mọi chế độ cài đặt chế độ hiển thị hoặc thử nghiệm mà bạn đã định cấu hình trong SDK Google Workspace Marketplace 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ề API Chat.
- Nếu tiện ích bổ sung của bạn được phát hành trên Google Workspace Marketplace, bạn sẽ không thể lưu bản nháp của mọi thay đổi đối với chế độ cài đặt cấu hình API Google Chat. 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 trên trang web thương mại, bạn có thể tạo bản nháp trước khi gửi nội dung thay đổi.