Trang này giải thích cách tạo ứng dụng Chat qua HTTP. Có nhiều cách để triển khai cấu trúc này. Trên Google Cloud, bạn có thể sử dụng Cloud Functions, Cloud Run và App Engine. Trong phần bắt đầu nhanh này, bạn viết và triển khai một Chức năng đám mây mà ứng dụng Chat dùng để trả lời tin nhắn của người dùng.
Với cấu trúc này, bạn định cấu hình Chat để tích hợp Google Cloud hoặc một máy chủ tại chỗ bằng cách sử dụng HTTP, như minh hoạ trong sơ đồ dưới đây:
Trong biểu đồ trước, người dùng tương tác với HTTP Ứng dụng Chat có luồng thông tin sau đây:
- Người dùng gửi tin nhắn trong Chat tới ứng dụng Chat, trong tin nhắn trực tiếp hoặc trong Phòng Chat.
- Yêu cầu HTTP được gửi tới máy chủ web là một đám mây hoặc hệ thống tại chỗ chứa ứng dụng Chat logic.
- 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 (như Lịch và Trang tính), các dịch vụ khác của Google (như Maps, YouTube và Vertex AI) hoặc các dịch vụ web khác (như dự án) hệ thống quản lý hoặc công cụ bán vé).
- Máy chủ web gửi phản hồi HTTP trở lại Dịch vụ ứng dụng Chat trong Chat.
- Phản hồi được gửi đến người dùng.
- Nếu muốn, ứng dụng Chat có thể gọi API Chat để đăng thông báo một cách không đồng bộ hoặc thực hiện các thao tác khác các toán tử.
Cấu trúc này mang lại cho bạn sự linh hoạt khi sử dụng các thư viện hiện có và đã tồn tại trong hệ thống của bạn bởi vì Bạn có thể thiết kế ứng dụng nhắn tin bằng nhiều ngôn ngữ lập trình.
Mục tiêu
- Thiết lập môi trường.
- Tạo và triển khai Chức năng đám mây.
- Xuất bản ứng dụng lên Chat.
- Kiểm tra ứng dụng.
Điều kiện tiên quyết
- Doanh nghiệp Tài khoản Google Workspace có quyền truy cập vào Google Chat.
- Một dự án trên Google Cloud đã bật tính năng thanh toán. Cách kiểm tra để đảm bảo rằng một dự án hiện tại đã bật tính năng thanh toán: hãy xem phần Xác minh trạng thái thanh toán của dự án. Để tạo dự án và thiết lập thông tin thanh toán, hãy xem Tạo một dự án trên Google Cloud.
Thiết lập môi trường
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 API Google Chat, Cloud Build API, Cloud Functions API, Cloud Pub/Sub API, Cloud Logging API, Artifact Registry API và Cloud Run API.
Tạo và triển khai Hàm đám mây
Tạo và triển khai Chức năng đám mây tạo thẻ Chat bằng tên hiển thị và hình đại diện của người gửi. Khi Ứng dụng Chat nhận được một tin nhắn, sẽ chạy hàm này và sẽ phản hồi bằng thẻ.
Cách tạo và triển khai chức năng cho ứng dụng Chat: hoàn thành các bước sau:
Node.js
Trong bảng điều khiển Google Cloud, hãy truy cập vào trang Cloud Functions:
Hãy đảm bảo dự án cho ứng dụng Chat của bạn đã chọn.
Nhấp vào
Create Function (Tạo hàm).Trên trang Tạo hàm, hãy thiết lập hàm của bạn:
- Trong mục Môi trường, hãy chọn thế hệ thứ 2.
- Trong Tên hàm, hãy nhập
QuickStartChatApp
. - Trong phần Khu vực, hãy chọn một khu vực.
- Trong phần Xác thực, chọn Yêu cầu xác thực.
- Nhấp vào Tiếp theo.
Trong Thời gian chạy, hãy chọn phiên bản mới nhất của Node.js.
Trong Mã nguồn, chọn Trình chỉnh sửa cùng dòng.
Trong Điểm truy cập, hãy xoá văn bản mặc định rồi nhập
helloChat
.Thay thế nội dung của
index.js
bằng đoạn mã sau:Nhấp vào Triển khai.
Python
Trong bảng điều khiển Google Cloud, hãy truy cập vào trang Cloud Functions:
Hãy đảm bảo dự án cho ứng dụng Chat của bạn đã chọn.
Nhấp vào
Create Function (Tạo hàm).Trên trang Tạo hàm, hãy thiết lập hàm của bạn:
- Trong mục Môi trường, hãy chọn thế hệ thứ 2.
- Trong Tên hàm, hãy nhập
QuickStartChatApp
. - Trong phần Khu vực, hãy chọn một khu vực.
- Trong phần Xác thực, chọn Yêu cầu xác thực.
- Nhấp vào Tiếp theo.
Trong Runtime (Thời gian chạy), hãy chọn phiên bản Python mới nhất.
Trong Mã nguồn, chọn Trình chỉnh sửa cùng dòng.
Trong Điểm truy cập, hãy xoá văn bản mặc định rồi nhập
hello_chat
.Thay thế nội dung của
main.py
bằng đoạn mã sau:Nhấp vào Triển khai.
Java
Trong bảng điều khiển Google Cloud, hãy truy cập vào trang Cloud Functions:
Hãy đảm bảo dự án cho ứng dụng Chat của bạn đã chọn.
Nhấp vào
Create Function (Tạo hàm).Trên trang Tạo hàm, hãy thiết lập hàm của bạn:
- Trong mục Môi trường, hãy chọn thế hệ thứ 2.
- Trong Tên hàm, hãy nhập
QuickStartChatApp
. - Trong phần Khu vực, hãy chọn một khu vực.
- Trong phần Xác thực, chọn Yêu cầu xác thực.
- Nhấp vào Tiếp theo.
Trong Thời gian chạy, hãy chọn phiên bản Java mới nhất.
Trong Mã nguồn, chọn Trình chỉnh sửa cùng dòng.
Trong Điểm truy cập, hãy xoá văn bản mặc định rồi nhập
HelloChat
.Đổi tên
src/main/java/com/example/Example.java
thànhsrc/main/java/HelloChat.java
.Thay thế nội dung của
HelloChat.java
bằng đoạn mã sau:Thay thế nội dung của
pom.xml
bằng đoạn mã sau:Nhấp vào Triển khai.
Trang chi tiết Chức năng đám mây sẽ mở ra và hàm của bạn xuất hiện cùng với hai chỉ báo tiến trình: một cho bản dựng và một cho dịch vụ. Khi cả hai các chỉ báo tiến trình sẽ biến mất và được thay thế bằng một dấu kiểm. Đây là chức năng của bạn đã được triển khai và sẵn sàng.
Cho phép Google Chat gọi chức năng của bạn
Để cho phép Google Chat gọi chức năng của bạn, hãy thêm Google Chat tài khoản dịch vụ có vai trò Cloud Run Invoker.
Trong bảng điều khiển Google Cloud, hãy truy cập vào trang Cloud Run:
Trong danh sách dịch vụ Cloud Run, hãy chọn hộp đánh dấu bên cạnh dịch vụ nhận . (Đừng nhấp vào chính hàm đó.)
Nhấp vào Quyền. Bảng điều khiển Quyền sẽ mở ra.
Nhấp vào Thêm người chính.
Trong phần New principals (Tài khoản chính mới), hãy nhập
chat@system.gserviceaccount.com
.Trong phần Chọn vai trò, hãy chọn Cloud Run > Trình gọi tắt Cloud Run.
Nhấp vào Lưu.
Xuất bản ứng dụng lên Google Chat
Sau khi triển khai Chức năng đám mây, hãy làm theo các bước sau để biến chức năng này thành Ứng dụng Google Chat:
Trong bảng điều khiển Google Cloud, hãy nhấp vào biểu tượng Trình đơn > Chức năng đám mây.
Đảm bảo rằng dự án mà bạn đã bật Cloud Functions đã chọn.
Trong danh sách chức năng, hãy nhấp vào QuickStartChatApp.
Nhấp vào thẻ Điều kiện kích hoạt.
Trong phần HTTPS, hãy sao chép URL.
Tìm "Google Chat API" rồi nhấp vào API Google Chat, rồi nhấp vào Quản lý.
Nhấp vào Cấu hình rồi thiết lập ứng dụng Google Chat:
- Trong Tên ứng dụng, hãy nhập
Quickstart App
. - Trong URL hình đại diện, hãy nhập
https://developers.google.com/chat/images/quickstart-app-avatar.png
. - Trong phần 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 mục Cài đặt kết nối, hãy chọn URL ứng dụng rồi dán URL cho Cloud Function sẽ được kích hoạt vào hộp.
- Trong mục Đối tượng xác thực, hãy chọn URL ứng dụng.
- Trong phần Chế độ hiển thị, hãy chọn Cung cấp ứng dụng Google Chat này cho một số người dùng và groups trong miền của bạn rồi nhập địa chỉ email của bạn.
- Trong Logs (Nhật ký), hãy chọn Log lỗi to Logging (Ghi nhật ký vào nhật ký).
- Trong Tên ứng dụng, hãy nhập
Nhấp vào Lưu.
Ứng dụng Chat đã sẵn sàng nhận và trả lời tin nhắn trên Chat.
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
Hello
rồi nhấnenter
.
Phản hồi của ứng dụng Chat có chứa thông báo thẻ hiển thị tên của người gửi và hình đại diện của họ, như được minh hoạ trong hình sau:
Để 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 phát sinh phí đối với 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.
Chủ đề có liên quan
Để thêm các tính năng khác vào ứng dụng Chat, hãy xem sau: