Gửi tin nhắn đến các nhóm thiết bị trên nền tảng của Apple

Tính năng nhắn tin theo nhóm thiết bị cho phép bạn thêm nhiều thiết bị vào một nhóm. Điều này tương tự như việc nhắn tin theo chủ đề, nhưng bao gồm cả quy trình xác thực để đảm bảo rằng chỉ máy chủ của bạn mới quản lý tư cách thành viên nhóm. Ví dụ: nếu bạn muốn gửi các thông báo khác nhau đến các mẫu điện thoại khác nhau, thì máy chủ của bạn có thể thêm/xoá thông tin đăng ký vào các nhóm thích hợp và gửi thông báo thích hợp đến từng nhóm. Tính năng nhắn tin theo nhóm thiết bị khác với tính năng nhắn tin theo chủ đề ở chỗ tính năng này liên quan đến việc quản lý các nhóm thiết bị từ máy chủ thay vì trực tiếp trong ứng dụng.

Số lượng thành viên tối đa được phép cho một khoá thông báo là 20.

Quản lý nhóm thiết bị

Trước khi gửi thông báo đến một nhóm thiết bị, bạn phải:

1. Lấy mã thông báo đăng ký cho từng thiết bị bạn muốn thêm vào nhóm.

2. Tạo notification_key để xác định nhóm thiết bị bằng cách liên kết một nhóm cụ thể (thường là người dùng) với tất cả mã thông báo đăng ký được liên kết của nhóm. Bạn có thể tạo khoá thông báo trên máy chủ ứng dụng.

Hoạt động quản lý cơ bản của các nhóm thiết bị (tạo và xoá nhóm, thêm hoặc xoá thiết bị) được thực hiện thông qua API HTTP v1, sử dụng mã thông báo ngắn hạn để uỷ quyền gửi yêu cầu. Hãy xem phần Khoá quản lý nhóm thiết bị để biết danh sách các khoá được hỗ trợ.

Quản lý nhóm thiết bị trên máy chủ ứng dụng

Tạo nhóm thiết bị

Để tạo một nhóm thiết bị, hãy gửi yêu cầu POST cung cấp tên cho nhóm và danh sách mã thông báo đăng ký cho các thiết bị đó. FCM trả về một notification_key mới đại diện cho nhóm thiết bị.

Yêu cầu POST qua HTTP

Gửi yêu cầu như sau đến https://fcm.googleapis.com/fcm/notification:

https://fcm.googleapis.com/fcm/notification
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID

{
   "operation": "create",
   "notification_key_name": "appUser-Chris",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1...",
                        "cR1rjyj4_Kc:APA91bGusqbypSuMdsh7jSNrW4nzsM...",
                        ... ]

notification_key_name là một tên hoặc giá trị nhận dạng (ví dụ: có thể là tên người dùng) dành riêng cho một nhóm nhất định. notification_key_name và notification_key là duy nhất cho một nhóm mã thông báo đăng ký. Điều quan trọng là notification_key_name phải là duy nhất cho mỗi ứng dụng khách nếu bạn có nhiều ứng dụng khách cho cùng một mã người gửi. Điều này đảm bảo rằng thông báo chỉ được gửi đến ứng dụng mục tiêu dự kiến.

Định dạng phản hồi

Yêu cầu thành công sẽ trả về một notification_key như sau:

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

Lưu notification_key và notification_key_name tương ứng để sử dụng trong các thao tác tiếp theo.

Truy xuất khoá thông báo

Nếu bạn cần truy xuất khoá thông báo hiện có, hãy sử dụng notification_key_name trong yêu cầu GET như sau:

https://fcm.googleapis.com/fcm/notification?notification_key_name=appUser-Chris
Content-Type:application/json
access_token_auth: true
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA
project_id:SENDER_ID
{}

Đối với mỗi yêu cầu GET cho một tên khoá thông báo nhất định, máy chủ sẽ trả về một chuỗi được mã hoá duy nhất. Mặc dù mỗi chuỗi có vẻ là một khoá khác nhau, nhưng thực sự đó là một giá trị `notification_key` hợp lệ.

Thêm và xoá thiết bị khỏi nhóm thiết bị

Để thêm hoặc xoá thiết bị khỏi nhóm hiện có, hãy gửi yêu cầu POST với tham số operation được đặt thành add hoặc remove, đồng thời cung cấp mã thông báo đăng ký để thêm hoặc xoá.

Yêu cầu POST qua HTTP

Ví dụ: để thêm một thiết bị có mã thông báo đăng ký bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1... vào appUser-Chris, bạn sẽ gửi yêu cầu này:

{
   "operation": "add",
   "notification_key_name": "appUser-Chris",
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
   "registration_ids": ["bk3RNwTe3H0:CI2k_HHwgIpoDKCIZvvDMExUdFQ3P1..."]
}

Định dạng phản hồi

Yêu cầu thêm hoặc xoá thiết bị thành công sẽ trả về một notification_key như sau:

{
   "notification_key": "APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}

Khoá quản lý nhóm thiết bị

Bảng sau đây liệt kê các khoá để tạo nhóm thiết bị, thêm và xoá thành viên.

Bảng 10. Khoá quản lý nhóm thiết bị.

Gửi tin nhắn đến các nhóm thiết bị

Để gửi thông báo đến các nhóm thiết bị, hãy sử dụng API HTTP v1. Nếu hiện bạn đang gửi đến các nhóm thiết bị bằng cách sử dụng API gửi cũ không dùng nữa cho HTTP hoặc XMPP hoặc bất kỳ phiên bản cũ nào của Firebase Admin SDK cho Node.js dựa trên các giao thức cũ, thì bạn nên di chuyển sang API HTTP phiên bản 1 càng sớm càng tốt. Các API gửi cũ sẽ bị vô hiệu hoá và xoá vào tháng 6 năm 2024.

Việc gửi thông báo đến một nhóm thiết bị rất giống với việc gửi thông báo đến một thiết bị riêng lẻ, sử dụng cùng một phương thức để uỷ quyền gửi yêu cầu. Đặt trường token thành khoá thông báo nhóm:

POST https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send HTTP/1.1

Content-Type: application/json
Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA

{
   "message":{
      "token":"APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ",
      "data":{
        "hello": "This is a Firebase Cloud Messaging device group message!"
      }
   }
}

curl -X POST -H "Authorization: Bearer ya29.ElqKBGN2Ri_Uz...HnS_uNreA" -H "Content-Type: application/json" -d '{
"message":{
   "data":{
     "hello": "This is a Firebase Cloud Messaging device group message!"
   },
   "token":"APA91bGHXQBB...9QgnYOEURwm0I3lmyqzk2TXQ"
}}' https://fcm.googleapis.com/v1/projects/myproject-b5ae1/messages:send

Gửi tin nhắn ngược dòng đến các nhóm thiết bị

Để gửi thông báo ngược dòng đến các nhóm thiết bị trên ứng dụng của Apple, ứng dụng Apple cần triển khai FIRMessaging.sendMessage:

(void)sendMessage:(nonnull NSDictionary *)message
     to:(nonnull NSString *)receiver
withMessageID:(nonnull NSString *)messageID
timeToLive:(int64_t)ttl;