Xử lý các sự kiện trên Google Chat

Trang này giải thích cách các ứng dụng Google Chat có thể nhận và phản hồi các sự kiện trong Google Chat.

Sự kiện trên Google Chat đại diện cho một hoạt động hoặc thay đổi trong Chat, chẳng hạn như một tin nhắn mới trong không gian. Ứng dụng Chat của bạn có thể sử dụng các sự kiện để hiểu điều gì đã xảy ra và hành động hoặc phản hồi theo cách có ý nghĩa đối với người dùng.

Sau đây là một số ví dụ về cách bạn có thể sử dụng sự kiện:

  • Theo dõi và phản hồi tin nhắn mới trong không gian, chẳng hạn như kiểm tra các từ hoặc cụm từ chính.
  • Gửi lời chào đến người dùng khi họ tham gia không gian để giải thích các nguyên tắc của không gian hoặc chia sẻ mẹo về cách sử dụng hiệu quả ứng dụng Chat.
  • Theo dõi và phân tích hoạt động trên Chat. Ví dụ: để gửi báo cáo hằng tháng về thành viên mới hoặc những tin nhắn nhận được nhiều lượt phản ứng hoặc lượt trả lời nhất.
  • Giao tiếp trên các nền tảng nhắn tin. Ví dụ: người dùng có thể gửi và nhận tin nhắn từ người dùng trên một nền tảng nhắn tin khác mà không cần rời khỏi Chat.

Cách hoạt động của sự kiện

Bất cứ khi nào có sự kiện xảy ra trong Google Chat, tài nguyên API Google Chat sẽ được tạo, cập nhật hoặc xoá. Chat sử dụng các sự kiện để phân phối thông tin cho ứng dụng Chat về loại hoạt động đã xảy ra và tài nguyên API Chat bị ảnh hưởng.

Ví dụ về cách một tin nhắn được đăng lên phòng Google Chat kích hoạt một sự kiện.
Hình 1. Người dùng đăng tin nhắn trong một phòng Chat, tạo ra tài nguyên Message. Sau đó, Chat sẽ tạo một sự kiện chứa dữ liệu về thông báo mới.

Chat phân loại các sự kiện theo loại. Loại sự kiện giúp bạn lọc và chỉ nhận loại thông tin bạn cần, đồng thời cho phép bạn xử lý các hoạt động tương tự theo cách tương tự.

Bảng sau đây cho biết cách một hoạt động trong Chat ảnh hưởng đến tài nguyên Chat API có liên quan và loại sự kiện mà ứng dụng Chat của bạn nhận được:

Hoạt động Tài nguyên Chat API Loại sự kiện
Một người dùng đăng tin nhắn trong phòng Chat Tài nguyên Message được tạo. Tin nhắn mới
Một người dùng trở thành người quản lý không gian. Tài nguyên Membership được cập nhật. Đã cập nhật gói thành viên
Người dùng bày tỏ cảm xúc dành cho một tin nhắn. Tài nguyên Reaction được tạo. Phản ứng mới
Một người dùng rời khỏi không gian. Xoá tài nguyên Membership. Đã xoá gói thành viên

Nhận sự kiện từ Google Chat

Để nhận sự kiện, ứng dụng Chat của bạn có thể làm theo một trong hai cách sau:

  • Đăng ký sự kiện bằng API Sự kiện của Google Workspace để nhận sự kiện khi chúng xảy ra.
  • Truy vấn các sự kiện gần đây bằng cách gọi Chat API.

Bảng sau đây giải thích sự khác biệt và lý do truy vấn hoặc đăng ký sự kiện:

Đăng ký sự kiện Truy vấn sự kiện
Trường hợp sử dụng
  • Xử lý hoặc phản hồi sự kiện theo thời gian thực.
  • Theo dõi hoạt động của người dùng trong gói thành viên và khám phá các không gian mới để giám sát.
  • Xử lý hoặc phản hồi các sự kiện theo định kỳ hoặc thông qua một điều kiện kích hoạt.
  • Tìm nạp các sự kiện đã bỏ lỡ từ một gói thuê bao (do sự cố ngừng hoạt động hoặc gói thuê bao không hoạt động).
API Google Workspace Events API Chat API
Nguồn sự kiện Không gian và người dùng Chỉ không gian
Sự kiện được hỗ trợ
  • Tin nhắn
  • Hội viên
  • Lượt thể hiện cảm xúc
  • Không gian

Để biết danh sách các loại sự kiện được hỗ trợ, hãy xem phần Các loại sự kiện để tạo gói thuê bao trong tài liệu về API Sự kiện của Google Workspace.
  • Tin nhắn
  • Hội viên
  • Lượt thể hiện cảm xúc
  • Không gian

Để biết danh sách các loại sự kiện được hỗ trợ, hãy xem tài nguyên spaceEvents trong tài liệu tham khảo Chat API.
Định dạng sự kiện Một thông báo Google Cloud Pub/Sub, được định dạng theo quy cách CloudEvent. Để biết thông tin chi tiết, hãy xem phần Cấu trúc của sự kiện trên Google Workspace. Tài nguyên Chat API ( spaces.spaceEvent)
Dữ liệu sự kiện Chuỗi được mã hoá Base64 có hoặc không có dữ liệu tài nguyên. Ví dụ: tải trọng, hãy xem phần Dữ liệu sự kiện. Tải trọng JSON chứa dữ liệu tài nguyên. Một số loại sự kiện chỉ bao gồm một số trường tài nguyên nhất định. Để biết ví dụ về tải trọng, hãy xem tài liệu tham khảo.

Ví dụ: Truy vấn hoặc đăng ký nhận thông báo về các sự kiện liên quan đến gói thành viên trong một không gian

Trong ví dụ này, một ứng dụng Chat muốn nhận thông tin về những thay đổi đối với thành viên của một không gian Chat. Trong không gian, hoạt động thành viên sau đây sẽ xảy ra:

  • Một người dùng tham gia không gian, tạo tài nguyên Membership và kích hoạt sự kiện thành viên mới.
  • Người dùng trở thành người quản lý không gian, cập nhật tài nguyên Membership cho người dùng và kích hoạt sự kiện thành viên đã cập nhật.
  • Một người dùng rời khỏi không gian, thao tác này sẽ xoá tài nguyên Membership cho người dùng và kích hoạt sự kiện thành viên bị xoá.

Đăng ký nhận sự kiện dành cho thành viên

Để nhận sự kiện theo thời gian thực, ứng dụng Chat gọi phương thức subscriptions.create() của API Sự kiện của Google Workspace để đăng ký không gian cho tất cả các loại sự kiện thành viên. Sau khi tạo gói thuê bao, ứng dụng Chat có thể bắt đầu nhận các sự kiện về gói thành viên.

Ứng dụng trò chuyện đăng ký sự kiện bằng API Sự kiện của Google Workspace.
Hình 2. Ứng dụng Chat nhận được các sự kiện thành viên thông qua gói thuê bao bằng API Sự kiện của Google Workspace.

Trong hình 2, ứng dụng Chat có một gói thuê bao đang hoạt động cho không gian, vì vậy, ứng dụng sẽ nhận được một sự kiện bất cứ khi nào có thay đổi về thành viên trong không gian. Sau đó, ứng dụng Chat có thể xử lý hoặc phản hồi theo thời gian thực đối với bất kỳ hoạt động nào, chẳng hạn như đăng tin nhắn chào mừng riêng tư cho thành viên đã tham gia không gian.

Để tìm hiểu về cách tạo gói thuê bao bằng API Sự kiện của Google Workspace, hãy xem tài liệu về API Sự kiện của Google Workspace.

Truy vấn các sự kiện gần đây liên quan đến gói thành viên

Thay vì nhận các sự kiện thành viên khi chúng xảy ra, ứng dụng Chat có thể gọi Chat API để liệt kê các sự kiện gần đây trong không gian liên quan đến hoạt động của thành viên.

Ứng dụng trò chuyện truy vấn các sự kiện bằng API Chat.
Hình 3. Ứng dụng Chat nhận được các sự kiện gần đây về thành viên bằng cách truy vấn các sự kiện không gian bằng API Chat.

Trong hình 3, ứng dụng Chat gọi phương thức Chat API spaces.spaceEvents.list() sau khi tất cả hoạt động thành viên đã xảy ra và lọc truy vấn cho các sự kiện thành viên mới, đã cập nhật và đã xoá. API Chat trả về danh sách tài nguyên spaceEvent đại diện cho từng thay đổi về gói thành viên. Sau đó, ứng dụng Chat có thể xử lý hoặc phản hồi dựa trên hoạt động gần đây, chẳng hạn như đăng thông báo hằng tuần có nội dung tóm tắt hoạt động của thành viên trong không gian trong 7 ngày qua.

Để truy vấn sự kiện bằng API Chat, hãy xem phần Liệt kê sự kiện trong không gian Google Chat.

Các điểm hạn chế
  • Đối với các gói thuê bao người dùng, các sự kiện về thành viên mới trong tin nhắn trực tiếp hoặc cuộc trò chuyện nhóm chưa đặt tên (google.workspace.chat.membership.v1.created) chỉ kích hoạt sau khi đăng tin nhắn đầu tiên.
  • Để nhận được sự kiện liên quan đến gói thành viên, người dùng phải là thành viên trực tiếp của không gian. Nếu một người dùng được thêm, cập nhật hoặc xoá gián tiếp khỏi một không gian thông qua Nhóm Google, thì gói thuê bao sẽ không nhận được các sự kiện thành viên đó. Để tìm hiểu cách hoạt động của gói thành viên Google Groups, hãy xem bài viết Thêm nhóm trên Google Groups vào không gian.