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
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.
| 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 |