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à trả lời những tin nhắn sự kiện trong Google Chat.

Sự kiện trong Google Chat thể hiện 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ó thể sử dụng để hiểu điều gì đã xảy ra và thực hiện hành động hoặc phản hồi một cách có ý nghĩa cho người dùng.

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

  • Theo dõi và trả lời tin nhắn mới trong một không gian, chẳng hạn như kiểm tra chìa khoá từ hoặc cụm từ.
  • Gửi tin nhắn chào mừng cho người dùng khi họ tham gia không gian để giải thích về không gian hướng dẫn hoặc chia sẻ các 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 trong Chat. Ví dụ: để gửi một báo cáo hằng tháng về thành viên mới hoặc những tin nhắn thu hút được nhiều nhất lượt bày tỏ cảm xúc hoặc câu trả lời.
  • 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 thông báo từ người dùng trên một nền tảng nhắn tin khác mà không rời khỏi Chat.

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

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

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

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

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

Hoạt động Tài nguyên API Chat 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
Người dùng sẽ 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 thể hiện cảm xúc với một tin nhắn. Tài nguyên Reaction đã được tạo. Lượt thể hiện cảm xúc mới
Người dùng rời khỏi không gian. Tài nguyên Membership đã bị xoá. Đã 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ó thể thực hiện một trong hai cách sau sau:

  • Đăng ký nhận thông tin về sự kiện bằng API Sự kiện của Google Workspace để nhận thông tin về 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 API Chat.

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

Đăng ký nhận thông báo về 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.
  • Giám sát người dùng hoạt động của 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 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 tình trạng ngừng dịch vụ hoặc gói thuê bao không hoạt động).
API Google Workspace Events API Chat API
Nguồn của 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 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 API Chat tài liệu tham khảo.
Định dạng sự kiện Một thông báo trong Google Cloud Pub/Sub, được định dạng theo Thông số kỹ thuật của CloudEvent. Để biết thông tin chi tiết, hãy xem Cấu trúc của các sự kiện trong Google Workspace. Tài nguyên API Chat ( 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. Để biết ví dụ về các 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ề các tải trọng, hãy xem tài liệu tham khảo.

Ví dụ: Truy vấn hoặc đăng ký sự kiện về 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 phòng Chat. Ngang bằng không gian, hoạt động tư cách thành viên sau đây sẽ diễn ra:

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

Đăng ký nhận thông tin về các sự kiện dành cho hội viên

Để nhận sự kiện theo thời gian thực, Ứng dụng Chat gọi API Sự kiện của Google Workspace subscriptions.create() để đă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 dành cho hội viên.

Ứng dụng Chat đăng ký sự kiện bằng API Sự kiện của Google Workspace.
Hình 2. Một ứng dụng trong Chat nhận các sự kiện gói thành viên thông qua một 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 để ứng dụng nhận được một sự kiện mỗi khi có thành viên trong không gian thay đổi. Sau đó, ứng dụng Chat có thể xử lý hoặc phản hồi trong theo thời gian thực cho bất kỳ hoạt động nào, chẳng hạn như đăng thư chào mừng riêng tư cho thành viên đã tham gia không gian.

Để tìm hiểu 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 gói thành viên như khi chúng diễn ra, Ứng dụng Chat có thể gọi API Chat để liệt kê các sự kiện gần đây trên không gian có liên quan đến hoạt động của thành viên.

Ứng dụng Chat truy vấn các sự kiện bằng API Chat.
Hình 3. Đáp Ứng dụng Chat nhận các sự kiện liên quan đến gói thành viên gần đây bằng cách truy vấn sự kiện trong không gian bằng API Chat.

Trong hình 3, một ứng dụng Chat gọi API Chat spaces.spaceEvents.list() sau khi mọi hoạt động của gói thành viên đã diễn ra và lọc truy vấn cho các sự kiện gói thành viên mới, đã cập nhật và đã bị xoá. API Chat trả về danh sách các 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 tin nhắn hằng tuần kèm theo bản tóm tắt hoạt động của thành viên trên Không gian trong 7 ngày qua.

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

Các điểm hạn chế
  • Đối với các mục đăng ký của người dùng, 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 tin nhắn đầu tiên được đăng.
  • Để nhận sự kiện dành cho 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 vào, được cập nhật hoặc xoá gián tiếp khỏi một không gian thông qua một nhóm trên Google Groups, thì gói thuê bao này không nhận được các sự kiện dành cho hội viên đó. Để hiểu cách hoạt động của tư cách thành viên trong nhóm trên Google Groups, hãy xem Thêm một nhóm trên Google Groups vào một không gian.