Skip to main content


If needed, your users can chat with you to provide you more details about their reported bugs, crashes or feedback. You will be able to fix issues faster and make your customers happier.


Once your user is registered with Shake, the chat feature is enabled automatically. Each ticket they send you will be a separate conversation.

This feature is tightly integrated with and follows the lifecycle of your User registration, which means that calling Shake.unregisterUser also disconnects the current user from chat and they won't receive any new messages until registered again.


Shake will notify your user when you send them a new message from the Shake dashboard. Notifications are presented automatically to the user. You don't have to code anything.


Shake supports only local notifications. That means that your users won't get notified about new messages when your app is in the background.


Notifications are automatically presented to the end-user, no additional code is required.


To present any kind of notifications to the end-user, the host application must request a permission from the user. Find a suitable place in your application flow where this native alert dialog will be presented.

In order to be highly customizable and minimally intrusive to existing notification logic of host applications, Shake requires additional setup outlined in the below snippets.

Use the UNUserNotificationCenter ...) methods to delegate the notification presentation logic to Shake.

import UIKit
import Flutter
import Shake
@objc class AppDelegate: FlutterAppDelegate {
override func application(
_ application: UIApplication,
didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
let center = UNUserNotificationCenter.current()
center.delegate = self
GeneratedPluginRegistrant.register(with: self)
return super.application(application, didFinishLaunchingWithOptions: launchOptions)
override func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
if response.notification.request.content.categoryIdentifier.contains(SHKNotificationCategoryIdentifierDomain) {, didReceive: response, withCompletionHandler: completionHandler)
override func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void){
if notification.request.content.categoryIdentifier.contains(SHKNotificationCategoryIdentifierDomain){, willPresent: notification, withCompletionHandler: completionHandler)
completionHandler([.badge, .sound, .alert])

Given the above setup, all notifications originated from Shake are handled by the Shake SDK, and all other notifications remain handled by your application.


You can cancel the display of notifications in certain contexts by simply not reporting anything to Shake, or even stub the received native completion handler with your own set of UNNotificationPresentationOptions which will be respected by the Shake SDK.

Unread messages

If you want to show number of unread chat messages somewhere in your app, you can set the unread messages listener. The listener is called immediately when set and on each change in the number of unread messages for a registered user:

Shake.setUnreadMessagesListener((int count) {
// Update number in your text element

To remove the unread messages listener, use Shake.setUnreadMessagesListener(null).