Firebase silent apns notification
Solution 1
You can send silent APNS messages using the FCM server API https://firebase.google.com/docs/cloud-messaging/http-server-ref
In particular you need to use:
- The data field:
This parameter specifies the custom key-value pairs of the message's payload.
For example, with data:{"score":"3x1"}:
On iOS, if the message is sent via APNS, it represents the custom data fields. If it is sent via FCM connection server, it would be represented as key value dictionary in AppDelegate application:didReceiveRemoteNotification:.
The key should not be a reserved word ("from" or any word starting with "google" or "gcm"). Do not use any of the words defined in this table (such as collapse_key).
Values in string types are recommended. You have to convert values in objects or other non-string data types (e.g., integers or booleans) to string
- The content_available field:
On iOS, use this field to represent content-available in the APNS payload. When a notification or message is sent and this is set to true, an inactive client app is awoken. On Android, data messages wake the app by default. On Chrome, currently not supported.
Full documentation: https://firebase.google.com/docs/cloud-messaging/http-server-ref#downstream-http-messages-json
Solution 2
For a truly silent notification (both foreground and background) using FCM server use these fields:
"to" : "[token]",
"content_available": true,
"priority": "high",
"data" : {
"key1" : "abc",
"key2" : 123
}
NOTE: Make sure you are using "content_available" NOT "content-available" with FCM. It's converted for APNS and won't be received properly otherwise. The difference had tripped me up for some time.
Solution 3
I explain this topic more detail on my blog. http://blog.boxstory.com/2017/01/how-to-send-silent-push-notification-in.html
** keypoint is : "content_available:true"
this is sample JSON
{
"to" : "<device>",
"priority": "normal",
"content_available": true, <-- this key is converted to 'content-available:1'
"notification" : {
"body" : "noti body",
"title" : "noti title",
"link": "noti link "
}
}
Note: If the above sample JSON is sent, then the notification will be visible to the user. Use below If you don't want the user to see the push notification.
{
"to": "<device>",
"priority": "normal",
"content_available": true <-- this key is converted to 'content-available:1'
}
Solution 4
For guys who do not use the Legacy HTTP
as is shown in other answers and use the latest v1 HTTP protocol
, I've finally figured out the right way to send silent notifications.
NodeJS example using firebase-admin
:
const message = {
apns: {
payload: {
aps: {
"content-available": 1,
alert: ""
}
}
},
token: "[token here - note that you can also replace the token field with `topic` or `condition` depending on your targeting]"
};
admin
.messaging()
.send(message)
.then(response => {
// Response is a message ID string.
console.log("Successfully sent message:", response);
})
.catch(error => {
console.log("Error sending message:", error);
});
Explanation:
- It seems the payload in
apns
does not get converted by Firebase inv1 HTTP protocol
so you need the original"content-available": 1
for that. -
alert: ""
is also necessary. If you ever try to send silent notifications using something likePusher
, you will find onlycontent-available
cannot trigger it. Instead, adding additional field such assound
oralert
can make it work. See Silent Push Notification in iOS 7 does not work. Since Firebase forbids empty sound, we can use empty alert for this.
Solution 5
The other solutions did not work for me. I wanted a solution that sent data messages to both iOS and Android.
From my testing I have found that the only way to reliably send a data message when my iOS app is in the background is to include an empty notification payload.
Also, as other answers have mentioned, you need to include content_available
and priority
.
To test this out using a curl command you'll need your FCM server key and the FCM token from the app.
Sample curl command for iOS only. (Reliable data message with no visible notification)
curl -X POST \
https://fcm.googleapis.com/fcm/send \
-H 'authorization: key=server_key_here' \
-H 'content-type: application/json' \
-d '{
"to": "fcm_token_here",
"priority": "high",
"content_available": true,
"notification": {
"empty": "body"
},
"data": {
"key1": "this_is_a_test",
"key2": "abc",
"key3": "123456",
}
}'
Replace server_key_here
and fcm_token_here
above with your own.
The below method in your AppDelegate
class should be called when the app is in the background and no UI message should be displayed.
func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any],
fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
//get data from userInfo
completionHandler(UIBackgroundFetchResult.newData)
}
Here's how you would do this using a cloud function and typescript to send to a topic.
const payload = {
notification: {
empty: "message"
},
data: {
key1: "some_value",
key2: "another_value",
key3: "one_more"
}
}
const options = {
priority: "high",
contentAvailable: true //wakes up iOS
}
return admin.messaging().sendToTopic("my_topic", payload, options)
.then(response => {
console.log(`Log some stuff`)
})
.catch(error => {
console.log(error);
});
The above seems to consistently work for iOS and sometimes work for Android. I've come to the conclusion that my backend will need to determine platform before sending out a push notification to be most effective.
Related videos on Youtube
roiberg
Updated on July 09, 2022Comments
-
roiberg almost 2 years
Is there a way to send a silent APNS using google's firebase? It seems that if the app is in the background it will always show a notification to the user.
Thanks?
-
roibergI mean the api. I want to send a silent notification through our JAVA server, not through the Console. And as far as I see you can't send a notification that will wake you application and not automatically put a visible notification in the tray.
-
-
FelixSFD over 7 yearsA link to a potential solution is always welcome, but please add context around the link so your fellow users will have some idea what it is and why it’s there. Always quote the most relevant part of an important link, in case the target site is unreachable or goes permanently offline. Take into account that being barely more than a link to an external site is a possible reason as to Why and how are some answers deleted?.
-
Moxarth over 6 yearshi , i have a similar scenario but slightly modification required , like when i get the push notification ,the app should get active in background and do the task given in , ( like user's location update code ) ,- (void)application:(UIApplication *)application didReceiveRemoteNotification:(NSDictionary *)userInfo , but my app would not get active until user taps on the notification . so , how would i get this done while app is in background ? dose anyone know the solution for this ?
-
Moxarth over 6 yearsdo not send body , title , link , inside the notification otherwise user will get visible notifications . if you want to send totally silent notification then add some custom parameter in notification or keep it blank . you can refer this link , stackoverflow.com/questions/47770256/… .
-
Saurabh about 5 years@Moxarth Even I am struggling with the same issue. Were you able to solve this?
-
Eradicatore over 4 yearsThanks! "content_available" was just what I needed!
-
Arjun over 3 yearsHow to receive this payload on iOS, I've achieved it on Android but just not getting how to do it in iOS. Could you please help me? Thank you
-
JCutting8 over 3 years
Error: Invalid JSON payload received. Unknown name "content_available"
-
user2993497 over 3 yearsLife Saver my guy!!
-
genericUser almost 3 yearsThanks for the sample URL command! Saved me a lot of time testing messaging issues!
-
Trev14 over 2 yearsCould we see a more full example here? I'm also seeing
Unknown name "content_available"
and I don't know how to get this to work without error after error...