Tạo ứng dụng Google Chat bằng Google Apps Script

Tạo một ứng dụng Google Chat mà bạn có thể nhắn tin trực tiếp và ứng dụng này sẽ phản hồi bằng cách lặp lại tin nhắn của bạn.

Sơ đồ sau đây cho thấy cấu trúc và mẫu thông báo:

Trong sơ đồ trước, người dùng tương tác với ứng dụng Chat trong Apps Script có luồng thông tin sau:

1. Người dùng gửi tin nhắn đến một ứng dụng Chat, trong tin nhắn trực tiếp hoặc trong phòng Chat.
2. Logic ứng dụng Chat được triển khai trong Apps Script (nằm trong Google Cloud) sẽ nhận và xử lý tin nhắn.
3. Nếu muốn, logic ứng dụng Chat có thể tích hợp với 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.
4. Logic ứng dụng Chat sẽ gửi phản hồi về dịch vụ ứng dụng Chat trong Chat.
5. Nội dung 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.
• Phát hành ứng dụng Chat.
• Kiểm thử ứng dụng Chat.

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

• Tài khoản Google Workspace dành cho doanh nghiệp hoặc doanh nghiệp lớn có quyền truy cập vào Google Chat.
• Một dự án trên Google Cloud. Để tạo một dự án, hãy xem phần Tạo dự án trên Google Cloud.

Thiết lập môi trường

Mở dự án trên Google Cloud trong Google Cloud Console

Nếu chưa mở, hãy mở dự án trên Google Cloud mà bạn dự định sử dụng cho mẫu này:

1. Trong Google Cloud Console, hãy chuyển đến trang Chọn một dự án.

   Chọn một dự án trên Đám mây

2. 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 dự án trên Google Cloud, bạn có thể cần phải bật tính năng thanh toán cho dự án đó.

Bật Chat API

Trước khi sử dụng API của Google, bạn cần bật các API đó trong một dự án Google Cloud. Bạn có thể bật một hoặc nhiều API trong một dự án Google Cloud.

• Trong Google Cloud Console, hãy bật API Google Chat.

  Bật API

Định cấu hình màn hình xin phép bằng OAuth

Tất cả ứng dụng sử dụng OAuth 2.0 đều phải có cấu hình màn hình đồng ý. Việc đị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 hiển thị cho người dùng và người đánh giá ứng dụng, đồng thời đăng ký ứng dụng để bạn có thể phát hành ứng dụng sau này.

1. Trong Google Cloud Console, hãy chuyển đến Trình đơn menu > API và dịch vụ > Màn hình đồng ý OAuth.

   Chuyển đến màn hình xin phép bằng OAuth

2. Đối với Loại người dùng, hãy chọn Nội bộ, sau đó nhấp vào Tạo.
3. 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.

4. Hiện tại, bạn có thể bỏ qua bước thêm phạm vi và nhấp vào Lưu và tiếp tục. Trong tương lai, khi tạo một ứng dụng để sử dụng bên ngoài 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 các phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu.

5. Xem lại thông tin tóm tắt về việc đăng ký ứng dụng. Để chỉnh sửa, hãy nhấp vào Chỉnh sửa. Nếu quá trình đăng ký ứ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ột mẫu, sau đó thiết lập dự án trên Google Cloud Platform trong Apps Script.

Tạo tập lệnh từ mẫu

1. Chuyển đến trang Bắt đầu của Apps Script.
2. Nhấp vào mẫu Ứng dụng trò chuyện ở cuối trang.
3. Nhấp vào Untitled project (Dự án không có tiêu đề), nhập Quickstart app rồi nhấp vào Rename (Đổi tên).

Sao chép số dự án trên Cloud

1. Trong Google Cloud Console, hãy chuyển đến Trình đơn menu > IAM & Admin (Quản trị viên và quản lý quyền truy cập) > Settings (Cài đặt).

   Chuyển đến phần IAM và Cài đặt quản trị

2. Trong trường Mã dự án, hãy sao chép giá trị.

Thiết lập dự án trên Cloud của dự án Apps Script

1. Trong dự án Chat Apps Script, hãy nhấp vào Project Settings (Cài đặt dự án) .
2. Trong phần Dự án trên Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.
3. Trong mục Số dự án GCP, hãy dán số dự án trên Google Cloud.
4. Nhấp vào Đặt dự án.

Giờ đây, bạn có thể thử nghiệm mã ứng dụng đang hoạt động (như mô tả trong các bước sau) rồi tuỳ chỉnh để đáp ứng yêu cầu của mình.

Đảm bảo 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 mà bạn không nhận thấy.

Tạo một bản triển khai kiểm thử

Bạn cần có mã nhận dạng triển khai cho dự án Apps Script này để có thể sử dụng mã nhận dạng đó ở bước tiếp theo.

Để lấy mã hoạt động triển khai đầu, hãy làm như sau:

1. Trong dự án Chat app Apps Script, hãy nhấp vào Deploy (Triển khai) > Test deployments (Kiểm thử bản triển khai).
2. Sao chép Mã triển khai đầu để sử dụng trong bước sau rồi nhấp vào Xong.

Phát hành ứng dụng Chat

Phát hành ứng dụng Chat từ bảng điều khiển.

1. Trong bảng điều khiển, hãy tìm Google Chat API rồi nhấp vào Google Chat API.
2. Nhấp vào Quản lý.

3. Nhấp vào Cấu hình rồi thiết lập ứng dụng Chat:

   1. Trong trường App name (Tên ứng dụng), hãy nhập Quickstart app.
   2. Trong trường Avatar URL (URL hình đại diện), hãy nhập https://developers.google.com/chat/images/quickstart-app-avatar.png.
   3. Trong trường Description (Mô tả), hãy nhập Quickstart app.
   4. Trong phần Chức năng, hãy chọn Nhận tin nhắn 1:1 và Tham gia không gian và cuộc trò chuyện nhóm.
   5. Trong phần Cài đặt kết nối, hãy chọn Apps Script (Tập lệnh ứng dụng).
   6. Trong trường Mã triển khai, hãy dán mã triển khai Head mà bạn đã sao chép trước đó.
   7. Trong phần Mức độ hiển thị, hãy chọn Những người và nhóm cụ thể trong miền của bạn rồi nhập email của bạn.

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

Ứng dụng Chat đã sẵn sàng phản hồ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 tin nhắn trực tiếp bằng ứng dụng Chat và gửi tin nhắn:

1. Mở Google Chat bằng tài khoản Google Workspace mà bạn đã cung cấp khi thêm chính mình làm người kiểm thử đáng tin cậy.

   Chuyển đến Google Chat

2. Nhấp vào add Cuộc trò chuyện mới.
3. Trong trường Thêm 1 người trở lên, hãy nhập tên của ứng dụng Chat.

4. Chọn ứng dụng Chat trong kết quả. Một tin nhắn trực tiếp sẽ mở ra.

5. Trong tin nhắn trực tiếp mới với ứng dụng, hãy nhập Hello rồi nhấn enter.

   Ứng dụng Chat cảm ơn bạn đã thêm ứng dụng đó và lặp lại thông báo của bạn.

Để thêm người kiểm thử đá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 bài viết 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 ứng dụng Google Chat hoặc thẻ trả về lỗi, giao diện Chat sẽ hiển thị thông báo "Đã 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 Chat không hiển thị thông báo lỗi nào, nhưng ứng dụng Chat hoặc thẻ lại 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 hiển thị trong giao diện người dùng Chat, nhưng bạn có thể xem thông báo lỗi mô tả và dữ liệu nhật ký để khắc phục lỗi khi bật tính năng ghi nhật ký lỗi cho ứng dụng Chat. Để được trợ giúp xem, gỡ lỗi và khắc phục lỗi, hãy xem bài viết Khắc phục và khắc phục lỗi Google Chat.

Dọn dẹp

Để tránh bị tính phí cho tài khoản Google Cloud của bạn đối với các tài nguyên được sử dụng trong hướng dẫn này, bạn nên xoá dự án trên Google Cloud.

1. Trong Google Cloud Console, hãy chuyển đến trang Quản lý tài nguyên. Nhấp vào biểu tượng Trình đơn menu > IAM và quản trị > Quản lý tài nguyên.

   Chuyển đến Trình quản lý tài nguyên

2. Trong danh sách dự án, hãy chọn dự án bạn muốn xoá rồi nhấp vào biểu tượng Xoá delete.
3. Trong hộp thoại, hãy nhập mã dự án rồi nhấp vào Shut down (Tắt) để xoá dự án.

Các bước tiếp theo

• Tạo thẻ tương tác – Thông báo dạng thẻ hỗ trợ bố cục đã xác định, các thành phần giao diện người dùng tương tác như nút và nội dung đa phương tiện đa dạng thức như hình ảnh. Sử 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 người dùng thực hiện bước tiếp theo.
• Hỗ trợ lệnh dấu gạch chéo – Lệnh dấu gạch chéo 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ể đưa ra cho ứng dụng của bạn 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 khởi chạy – Hộp thoại là giao diện 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. Bạn có thể nối nhiều thẻ với nhau theo tuần tự để 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.
• code Lớp học lập trình: Bạn đã sẵn sàng xây dựng một ứng dụng Chat nâng cao hơn? Xem ứng dụng Chat phản hồi từ lớp học lập trình Tạo ứng dụng cho Google Chat bằng Gemini.