Release Notes

This is the developer guide for Chat SDK v1. The new Chat SDK v2 for iOS is now available and is the recommended version to integrate Chat into your mobile app. It also removes the dependency on UIWebView which has been deprecated by Apple.

Version 1.4.7

  • Added a way to clear the identity of a visitor, effectively causing the SDK to treat them as new. Just call resetIdentity on ZDCChat when needed (for example, when a visitor logs out).

Version 1.4.6

  • Fixed an issue affecting pre-chat forms, that would stop a visitor from starting a chat.
  • Fixed an issue that could stop some visitors from starting a chat, due to a side effect of keyboard registration events.
  • If manually integrating 1.4.6 and above please ensure that the -ObjC linker flag is present in Other Linker Flags under the Build Settings of your target. Please see more info here.

Version 1.4.5

  • Fixed a keyboard layout issue that occurred when the isTranslucent property of the UINavigationBar was set to false.
  • Fixed an issue where visitors couldn't leave a comment on a chat rating.
  • Fixed an issue where the agent attachment message cell would load indefinitely.
  • Fixed an issue that could cause the status of a department to be incorrectly reported.
  • Addressed some memory leaks.

Version 1.4.4

  • Fixed some bugs that were causing keyboard layout issues on iOS 13.
  • Fixed an issue where the department would not be correctly set on chats after a previous timeout.
  • Fixed an issue that could stop users from leaving an offline message.

Version 1.4.3

  • Bug fixes.
  • You can now control the way the chat window gets displayed by setting chatModalPresentationStyle.

Version 1.4.2

  • Fixed some bugs and in particular, issues with iOS 13.
  • Added a way to identify a Chat notification.

Version 1.4.1

  • Improved support for agent availability monitoring in the chat window. You can now enable a feature that will provide a more accurate real time reflection of agent availability. You can enable this feature by calling enableAgentAvailabilityObserving on ZDCChat and passing true/YES. We suggest disabling the overlay as this can improve the reliability of this feature (see Hiding the chat overlay).
  • Provided a workaround for some triggers not firing when setting the department. If experiencing this issue, you can call updateDepartment once the chat session is connected and pass the department (see Connection events).
  • Safer handling of notifications to reduce crashes experienced by some users.
  • Added a way to disable or set a timeout for the connection status banner messages if they aren't needed or are causing a problem. This can be achieved by setting showsConnectionBar or connectionBarAutoCloseDuration on ZDCConfig.

Version 1.4.0

  • Added support for push notifications.


  • Targets iOS 9, and requires Xcode 9+
  • Fixed iPhone X issues.


  • An update to improve the security of the client's connection to Chat. We recommend that all customers upgrade to this version.


  • Fixed a bug that would not show departments and not start the chat if agent's status is ‘Away’.


  • Fixed a bug that would allow the chat to start when the departments are offline.


  • Fixed a bug to allow special characters to be sent.


  • Fixed a lag issue that happens when writing the chat message on some devices.
  • Added addNote method to ZDCVisitorInfo.
  • Added setNote and appendNote to ZDCChatAPI.


  • Fixed issues occurring on iOS 10.
  • Fixed an issue that causes the chat view controller to pop the active controller twice.


  • Fixed an issue with library not containing bitcode support for some slices.


  • Introducing ZDCChatAPI framework which allows developers to create their own chat UIs.
  • Fixed a UITableViewDelegate NSInternalInconsistency crash that was happening when agents went offline and online or the internet connection was lost.
  • Fixed a crash that was happening when trying to display the chat UI in a background thread.
  • Fixed a crash that was happening when displaying the camera on iPods and in Simulators.
  • Fixed an issue that would prevent the Photo Library/Camera to be displayed in custom tab bar apps.
  • Fixed an issue that disabled the back button/end chat button in some particular situations.
  • Fixed a UI bug that introduced a blank space between the keyboard and the chat text field.
  • Added appearance selector for "Leave comment.." button
  • General bugs fixing and improvements.


  • Fixed crashes in the Chat SDK when using [ZDCEvents trackEvent:] on 32 bit iOS devices.
  • Fixed multiple issues where setting appearance would not work.
    • Fixed [ZDCRatingCell titleColor] and [ZDCRatingCell titleFont] appearances
    • Fixed placeholder margins for ZDUTextView
  • General bugs fixing and improvements.


  • Added appearance selectors to allow the customization of ZDCChatOverlay.
  • Fixed multiple issues where setting appearance would not work.
  • Fixed crashes in the Chat SDK when the agent went offline and kept typing.
  • Fixed issue when using the Chat SDK with Swift.
  • Fixed issue of notifications not being fired when the chat view is unloaded.

Version 1.1.3

  • Fixed an issue where chat text field became hidden behind other UI elements.

Version 1.1.2

  • Fixed issue where setting the overlay to enabled/disabled before setting overlay appearance blocked the application of the new appearance.
  • Fixed occasional crash when minimizing a chat too soon after sending a message.
  • Fixed framework bitcode.
  • Fixed UI presentation issue when re-entering a chat while disconnected/reconnecting.
  • Set default cell type to handle edges case state transitions.
  • Fixed layout of chat UI when used in conjunction with a tab bar.
  • Fixed keyboard resign on iOS 9 when presenting action sheets.
  • Updated sample app to permit connection to any domain.

Version 1.1.1

  • Updated readme with latest CocoaPods details.
  • Fixed clang settings to remove build warnings when using the framework.
  • Fixed trailing newline to remove build warning.

Version 1.1

  • Added visitor event tracking.
  • Added option to disable the chat widget.
  • Updates to sample configs/styling.
  • Minor bug fixes.

Version 1.0

  • Added attachment handling for uploads and downloads.
  • Added chat ratings.
  • Improved session handling.
  • Fixed z-index of chat background image when set directly.

Version 0.9.3

  • Added NSNotifications for customizing the provided UI on presentation.
  • Ability to directly set a background image for the chat UI.
  • Shortcut option lists.

Version 0.9.2

  • Links in chat messages are now active.
  • Added appearance attributes for controlling the background color of all chat views.
  • Added appearance attribute for setting a background image for the chat views.
  • Improved handling of transparent/translucent nav bars.
  • Fixed an issue where the keyboard presented over the email transcript dialog.
  • Fixed layout issue when presenting as CurrentContext or FullScreen.
  • Fixed timeout message appearance when resuming a timed out chat from the widget.

Version 0.9.1

  • Fixed framework symlinks.
  • Improved background handling.

Version 0.9.0

  • First beta release.