Contact usRequest a demo

iOS mobile SDK release notes

This page contains the release notes for version 4 of the iOS mobile SDK. The release notes are broken down in sections to allow for easier consumption. Release notes are additive, which means that to cover all improvements between two defined release states, all individual release notes have to be considered.

The release notes of version 3 of the iOS mobile SDK are available in the documentation for Unblu 6.

The release notes of version 2 of the iOS mobile SDK are available in the documentation for Unblu 5.

You must update Unblu Spark before you update the Android mobile SDK. If you don’t, the SDK may not work properly.

The release notes for Unblu Spark and the Android mobile SDK are published separately.

iOS mobile SDK 4.8.0 release notes

Release date: 06 May 2024

Built with Xcode 15.3


  • MSDKIOS-469 - Mobile co-browsing indicator stays on screen

New features and improvements

  • MSDKIOS-397 - Collapsed conversation indicator and custom Picture-in-Picture (PiP)

  • MSDKIOS-406 - New co-browsing button in accordance with new design guidelines

  • MSDKIOS-408 - Provide native Picture-in-Picture (PiP) capability

  • MSDKIOS-413 - Visualize dial-in state in call or mic volume if not dialed in

  • MSDKIOS-428 - Add a context menu to indicator

  • MSDKIOS-404 - Add possibility to go into modal presentation mode

  • MSDKIOS-424 - Use Collaboration Server configuration properties for mobile indicators

  • MSDKIOS-450 - Allow setting labels with Unblu iOS SDK

  • MSDKIOS-460 - Add API to retrieve list of conversations and events for it

  • MSDKIOS-461 - Add specific error types for PIN entry errors

  • MSDKIOS-470 - Provide additional protocol for mobile co-browsing indicator clicks

iOS mobile SDK 4.7.10 release notes

Release date: 09 February 2024

Built with Xcode 14.2

If you use the Unblu Swift packages with Xcode version 15.3, your app won’t pass verification in the Xcode cloud or the Swift packager manager (SPM). If possible, use Xcode 15.2 or older to build your app.

If you need a version of the Unblu Swift packages that can be verified with Xcode 15.3, contact the Unblu support team.


  • MSDKIOS-380 - Call terminated in browser when call times out on mobile

  • MSDKIOS-448 - Audio and video stream not working correctly with LiveKit

New features and improvements

  • MSDKIOS-444 - Improve user agent version value

iOS mobile SDK 4.7.8 release notes

Release date: 05 December 2023

Built with Xcode 14.2


  • MSDKIOS-442 - HTTP call reject request doesn’t work until API starts

New features and improvements

  • MSDKIOS-430 - Create client/server certificate authentication

iOS mobile SDK 4.7.7 release notes

Release date: 20 October 2023

Built with Xcode 14.2


  • MSDKIOS-437 - Dead area on screen due to hidden call UI

iOS mobile SDK 4.7.6 release notes

Release date: 18 September 2023

Built with Xcode 14.2


  • MSDKIOS-422 - LayerType for whiteboard missing

  • MSDKIOS-431 - Delegation of LiveKit participants only added for participants with a video track

iOS mobile SDK 4.7.5 release notes

Release date: 23 August 2023

Built with Xcode 14.2

New feature/improvement

  • MSDKIOS-400 - Fetch Unblu visitor PersonInfo without starting a conversation

  • MSDKIOS-411 - Webview not deallocated because of retain cycle

iOS mobile SDK 4.7.3 release notes

Release date: 27 July 2023

Built with Xcode 14.2


  • MSDKIOS-385 - Incomplete UI if WebView displayed before SDK initialization completed

  • MSDKIOS-398 - Private area duplicated and added/anchored to floating button

  • MSDKIOS-399 - "Stop co-browsing" alert window doesn’t use server text settings

New feature/improvement

  • MSDKIOS-394 - Debug option for iOS 16.4+

  • MSDKIOS-285 - iOS custom action API trigger

  • MSDKIOS-391 - Add show UI and decline call events to NotificationCenter

iOS mobile SDK 4.7.2 release notes

Release date: 12 July 2023

Built with Xcode 14.2


  • MSDKIOS-341 - Wrong event flow for visibility and call UI events in UnbluClientDelegate

  • MSDKIOS-348 - Remove and destroy call publisher and subscriber views on disconnect

  • MSDKIOS-393 - "Missed call" notification on locked screen disappears after less than 1 second if autostart webview turned off and on

  • MSDKIOS-396 - Confirmation dialog not showing when tapping on co-browsing button in SwiftUI apps

New feature/improvement

  • MSDKIOS-347 - Improved UI for video calls

iOS mobile SDK 4.7.1 release notes

Release date: 05 June 2023

Built with Xcode 13.3


  • MSDKIOS-266 - Participants who have denied access to camera aren’t shown in video calls

  • MSDKIOS-301 - Camera turned off when navigating to home screen during active call

  • MSDKIOS-335 - "Go to app" icon missing on button to open app after accepting call on locked screen

  • MSDKIOS-375 - Some internal fields of UnbluNotificationApi exposed in documentation

  • MSDKIOS-382 - Authorization header not on native HTTP requests

  • MSDKIOS-392 - Video stream of mobile user activated when navigating away and back to Unblu UI during active audio call

New feature/improvement

  • MSDKIOS-345 - Adapt audio level indication to web implementation

  • MSDKIOS-386 - Add service worker error handler

  • MSDKIOS-372 - Add authorization header support

  • MSDKIOS-378 - Add API events when user gets unauthenticated

iOS mobile SDK 4.6.1 release notes

Release date: 23 March 2023

Built with Xcode 14

Starting with Xcode 14, Apple no longer supports bitcode. As of iOS mobile SDK 4.6.1, the xcframework files provided by Unblu therefore no longer contain bitcode.


  • MSDKIOS-349 - Co-browsing indicator still displayed after iPhone is locked

New feature/improvement

  • MSDKIOS-342 - Provide possibility to check if a notification is from Unblu

  • MSDKIOS-360 - Add "connect" stage when connecting to a LiveKit room

  • MSDKIOS-361 - Including CallKit in coreSDK causes issues in Apple approval process when China is a required distribution region

  • MSDKIOS-367 - Move the implementation using CallKit to a separate module

  • MSDKIOS-338 - Integrate LiveKit native SDK

  • MSDKIOS-350 - Provide SDK via cocoapods and swift packages

  • MSDKIOS-368 - Picture-in-picture for VoIP calls

  • MSDKIOS-369 - Background blur for LiveKit VoIP video calls

Removed Feature

  • MSDKIOS-352 - Remove package generation with bitcode

iOS mobile SDK 4.5.5 release notes

Release date: 24 January 2023

Built with Xcode 13.3

New feature/improvement

  • MSDKIOS-275 - Enable Vonage IP whitelisting

iOS mobile SDK 4.5.4 release notes

Release date: 23 December 2022

Built with Xcode 13.3


  • MSDKIOS-344 - Co-browsing indicator stays in vertical position when the phone is in horizontal view

iOS mobile SDK 4.5.3 release notes

Release date: 08 December 2022

Built with Xcode 13.3

There is a known issue where the mobile co-browsing indicator doesn’t adapt if the visitor changes the orientation of their device from vertical to horizontal during a mobile co-browsing session.

The issue will be fixed in an upcoming release.


  • MSDKIOS-321 - Width of chat messages incorrect after locking and unlocking the device

  • MSDKIOS-340 - Co-browsing: on iPads, sometimes part of the frame isn’t drawn in split mode

New feature/improvement

  • MSDKIOS-299 - Mobile co-browsing indicator added

iOS mobile SDK 4.5.2 release notes

Release date: 16 November 2022

Built with Xcode 13.3


  • MSDKIOS-295 - Visitor and agent SDKs become unresponsive when a call starts

  • MSDKIOS-320 - Wrong call type displayed on inbound call dialog for incoming video calls when the app is open

  • MSDKIOS-326 - Webview report call arrives before the Pushkit report, potentially leading to a call without a report

  • MSDKIOS-332 - Source synchronization issue when the command to display the incoming call UI comes from two different sources

New feature/improvement

  • MSDKIOS-323 - Disable shared debug information in the UnbluCallModule static library

  • MSDKIOS-322 - Play audio message when CallKit is displayed to open app

  • MSDKIOS-327 - Make the resource name for the CallKit video button configurable

iOS mobile SDK 4.4.0 release notes

Release date: 27 October 2022

Built with Xcode 13.3

When using version 4.4.0 of the iOS mobile SDK with version 7.20.0, the Collaboration Server doesn’t send push notifications for new messages to agents.

The issue will be fixed in an upcoming release of the Collaboration Server.


  • MSDKIOS-312 - Messages aren’t marked as read when opening a conversation via push notification

  • MSDKIOS-318 - After accepting the call, if the phone is locked, the incoming call UI is closed unexpectedly after unlocking

New feature/improvement

  • MSDKIOS-135 - Access token authentication for iOS mobile SDK

  • MSDKIOS-317 - Customizable image for the CallKit video button

iOS mobile SDK 4.3.4 release notes

Release date: 22 September 2022

Built with Xcode 13.3

iOS mobile SDK 4.3.4 requires Unblu Collaboration Server 7.18.2. If you use an older version of the Collaboration Server with this version of the SDK, notifications don’t function at all.
If your app uses the CallKit and VoIP functions of the iOS mobile SDK, review the information about the App Store review process in the Unblu documentation^.


  • MSDKIOS-302 - Two push notifications delivered for one new message when the app is force closed

  • MSDKIOS-309 - Outgoing call doesn’t disconnect after being declined by the counterpart

  • MSDKIOS-310 - No notifications for new messages when the app is in the foreground but the conversation UI is closed

  • MSDKIOS-311 - Agent app: Outgoing call doesn’t disconnect after being declined by the counterpart

New feature/improvement

  • MSDKIOS-291 - Register push token with version and handle returned shared secret

iOS mobile SDK 4.2.3 release notes

Release date: 16 August 2022

Built with Xcode 13.3


  • MSDKIOS-300 - Crash when starting audio call in simulator with latest Tokbox version

iOS mobile SDK 4.2.2 release notes

Release date: 17 June 2022

Built with Xcode 13.3


  • MSDKIOS-287 - iOS SDK 4.1.2 - Memory leak identified

New feature/improvement

  • MSDKIOS-205 - Show loading UI while directly opening one conversation

  • MSDKIOS-290 - Implement activity callback on iOS mobile SDK API

iOS mobile SDK 4.2.1 release notes

Release date: 09 May 2022

Built with Xcode 13.3


  • MSDKIOS-280 - Agent test app: Push notifications for new message forwarded to the inbox

  • MSDKIOS-288 - Setting specific conversation recipient via IOS SDKs doesn’t work

New feature/improvement

  • MSDKIOS-277 - Add API for setting conversation recipient to an agent via the mobile SDKs

iOS mobile SDK 4.1.2 release notes

Release date: 30 March 2022


  • MSDKIOS-278 - Incoming call: The avatar of the other participant is not displayed correctly

New feature/improvement

  • MSDKIOS-273 - SDK compatibility with Swift version 5.5.2

iOS mobile SDK 4.0.5 release notes

Release date: 30 November 2021

New feature/improvement

  • MSDKIOS-259 - External link click handler should decide whether it shows a dialog on block

iOS mobile SDK 4.0.4 release notes

Release date: 16 November 2021

This version of the iOS mobile SDK is the same as version 4.0.3, but compiled with Xcode 12.5 rather than Xcode 13.

iOS mobile SDK 4.0.3 Release Notes

Release date: 14 October 2021


  • MSDKIOS-250 - WebView Logs content is swallowed

  • MSDKIOS-251 - Enable Library evolution support

  • MSDKIOS-254 - Mobile SDK: Naming issue, "API" should be removed

  • MSDKIOS-256 - SDK deinitialized after entering wrong PIN

  • MSDKIOS-257 - unread messages count not exposed and event never emits 0

New Feature / Improvement

  • MSDKIOS-248 - Provide iOS SDK builds with and without enabled bitcode

iOS mobile SDK 4.0.0-beta.1 Release Notes

Release date: 17 August 2021


  • MSDKIOS-238 - IOS SDK: Native notification not displayed after taking video snapshot

New Feature / Improvement

  • MSDKIOS-186 - Mobile SDK: Refactor internal event handling

  • MSDKIOS-225 - Update the way we read device orientation

  • MSDKIOS-227 - Add a dialog if an URL is blocked for security reasons