Add the messenger to your mobile app

Available on: Starter, Growth, Pro, Enterprise. This feature is in beta: it is still being built and may change.

Your customers can chat with you from inside your own app. The app shows the messenger full screen in a web view, with the same features and the same conversation as on your website.

Native messenger SDKs for iOS, Android, React Native and Flutter are written and in private beta: they wrap the same messenger and add push, the unread count and the camera. They are not in the public package registries yet, so talk to us if you want one. The web view approach below needs no SDK and works in any app today.

How it works

1. Your app opens https://app.chaosdesk.io/messenger/embed?key=WIDGET_KEY&locale=en in a web view. Take the widget key from Admin Center, Channels, Messenger.
2. The page opens the messenger in embedded mode: no launcher, the conversation fills the screen, and the header has a close button.
3. Your app calls zE(...) in the web view, for example loginUser so the conversation is the customer's on every device.
4. The messenger sends events back to your app: open, close (dismiss the web view), unreadMessages (for a badge) and the result of loginUser.

Keep the web view's data store persistent (the default) so the history survives app restarts.

Sign the customer in

Get the JWT from your own backend, the same way your website does. Never put the signing secret in the app. See Identify signed-in users in the messenger.

Code samples

The messenger SDK reference has the bridge names for iOS (WKWebView), Android (WebView) and React Native, and small samples for each.

Related

• Set up the web messenger
• Identify signed-in users in the messenger