Add the Service SDK Frameworks Manually

Add the SDK frameworks by manually embedding the appropriate frameworks.

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.

If you are using Xcode 12.3 or later, you must install the SDK using XCFramework files.

  1. Download the SDK frameworks from the Service Chat SDK download page.

  2. Embed the relevant Service Chat SDK frameworks into your project.

    You can find the framework files within the Frameworks folder. Specifically, the following frameworks are available for you to use:

    FrameworkDescription
    ServiceCoreContains all the common components used by the Service SDK.
    ServiceChatContains access to the Chat features of the SDK.

    Add the relevant frameworks to the Frameworks, Libraries, and Embedded Content section of the General tab for your target app.

    Before embedding a framework into your project, be sure to copy the framework file into your project folder (or another location found in the framework search path). If Xcode can’t find the framework, you won’t be able to access its contents in your code.

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