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 đó 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 nhắn tin:

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

1. Người dùng gửi tin nhắn đến một ứng dụng Chat, có thể là tin nhắn trực tiếp hoặc trong một phòng Chat.
2. Logic của ứ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. Ngoài ra, logic của ứ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 của ứng dụng Chat sẽ gửi phản hồi trở lại dịch vụ ứng dụng Chat trong Chat.
5. Câu trả lờ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

• Tài khoản Google Workspace Business hoặc Enterprise 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 Cloud trong Google Cloud Console

Nếu chưa mở, hãy mở dự án trên Cloud mà bạn dự định 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 trong 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, bạn có thể cần 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 Google Chat API.

  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ể xuất bản ứng dụng sau này.

1. Trong bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > > Thương hiệu.

   Chuyển đến phần Thương hiệu

2. Nếu đã định cấu hình , bạn có thể định cấu hình các chế độ cài đặt sau đây cho Màn hình đồng ý OAuth trong phần Thương hiệu, Đối tượng và Quyền truy cập vào dữ liệu. Nếu bạn thấy thông báo chưa được định cấu hình, hãy nhấp vào Bắt đầu:
1. Trong mục Thông tin về ứng dụng, trong phần Tên ứng dụng, hãy nhập tên cho ứng dụng.
2. Trong phần Email hỗ trợ người dùng, hãy chọn một địa chỉ email hỗ trợ mà người dùng có thể liên hệ với bạn nếu họ có thắc mắc về sự đồng ý của mình.
3. Nhấp vào Tiếp theo.
4. Trong phần Đối tượng người xem, hãy chọn Nội bộ.
5. Nhấp vào Tiếp theo.
6. Trong phần Thông tin liên hệ, hãy nhập Địa chỉ email để bạn có thể nhận thông báo về mọi thay đổi đối với dự án của mình.
7. Nhấp vào Tiếp theo.
8. Trong phần Hoàn tất, hãy xem kỹ Chính sách dữ liệu người dùng của dịch vụ API của Google. Nếu bạn đồng ý, hãy chọn Tôi đồng ý với Chính sách dữ liệu người dùng của dịch vụ API của Google.
9. Nhấp vào Tiếp tục.
10. Nhấp vào Tạo.
3. Hiện tại, bạn có thể bỏ qua bước thêm phạm vi. 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 đó, hãy thêm các phạm vi uỷ quyền mà ứng dụng của bạn yêu cầu. Để tìm hiểu thêm, hãy xem hướng dẫn đầy đủ về cách Định cấu hình sự đồng ý của OAuth.

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 rồi thiết lập dự án trên Cloud trong Apps Script.

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

1. Truy cập vào trang Apps Script Bắt đầu.
2. Nhấp vào mẫu Ứng dụng trò chuyện ở đầu trang.
3. Nhấp vào Dự án chưa có tên, nhập Quickstart app rồi nhấp vào Đổi tên.

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

1. Trong Bảng điều khiển Google Cloud, hãy chuyển đến phần Trình đơn > IAM và Quản trị > Cài đặt.

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

2. Sao chép giá trị trong trường Số dự án.

Đặt dự án Cloud cho dự án Apps Script

1. Trong dự án Apps Script của ứng dụng Chat, hãy nhấp vào biểu tượng Cài đặt dự án .
2. Trong mục Dự án trên Google Cloud Platform (GCP), hãy nhấp vào Thay đổi dự án.
3. Trong Số dự án trên Google Cloud Platform, hãy dán số dự án trên Google Cloud.
4. Nhấp vào Đặt dự án.

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

Đả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 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ã đó trong bước tiếp theo.

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

1. Trong dự án Apps Script của ứng dụng Chat, hãy nhấp vào Triển khai > Triển khai thử nghiệm.
2. Sao chép Mã nhận dạng triển khai tiêu đề để sử dụng trong một 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.

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 Configuration (Cấu hình) rồi thiết lập ứng dụng Chat:

   1. Trong trường Tên ứng dụng, hãy nhập Quickstart app.
   2. Trong trường 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 (Nội dung mô tả), hãy nhập Quickstart app.
   4. Trong phần Chức năng, hãy chọn 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.
   6. Trong trường Mã hoạt động triển khai, hãy dán mã hoạt động triển khai Head mà bạn đã sao chép trước đó.
   7. Trong phần Chế độ hiển thị, hãy chọn Một số 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 nhắn tin trực tiếp bằng ứng dụng Chat rồi gửi một 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ử tin cậy.

   Truy cập vào Google Chat

2. Nhấp vào biểu tượng Cuộc trò chuyện mới.
3. Trong trường Thêm một hoặc nhiều người, 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.

   Lưu ý: Nếu bạn không thấy ứng dụng Chat trong danh sách kết quả, hãy đảm bảo rằng bạn đã thêm tài khoản Google Workspace vào chế độ cài đặt Chế độ hiển thị của trang Cấu hình Chat API trong Google Cloud Console.

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 này và phản hồi tin nhắn 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 một ứ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ị bất kỳ thông báo lỗi nào, nhưng ứng dụng hoặc thẻ Chat 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 xuất hiện trong giao diện người dùng Chat, nhưng bạn có thể sử dụng 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 lỗi trong Google Chat.

Dọn dẹp

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

Thận trọng: Thao tác xoá dự án sẽ gây ra những tác động sau:

• Mọi nội dung trong dự án sẽ bị xoá. Nếu đã dùng một dự án hiện có cho hướng dẫn này, thì khi xoá dự án đó, bạn cũng sẽ xoá mọi công việc khác mà bạn đã thực hiện trong dự án.
• Mã dự án tuỳ chỉnh sẽ bị mất. Khi tạo dự án này, có thể bạn đã tạo một mã dự án tuỳ chỉnh mà bạn muốn sử dụng trong tương lai. Để giữ lại những URL sử dụng mã dự án (chẳng hạn như URL trên appspot.com), hãy xoá các tài nguyên đã chọn trong dự án thay vì xoá toàn bộ dự án.

Nếu bạn dự định khám phá nhiều hướng dẫn và hướng dẫn bắt đầu nhanh, thì việc sử dụng lại các dự án có thể giúp bạn tránh vượt quá hạn mức dự án.

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

   Chuyển đến Resource Manager

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á .
3. 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 – Tin nhắn dạng thẻ hỗ trợ 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 phong phú (như hình ảnh). Sử dụng thông báo dạng 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.
• Phản hồi lệnh – Lệnh giúp người dùng khám phá và sử dụng các tính năng chính của ứng dụng Chat.
• Khởi chạy hộp thoại – Hộp thoại là giao diện dựa trên thẻ, có cửa sổ 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ể kết hợp nhiều thẻ theo trình 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.
• Lớp học lập trình: Bạn đã sẵn sàng tạo một ứng dụng trò chuyện nâng cao hơn chưa? 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.