Add the Service SDK Frameworks with CocoaPods

Add the SDK frameworks using CocoaPods, a developer tool that automatically manages dependencies.

The legacy chat product is scheduled for retirement on February 14, 2026, and is in maintenance mode until then. During this phase, you can continue to use chat, but we no longer recommend that you implement new chat channels. To avoid service interruptions to your customers, migrate to Messaging for In-App and Web before that date. Messaging offers many of the chat features that you love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in Help.

Important

If you haven't already done so, install the CocoaPods gem and initialize the CocoaPods main repository.
1sudo gem install cocoapods 2pod setup
The minimum supported version of CocoaPods is 1.0.1. If you're not sure what version you have, use pod --version to check the version number.
Note
If you already have CocoaPods installed, update your pods to the latest version.
1pod update
Change to the root directory of your application project.

Create or edit a file named Podfile that contains the Service Chat SDK dependency.

If you want to install the complete Service Chat SDK, update your Podfile to include ServiceSDK.

1source 'https://github.com/CocoaPods/Specs.git'
2source 'https://github.com/goinstant/pods-specs-public'
3
4# To use the SDK (with all components)
5target '<your app target>' do
6    pod 'ServiceSDK'
7end

If you want to install a single Service Chat SDK component, create a similar Podfile to the one specified above, but only include the desired pod.

Feature	Pod name
Chat	`ServiceSDK/Chat`

For example, the following Podfile installs Chat.

1source 'https://github.com/CocoaPods/Specs.git'
2source 'https://github.com/goinstant/pods-specs-public'
3
4# To use Chat
5target '<your app target>' do
6    pod 'ServiceSDK/Chat'
7end

If you don't specify a version number, you automatically get the latest version of that component. If you want to add a specific version to your component, be sure to add the version number of the Service Chat SDK and not the version number of the individual component.

Run the CocoaPods installer.
1pod install
This command generates a .xcworkspace file for you with all the dependencies included.

If you run into issues installing or updating the SDK, clear the local CocoaPods cache and then perform a pod update.
Note
Open the .xcworkspace file that CocoaPods generated and continue with the installation process.

Be sure to open the .xcworkspace file (which includes all the dependencies) and not the .xcodeproj file.
Note

Once you've added the SDK frameworks, proceed with the installation instructions.

Embedded Service Chat SDK for iOS Developer Guide

Add the Service SDK Frameworks with CocoaPods