Hướng dẫn này cho biết cách tạo ứng dụng Google Chat giúp người dùng Google Chat quản lý danh bạ cá nhân và danh bạ doanh nghiệp. Để thu thập thông tin, ứng dụng Chat sẽ nhắc người dùng hoàn tất biểu mẫu liên hệ trong tin nhắn và hộp thoại dạng thẻ.
Xem ứng dụng Chat hoạt động như thế nào:
-
Hình 2. Ứng dụng Chat sẽ mở một hộp thoại để người dùng có thể nhập thông tin về một người liên hệ. -
Hình 3. Ứng dụng Chat sẽ trả về một hộp thoại xác nhận để người dùng có thể xem lại và xác nhận thông tin trước khi gửi. -
Hình 4. Sau khi người dùng gửi biểu mẫu, ứng dụng Chat sẽ gửi một tin nhắn văn bản riêng tư để xác nhận việc gửi. -
Hình 5. Ứng dụng Chat cũng nhắc người dùng thêm người liên hệ từ một thẻ vào tin nhắn.
Đ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ục tiêu
- Thiết kế và tạo giao diện người dùng (UI) dưới dạng đối tượng
card
và hiển thị giao diện người dùng trong thông báo và hộp thoại. - Nhận và xử lý thông tin mà người dùng gửi bằng tiện ích nhập dữ liệu biểu mẫu.
- Phản hồi lệnh dấu gạch chéo bằng cách gửi tin nhắn có chứa văn bản, thẻ và tiện ích phụ kiện.
Kiến trúc
Ứng dụng Chat được tích hợp sẵn Google Apps Script và sử dụng các sự kiện tương tác để xử lý và phản hồi người dùng Chat.
Phần sau đây cho thấy cách người dùng thường tương tác với ứng dụng Chat:
Người dùng mở một tin nhắn trực tiếp bằng ứng dụng Chat hoặc thêm ứng dụng Chat vào một không gian hiện có.
Ứng dụng Chat nhắc người dùng thêm một người liên hệ bằng cách tạo và hiển thị biểu mẫu liên hệ dưới dạng đối tượng
card
. Để hiển thị biểu mẫu liên hệ, ứng dụng Chat sẽ phản hồi người dùng theo những cách sau:- Phản hồi các lượt đề cập bằng @và tin nhắn trực tiếp bằng một tin nhắn dạng thẻ chứa biểu mẫu liên hệ.
- Phản hồi lệnh dấu gạch chéo
/addContact
bằng cách mở một hộp thoại có biểu mẫu liên hệ. - Phản hồi lệnh gạch chéo
/about
bằng một tin nhắn văn bản có nút Thêm người liên hệ mà người dùng có thể nhấp vào để mở hộp thoại có biểu mẫu liên hệ.
Khi thấy biểu mẫu liên hệ, người dùng sẽ nhập thông tin liên hệ vào các trường và tiện ích sau:
- Họ và tên: một tiện ích
textInput
chấp nhận các chuỗi. - Birthdate (Ngày sinh): một tiện ích
dateTimePicker
chỉ chấp nhận ngày tháng. - Loại thông tin liên hệ: một tiện ích
selectionInput
gồm các nút chọn cho phép người dùng chọn và gửi một giá trị chuỗi duy nhất (Personal
hoặcWork
). - Nút Xem xét và gửi: một mảng
buttonList
có tiện íchbutton
mà người dùng nhấp vào để gửi các giá trị mà họ nhập.
- Họ và tên: một tiện ích
Ứng dụng Google Chat xử lý sự kiện tương tác
CARD_CLICKED
để xử lý các giá trị mà người dùng nhập và hiển thị các giá trị đó trong thẻ xác nhận.Người dùng xem lại thẻ xác nhận rồi nhấp vào nút Gửi để hoàn tất thông tin liên hệ.
Ứng dụng Google Chat sẽ gửi một tin nhắn văn bản riêng tư xác nhận việc gửi.
Chuẩn bị môi trường
Phần này trình bày cách tạo và định cấu hình dự án Google Cloud cho ứng dụng Chat.
Tạo một dự án trên Google Cloud
Bảng điều khiển Google Cloud
- Trong bảng điều khiển Google Cloud, hãy chuyển đến Trình đơn > IAM và Quản trị viên > Tạo dự án.
-
Trong trường Project Name (Tên dự án), hãy nhập tên mô tả cho dự án của bạn.
Không bắt buộc: Để chỉnh sửa Mã dự án, hãy nhấp vào Chỉnh sửa. Bạn không thể thay đổi mã dự án sau khi tạo dự án, vì vậy, hãy chọn một mã đáp ứng nhu cầu của bạn trong suốt thời gian hoạt động của dự án.
- Trong trường Vị trí, hãy nhấp vào Duyệt xem để hiển thị các vị trí tiềm năng cho dự án của bạn. Sau đó, hãy nhấp vào Chọn.
- Nhấp vào Tạo. Google Cloud Console sẽ chuyển đến trang Trang tổng quan và dự án của bạn sẽ được tạo trong vòng vài phút.
gcloud CLI
Trong một trong các môi trường phát triển sau, hãy truy cập vào Google Cloud CLI (gcloud
):
-
Cloud Shell: Để sử dụng thiết bị đầu cuối trực tuyến đã thiết lập gcloud CLI, hãy kích hoạt Cloud Shell.
Kích hoạt Cloud Shell -
Local Shell: Để sử dụng môi trường phát triển cục bộ, hãy cài đặt và khởi động CLI của gcloud.
Để tạo một dự án trên Google Cloud, hãy dùng lệnhgcloud projects create
: Thay thế PROJECT_ID bằng cách đặt mã nhận dạng cho dự án bạn muốn tạo.gcloud projects create PROJECT_ID
Thiết lập tính năng xác thực và uỷ quyền
Các ứng dụng Google Chat yêu cầu bạn định cấu hình màn hình xin phép bằng OAuth để người dùng có thể uỷ quyền cho ứng dụng của bạn trong các ứng dụng của Google Workspace, bao gồm cả Google Chat.
Trong hướng dẫn này, bạn triển khai một ứng dụng Chat chỉ dành cho việc kiểm thử và sử dụng nội bộ, vì vậy, bạn có thể sử dụng thông tin phần giữ chỗ cho màn hình yêu cầu đồng ý. Trước khi phát hành ứng dụng Chat, hãy thay thế mọi thông tin phần giữ chỗ bằng thông tin thực.
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.
Trong mục Loại người dùng, hãy chọn Nội bộ, rồi nhấp vào Tạo.
Trong Tên ứng dụng, hãy nhập
Contact Manager
.Trong mục Email hỗ trợ người dùng, hãy chọn địa chỉ email của bạn hoặc một nhóm Google thích hợp.
Trong phần Thông tin liên hệ của nhà phát triển, hãy nhập địa chỉ email của bạn.
Nhấp vào Lưu và tiếp tục.
Trên trang Phạm vi, hãy nhấp vào Lưu và tiếp tục. (Ứng dụng Chat không yêu cầu bất kỳ phạm vi OAuth nào.)
Xem lại thông tin tóm tắt, rồi nhấp vào Quay lại trang tổng quan.
Tạo và triển khai ứng dụng Chat
Trong phần sau, bạn sẽ sao chép và cập nhật toàn bộ dự án Apps Script chứa tất cả mã ứng dụng bắt buộc cho ứng dụng Chat, vì vậy, bạn không cần phải sao chép và dán từng tệp.
Bạn có thể xem toàn bộ dự án trên GitHub (không bắt buộc).
Dưới đây là thông tin tổng quan về từng tệp:
main.gs
Xử lý tất cả logic ứng dụng, bao gồm cả các sự kiện tương tác về thời điểm người dùng gửi tin nhắn đến ứng dụng Chat, nhấp vào các nút trong tin nhắn của ứng dụng Chat hoặc mở và đóng hộp thoại.
Xem mã
main.gs
contactForm.gs
Chứa các tiện ích nhận dữ liệu biểu mẫu từ người dùng. Các tiện ích nhập dữ liệu vào biểu mẫu này sẽ hiển thị trong các thẻ xuất hiện trong tin nhắn và hộp thoại.
Xem mã
contactForm.gs
appsscript.json
Tệp kê khai Apps Script xác định và định cấu hình dự án Apps Script cho ứng dụng Chat.
Xem mã
appsscript.json
Tìm số và mã dự án trên Cloud
Trong Google Cloud Console, hãy chuyển đến dự án trên Google Cloud.
Nhấp vào biểu tượng Cài đặt và tiện ích > Cài đặt dự án.
Ghi lại các giá trị trong trường Số dự án và Mã dự án. Bạn sẽ sử dụng các lớp này trong các phần sau.
Tạo dự án Apps Script
Cách tạo một dự án Apps Script và kết nối dự án đó với dự án Cloud của bạn:
- Nhấp vào nút sau để mở dự án Apps Script Quản lý danh bạ trong Google Chat.
Mở dự án - Nhấp vào Tổng quan.
- Trên trang tổng quan, hãy nhấp vào Tạo bản sao.
Đặt tên cho bản sao dự án Apps Script:
Nhấp vào Bản sao của mục Quản lý người liên hệ trong Google Chat.
Trong Tên dự án, hãy nhập
Contact Manager - Google Chat app
Nhấp vào Đổi tên.
Đặt dự án trên đám mây của dự án Apps Script
- Trong dự án Apps Script, hãy nhấp vào Project Settings (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 trên GCP, hãy dán số dự án của dự án trên Cloud.
- Nhấp vào Đặt dự án. Dự án trên đám mây và dự án Apps Script hiện đã được kết nối.
Tạo quy trình triển khai Apps Script
Giờ đây, khi tất cả mã đã được triển khai, hãy triển khai dự án Apps Script. Bạn sử dụng mã nhận dạng triển khai khi định cấu hình ứng dụng Chat trong Google Cloud.
Trong Apps Script, hãy mở dự án của ứng dụng Chat.
Nhấp vào Triển khai > Triển khai mới.
Nếu bạn chưa chọn Tiện ích bổ sung, bên cạnh phần Chọn loại, hãy nhấp vào loại triển khai rồi chọn Tiện ích bổ sung.
Trong phần Description (Nội dung mô tả), hãy nhập nội dung mô tả cho phiên bản này, chẳng hạn như
Test of Contact Manager
.Nhấp vào Triển khai. Apps Script báo cáo về việc triển khai thành công và cung cấp một mã triển khai.
Nhấp vào biểu tượng
Sao chép để sao chép mã hoạt động triển khai, sau đó nhấp vào Xong.
Định cấu hình ứng dụng Chat trong bảng điều khiển Google Cloud
Phần này cho biết cách định cấu hình API Google Chat trong Google Cloud Console bằng thông tin về ứng dụng Chat, bao gồm cả mã nhận dạng của bản triển khai mà bạn vừa tạo từ dự án Apps Script.
Trong bảng điều khiển Google Cloud, hãy nhấp vào Trình đơn > Sản phẩm khác > Google Workspace > Thư viện sản phẩm > API Google Chat > Quản lý > Cấu hình.
Trong App name (Tên ứng dụng), hãy nhập
Contact Manager
.Trong URL hình đại diện, hãy nhập
https://developers.google.com/chat/images/contact-icon.png
.Trong mục Mô tả, hãy nhập
Manage your personal and business contacts
.Nhấp vào nút bật/tắt Bật tính năng tương tác để chuyển sang vị trí bật.
Trong phần Chức năng, hãy chọn các hộp đánh dấu Nhận tin nhắn 1:1 và Tham gia 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 Apps Script (Tập lệnh ứng dụng).
Trong Mã triển khai, hãy dán Mã triển khai Apps Script mà bạn đã sao chép trong phần trước khi tạo bản triển khai Apps Script.
Trong phần Lệnh dấu gạch chéo, hãy thiết lập các lệnh dấu gạch chéo
/about
và/addContact
:- Nhấp vào Thêm lệnh dấu gạch chéo để thiết lập lệnh dấu gạch chéo đầu tiên.
- Trong Name (Tên), hãy nhập
/about
. - Trong Command ID, nhập
1
. - Trong mục Mô tả, hãy nhập
Learn how to use this Chat app to manage your contacts
. - Chọn Mở hộp thoại.
- Nhấp vào Xong.
- Nhấp vào Thêm lệnh dấu gạch chéo để thiết lập một lệnh dấu gạch chéo khác.
- Trong Name (Tên), hãy nhập
/addContact
- Trong Mã lệnh, hãy nhập
2
. - Trong mục Mô tả, hãy nhập
Submit information about a contact
. - Chọn Mở hộp thoại.
- Nhấp vào Xong.
Trong phần Chế độ hiển thị, hãy chọn hộp đánh dấu Cung cấp ứng dụng Chat này cho một số người và nhóm trong YOUR DOMAIN rồi nhập địa chỉ email của bạn.
Trong mục Nhật ký, hãy chọn Ghi lỗi vào nhật ký.
Nhấp vào Lưu. Một thông báo đã lưu cấu hình sẽ xuất hiện.
Ứng dụng Chat đã sẵn sàng để cài đặt và kiểm thử trong Chat.
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:
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.
- Nhấp vào Cuộc trò chuyện mới.
- Trong trường Thêm 1 người trở lên, hãy nhập tên của ứng dụng Chat.
Chọn ứng dụng Chat trong kết quả. Một tin nhắn trực tiếp sẽ mở ra.
Trong tin nhắn trực tiếp mới với ứng dụng Chat, hãy nhập
/addContact
rồi nhấn enter.Trong hộp thoại mở ra, hãy nhập thông tin liên hệ:
- Trong trường văn bản Họ và tên, hãy nhập tên.
- Trong bộ chọn ngày Ngày sinh, hãy chọn một ngày.
- Trong phần Loại người liên hệ, hãy chọn nút chọn Nơi làm việc hoặc Cá nhân.
Nhấp vào Xem xét và gửi.
Trong hộp thoại xác nhận, hãy xem lại thông tin bạn đã gửi rồi nhấp vào Submit (Gửi). Ứng dụng Chat trả lời bằng một tin nhắn văn bản có nội dung là
✅ CONTACT NAME has been added to your contacts.
.Nếu muốn, bạn cũng có thể kiểm thử và gửi biểu mẫu liên hệ theo các cách sau:
- Sử dụng lệnh dấu gạch chéo
/about
. Ứng dụng trò chuyện trả lời bằng một tin nhắn văn bản và một nút tiện ích phụ có nội dungAdd a contact
. Bạn có thể nhấp vào nút này để mở hộp thoại có biểu mẫu liên hệ. - Gửi tin nhắn trực tiếp cho ứng dụng Chat mà không cần lệnh dấu gạch chéo, chẳng hạn như
Hello
. Ứng dụng Chat sẽ trả lời bằng văn bản và thẻ chứa biểu mẫu liên hệ.
- Sử dụng lệnh dấu gạch chéo
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 Cloud.
- 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 > IAM và quản trị > Quản lý tài nguyên.
- 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á .
- 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.
Chủ đề có liên quan
- Phản hồi lệnh dấu gạch chéo
- Thu thập và xử lý thông tin của người dùng Google Chat
- Mở hộp thoại tương tác
- Khám phá các mẫu ứng dụng khác trong Google Chat