Tạo một ứng dụng Google Chat mà bạn có thể nhắn tin trực tiếp trả lời bằng cách lặp lại tin nhắn của bạn.
Sơ đồ dưới đây minh hoạ cấu trúc và mẫu thông báo:
Trong biểu đồ trên, một người dùng tương tác với một Apps Script Ứng dụng Chat có luồng thông tin sau đây:
- Người dùng gửi tin nhắn đến ứng dụng Chat bằng một tin nhắn trực tiếp hoặc trong phòng Chat.
- Logic của ứng dụng Chat được triển khai trong Apps Script (nằm trong Google Cloud) nhận và xử lý thông báo.
- Logic ứng dụng Chat có thể tích hợp với (không bắt buộc) Các dịch vụ của Google Workspace, chẳng hạn như Lịch hoặc Trang tính hoặc các dịch vụ khác của Google, chẳng hạn như Google Maps hoặc YouTube.
- Logic của ứng dụng Chat gửi lại phản hồi cho Dịch vụ ứng dụng Chat trong Chat.
- Phản hồi được gửi đến người dùng.
Mục tiêu
- Thiết lập môi trường.
- Thiết lập tập lệnh.
- Xuất bản ứng dụng Chat.
- Kiểm thử ứng dụng Chat.
Điều kiện tiên quyết
- Một Google Workspace có quyền truy cập vào Chat.
- Một dự án trên Google Cloud.
Thiết lập môi trường
Mở dự án Cloud trong bảng điều khiển Google Cloud
Mở dự án Cloud mà bạn định sử dụng nếu chưa mở cho mẫu này:
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Chọn dự án.
- Chọn dự án Google Cloud mà bạn muốn sử dụng. Hoặc nhấp vào Tạo dự án rồi làm theo hướng dẫn trên màn hình. Nếu tạo một dự án trên Google Cloud, có thể bạn sẽ phải bật tính năng thanh toán cho dự án đó.
Bật API Chat
Trước khi sử dụng các API của Google, bạn cần bật các API này trong một dự án trên Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án Google Cloud.Trong bảng điều khiển Google Cloud, hãy bật Google Chat API.
Định cấu hình màn hình xin phép bằng OAuth
Tất cả ứng dụng dùng OAuth 2.0 đều cần phải định cấu hình màn hình đồng ý. Đang định cấu hình màn hình xin phép bằng OAuth của ứng dụng sẽ xác định nội dung mà người dùng và ứng dụng nhìn thấy nhân viên đánh giá và đăng ký ứng dụng của bạn để bạn có thể xuất bản ứng dụng đó sau.
- Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > API và Dịch vụ > Màn hình xin phép bằng OAuth.
- Đối với Loại người dùng, hãy chọn Nội bộ, rồi nhấp vào Tạo.
- Hoàn tất biểu mẫu đăng ký ứng dụng, sau đó nhấp vào Lưu và tiếp tục.
Hiện tại, bạn có thể bỏ qua bước thêm phạm vi rồi nhấp vào Lưu và tiếp tục. Trong tương lai, khi bạn tạo một ứng dụng để sử dụng bên ngoài Nếu là tổ chức Google Workspace, bạn phải thay đổi Loại người dùng thành Bên ngoài, sau đó thêm phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu.
- Xem lại bản tóm tắt về gói đăng ký ứng dụng của bạn. Để chỉnh sửa, hãy nhấp vào Chỉnh sửa. Nếu ứng dụng có vẻ ổn, hãy nhấp vào Quay lại trang tổng quan.
Thiết lập tập lệnh
Để thiết lập tập lệnh, bạn sử dụng mẫu rồi đặt Dự án trên đám mây trong Apps Script.
Tạo tập lệnh từ mẫu
- Chuyển đến Trang Bắt đầu của Apps Script.
- Nhấp vào mẫu Ứng dụng Chat. Bạn có thể phải di chuyển xuống để xem mẫu này.
- Nhấp vào Dự án không có tiêu đề, nhập
Quickstart apprồi nhấp vào Đổi tên.
Sao chép số dự án trên đám mây
- Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và Quản trị > Cài đặt.
- Trong trường Project number (Số dự án), hãy sao chép giá trị.
Đặt dự án trên đám mây của dự án Apps Script
- Trong dự án Apps Script của ứng dụng Chat:
nhấp vào biểu tượng Cài đặt dự án
. - Trong mục Dự án Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.
- Trong mục Số dự án GCP, hãy dán số dự án trên Google Cloud.
- Nhấp vào Đặt dự án.
Bây giờ, bạn đã có mã ứng dụng hoạt động để dùng thử (như được mô tả trong các bước sau) rồi tuỳ chỉnh để đáp ứng các yêu cầu của bạn.
Đảm bảo rằng bạn đã đăng nhập vào đúng Tài khoản Google khi mở Mẫu Apps Script. Đôi khi, tài khoản hiện tại có thể chuyển sang tài khoản mặc định của mình mà bạn không biết.
Tạo một đợt triển khai kiểm thử
Bạn cần có mã triển khai cho dự án Apps Script này để bạn có thể dùng trong bước tiếp theo.
Để lấy mã triển khai head, hãy làm như sau:
- Trong dự án Apps Script của ứng dụng Chat: nhấp vào Triển khai > Kiểm thử các đợt triển khai.
- Sao chép Mã triển khai trưởng để sử dụng trong bước sau, rồi nhấp vào Xong.
Xuất bản ứng dụng Chat
Xuất bản ứng dụng Chat từ bảng điều khiển Google Cloud.
- Trong
bảng điều khiển Google Cloud,
tìm
Google Chat APIrồi nhấp vào API Google Chat. - Nhấp vào Quản lý.
Nhấp vào Cấu hình rồi thiết lập ứng dụng Chat:
- Trong trường Tên ứng dụng, hãy nhập
Quickstart app. - Trong trường URL hình đại diện, nhập
https://developers.google.com/chat/images/quickstart-app-avatar.png. - Trong trường Description (Nội dung mô tả), hãy nhập
Quickstart app. - Trong phần Chức năng, hãy chọn Nhận tin nhắn 1:1 và Tham gia các không gian và cuộc trò chuyện nhóm.
- Trong phần Cài đặt kết nối, hãy chọn Dự án Apps Script.
- Trong trường Deployment ID (Mã triển khai), hãy dán Mã triển khai tiêu đề (head triển khai) mà bạn đã sao chép trước đó.
- Trong Chế độ hiển thị, hãy chọn Những người và nhóm cụ thể trong miền rồi nhập email của bạn.
- Trong trường Tên ứng dụng, hãy nhập
Nhấp vào Lưu.
Ứng dụng Chat đã sẵn sàng trả lời tin nhắn.
Kiểm thử ứng dụng Chat
Để kiểm thử ứng dụng Chat, hãy mở một không gian nhắn tin trực tiếp bằng ứng dụng Chat rồi gửi tin nhắn:
Mở Google Chat bằng tài khoản Google Workspace mà bạn khi bạn tự thêm chính mình làm người kiểm tra đáng tin cậy.
- Nhấp vào Cuộc trò chuyện mới.
- Trong trường Thêm 1 hoặc nhiều người, nhập tên của Ứng dụng Chat.
Chọn ứng dụng Chat của bạn trong kết quả. Người trực tiếp tin nhắn sẽ mở ra.
Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập
Hellovà nhấnenter.Ứng dụng Chat cảm ơn bạn đã thêm ứng dụng này và tạo tiếng vang tin nhắn của bạn.
Để thêm người kiểm tra đáng tin cậy và tìm hiểu thêm về cách kiểm thử các tính năng tương tác, hãy xem Kiểm thử các tính năng tương tác cho Ứng dụng Google Chat.
Khắc phục sự cố
Khi một ứng dụng Google Chat hoặc card trả về một lỗi, thì phương thức Giao diện Chat hiển thị một thông báo với nội dung "Đã xảy ra lỗi". hoặc "Không thể xử lý yêu cầu của bạn". Đôi khi, giao diện người dùng của Chat không hiện thông báo lỗi nào ngoài ứng dụng Chat hoặc thẻ tạo ra kết quả không mong muốn; ví dụ: thông báo thẻ có thể không xuất hiện.
Mặc dù thông báo lỗi có thể không xuất hiện trong giao diện người dùng Chat, thông báo lỗi mô tả và dữ liệu nhật ký luôn có sẵn để giúp bạn sửa lỗi khi tính năng ghi nhật ký lỗi cho các ứng dụng trong Chat được bật. Để được trợ giúp xem, gỡ lỗi và sửa lỗi, hãy xem Khắc phục lỗi và khắc phục lỗi của Google Chat.
Dọn dẹp
Để tránh bị tính phí vào tài khoản Google Cloud của bạn cho tài nguyên được sử dụng trong hướng dẫn này, chúng tôi khuyên bạn nên xóa Dự án trên đám mây.
- Trong bảng điều khiển Google Cloud, hãy chuyển đến trang Quản lý tài nguyên. Nhấp chuột Thực đơn > IAM và Quản trị viên > Quản lý tài nguyên.
- Trong danh sách dự án, hãy chọn dự án mà bạn muốn xoá rồi nhấp vào Xoá .
- Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Tắt để xoá dự án.
Các bước tiếp theo
- Tạo thẻ tương tác–Thẻ thông báo sẽ hỗ trợ một bố cục xác định, các phần tử tương tác trên giao diện người dùng như nút và nội dung đa phương tiện như hình ảnh. Dùng thông báo thẻ để trình bày thông tin chi tiết, thu thập thông tin từ người dùng và hướng dẫn họ thực hiện bước tiếp theo.
- Hỗ trợ lệnh dấu gạch chéo– Lệnh trượt cho phép
bạn đăng ký và quảng cáo các lệnh cụ thể mà người dùng có thể cung cấp cho ứng dụng của mình
bằng cách nhập một lệnh bắt đầu bằng dấu gạch chéo lên (
/), chẳng hạn như/help. - Hộp thoại mở – Hộp thoại ở dạng cửa sổ, dựa trên thẻ mà ứng dụng của bạn có thể mở để tương tác với người dùng. Nhiều thẻ có thể được xâu chuỗi lại với nhau theo tuần tự, giúp người dùng hoàn tất nhiều bước chẳng hạn như điền dữ liệu vào biểu mẫu.
- Lớp học lập trình: Sẵn sàng xây dựng một lớp học nâng cao hơn Ứng dụng Chat? Xem phản hồi Ứng dụng Chat từ lớp học lập trình Tạo ứng dụng cho Google Chat bằng Gemini.