Menu

Expand
Rate this page:

Twilio Conversations Client SDKs

Twilio provides client-side Conversations SDKs for browser-based web applications, as well as for native iOS and Android applications.

JavaScript SDK

The latest version of the JavaScript SDK for Conversations is available on Twilio’s CDN. To include it on your web page, simply add a <script> tag mentioned in the change log section for the version you're interested in.

The Twilio.Conversations namespace will then be available in the window scope of your JavaScript application.

The JS Conversations SDK is also available from NPM.

Android SDK

The Twilio Conversations Android SDK is distributed as a direct download from Twilio’s CDN. It can also be installed via Maven or directly within a Gradle build file using Maven Central.

Direct download

Download the Twilio Conversations Client library for Android from the Twilio CDN. The download’s SHA-256 is:

a0c5e8acd95ed33d33098f51181a1cf1ab0d7c9837c92333e79ffa4311347c66

Maven Central

Twilio Conversations is available from Maven Central.

Gradle

To install via Gradle, include the following in your Gradle build file:

allprojects {
  repositories {
    mavenCentral()
  }
}

/**
 * Declare dependencies
 * @see http://www.gradle.org/docs/current/userguide/userguide_single.html#sec:how_to_declare_your_dependencies
 */
dependencies {
  implementation 'com.twilio:conversations-android:1.6.0'
}

Your Android project needs compatibility with Java 8 language features. If you have not already done so, add the following section to the android module in your build.gradle file:

android {
  ...
  compileOptions {
    sourceCompatibility JavaVersion.VERSION_1_8
    targetCompatibility JavaVersion.VERSION_1_8
  }
  ...
}

iOS SDK

The Conversations SDK for iOS is available through the CocoaPods and Swift Package Manager dependency managers, or by direct download.

We do not currently support the Carthage package manager because it does not support binary XCFramework files.

CocoaPods

To install the SDK using CocoaPods, add the following to your Podfile, changing MyTarget to the name of your target:

source 'https://github.com/CocoaPods/Specs'

target 'MyTarget' do
  pod 'TwilioConversationsClient', '~> 1.3'
end

Swift Package Manager

To install the SDK with Swift Package Manager, add the following dependency to your project:

https://github.com/twilio/conversations-ios
  1. Open your project in Xcode.
  2. Select File > Swift Packages > Add Package Dependency....
  3. Enter https://github.com/twilio/conversations-ios into the search field in the Choose Package Repository dialog, then click Next.
  4. Make your versioning choice and click Next.
  5. Add the package to one of your targets and click Finish.

Direct download

We also offer the iOS SDK frameworks for download. There are several steps you’ll need to complete to successfully add Conversations to your project:

  1. Download the Conversations Client framework from the Twilio CDN.
  2. Confirm the download’s SHA-0256: 9173516f6158c2a4009956cc1f680cc99bb4c3f3160ac52fd513023f762bf6f1
  3. Expand the downloaded .zip file and locate the .xcframework file(s) inside the directory created.
  4. Drag the .xcframework file(s) into your Xcode project, making sure they are dropped in the Frameworks, Libraries, and Embedded Content section of your project target’s settings. Make sure you select Copy items if needed when prompted. If the framework file(s) do not appear under Frameworks, Libraries, and Embedded Content for your target, you will receive a Reason: image not found" error during compilation.
  5. Add libc++.tbd as a dependency to your target if it is not already there.
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Community Forums or browsing the Twilio tag on Stack Overflow.

        
        
        

        Thank you for your feedback!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more