Push Notifications

When Chatkit users on iOS or Android devices miss a private message, they can receive it as a push notification. The message will appear as a push notification on their lock screen which they can tap to launch the app and return to the conversation.

Delivery Criteria

Chatkit push notifications rely on Chatkit presence to determine who should receive push notifications.

When a Chatkit user sends a message to another user — either in a private channel with many users or just 1-1 — the Chatkit push notifications service checks whether the recipients are online.

If users in the private channel are not online, a push notification is sent after 5 seconds. Another push notification is sent for each subsequent missed message. The iOS and Android operating systems will stack these notifications into a batch on the user’s lock screen.

Even if they log off immediately after authoring a message, the message author will not receive the push notification of the message they sent to a private channel.

Notification Payload

The push notification payload combines fields which are determined by the iOS and Android operating systems with content from the Chatkit service.

Each push notification sent to Chatkit users includes:

  • app name — the name of your iOS or Android application
  • app icon — the icon for your iOS or Android application
  • Chatkit channel name — the name of the private channel where the missed message occurred, as defined by your running Chatkit service
  • Chatkit message body — the body of the missed message, automatically truncated with an … at 140 characters to adhere to operating system limits
  • Device Registration

    Chatkit push notifications are only enabled for devices which register to receive push notifications from your app.

    If a user has already authorized push notifications for your app, the Chatkit iOS and Android SDKs will pass this device token to Chatkit once you follow the iOS and Android setup guides and a user updates their app to your latest version.

    If a user has not yet authorized push notifications from your app, the Chatkit iOS and Android SDKs will trigger a system prompt once your have followed the iOS and Android setup guides and a user updates their app to your latest version.

    If a user opts out of receiving push notifications from your app, they will not receive Chatkit push notifications until they go to their iOS or Android system settings and opt back in to receive push notifications from your app.

    Preferences Customization

    Chatkit push notifications is in beta. Currently, notification preferences are not customizable. Let us know how you’d like to customize this in the future to help guide our roadmap for this feature.

    Configuring Notifications

    In order to start sending Chatkit push notifications, follow the iOS or Android guide. Setup is just a few steps in the dashboard and in your code.

    Did you find this document useful?

    We are always striving to create the most accurate and informative docs as possible. If there is something especially wrong (or right) here then please let us know.