Facilitates connection to Genesys Cloud Web Messaging APIs and WebSockets in native mobile applications, offering integration guidance for Android, iOS, and multiplatform projects.
Genesys Cloud Messenger Transport SDK provides a library of methods for connecting to Genesys Cloud Web Messaging APIs and WebSockets from Android and iOS native applications.
To import and install the Messenger Transport SDK in an app, follow the instructions below for the appropriate platform.
Messenger Transport supports versions of Android 21 and up.
Add the following dependency to the dependencies section of your app's build.gradle file.
implementation 'cloud.genesys:messenger-transport-mobile-sdk-android:<version>'
Messenger Transport SDK supports versions of iOS 13.0 and up.
To install Messenger Transport SDK in your app with CocoaPods, follow this guidance.
In your Podfile, configure your target to include the GenesysCloudMessengerTransport pod dependency.
target 'TargetNameInYourXcodeProject' do
pod 'GenesysCloudMessengerTransport'
end
In a Terminal window, navigate to the project directory with your Podfile and Xcode project and run the CocoaPods install command:
$ pod install
CocoaPods will download and install the GenesysCloudMessengerTransport pod and any necessary dependencies.
The MessengerTransport module may now be imported and used in your project.
import MessengerTransport
We are excited to announce that Transport SDK now supports distribution via Swift Package Manager for iOS!
Note: Swift Package Manager support is available starting with Messenger Transport SDK 2.8.5.
To install Messenger Transport SDK in your app with SPM, follow this guidance.
Open your iOS project in Xcode If this is your first time using SPM we recommend reading the official documentation.
Add GenesysCloud dependency to your project
The MessengerTransport module may now be imported and used in your project.
import MessengerTransport
Add the following dependency to the dependencies section of your library's build.gradle file.
implementation 'cloud.genesys:messenger-transport-mobile-sdk:<version>'
Detailed documentation for Messenger Transport, including how to use the SDK and how to contribute to the project, can be found on the Wiki.
For help, troubleshooting, or to share feedback about the Messenger Transport SDK, please post in the Genesys Cloud Community Forum. It's the best place to get quick responses from Genesys experts and the developer community.
| Issue | Description | Details | Resolution | Affected Version |
|---|
completionHandler does not return response to fetchDeploymentConfig() and nextPage() | This issue is caused by a bug in an older version of Ktor, the Transport SDK's underlying network engine. | If the Logging plugin is installed, the Ktor client can deadlock or block after BODY START is printed to the console. Although the response is still returned to the calling function, any future requests will block. | On Ktor 2.x this issue was resolved. It is recommended to use Transport 2.3.0 or higher, that implements Ktor 2.x. In case a lower version is required, make sure to disable Ktor Login Plugin by setting the logging=false in the Configuration object on iOS. | iOS Transport 2.2.0 and lower |
Surfaced from shared tags and platforms — no rankings paid for.