Installation

Intercom for iOS supports iOS 8.x and iOS 9.x.

CocoaPods

Add the Intercom pod into your Podfile and run pod install.

use_frameworks!

target :YourTargetName do
  pod 'Intercom'
end

###Carthage

1. Add github "intercom/intercom-ios" to your Cartfile.
2. Run carthage update.
3. Go to your Xcode project's "General" settings. Drag Intercom.framework from Carthage/Build/iOS to the "Embedded Binaries" section. Make sure “Copy items if needed” is selected and click Finish.

Manual Installation

1. Download Intercom for iOS and extract the zip.

2. Go to your Xcode project's "General" settings. Drag Intercom.framework to the "Embedded Binaries" section. Make sure "Copy items if needed" is selected and click Finish.

3. Create a new "Run Script Phase" in your app’s target’s "Build Phases" and paste the following snippet in the script text field:

    bash "${BUILT_PRODUCTS_DIR}/${FRAMEWORKS_FOLDER_PATH}/Intercom.framework/strip-frameworks.sh"
   

This step is required to work around an App Store submission bug when archiving universal binaries.

##Sample app There is a sample app provided for both Objective-C and Swift. To use the sample app:

1. Go to the Sample-ObjC or Sample-Swift directory and run pod install.
2. Open Sample-ObjC.xcworkspace or Sample-Swift.xcworkspace in Xcode.
3. Set your iOS API key and App ID at the top of ITCAppDelegate.m or AppDelegate.swift.
4. Build and run.

##Setup and Configuration

• Our installation guide contains full setup and initialisation instructions.
• Read "Configuring Intercom for iOS".
• Please contact us on Intercom with any questions you may have, we're only a message away!

Upgrading to v3.0

Upgrading to the latest version of the iOS SDK is easy! 😉 Checkout out our upgrade guide for more info.

What about events, push notifications, company and user data?

Intercom for iOS has support for all these things. For full details please read our documentation.

Xcode Documentation

This documentation provides integrated help in Xcode for all public APIs in Intercom for iOS. Download the docset from the latest release and Copy the content into ~/Library/Developer/Shared/Documentation/DocSets.