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 room with many users or just 1-1 — the Chatkit push notifications service checks whether the recipients are online.

If users in the private room 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 room.

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 room name — the name of the private room where the missed message occurred, as defined by your running Chatkit service
  • Chatkit message body — the first message part of type text/plain from the missed message, automatically truncated with an … at 140 characters to adhere to operating system limits.
  • Chatkit does not currently send media attachments in push notifications. If a message does not have an inline part of type text/plain then we will not send a notification for that message.

    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.