Android

A Kotlin library with a Jetpack Compose support screen. minSdk 24, compileSdk 35.

Install#

app/build.gradle.kts

dependencies {
    implementation("app.parleyai:parley-android:0.1.0")
}

The artifact is published to Maven Central. Until a release is published, include the module from source: copy sdks/android into your project and add include(":parley-android", ":parley-core") to settings.gradle.kts.

Initialize#

class MyApp : Application() {
    override fun onCreate() {
        super.onCreate()
        Parley.initialize(this, appKey = "pk_live_…")
    }
}

Show support#

Parley.presentSupport(context)

Identify users#

Parley.identify(
    userId = user.id,
    email = user.email,
    name = user.name,
    userHash = session.parleyUserHash,
    attributes = mapOf("plan" to "pro", "seats" to 6),
) { result -> result.onFailure { Log.w("Parley", "identify failed", it) } }

// From a coroutine
lifecycleScope.launch { Parley.awaitIdentify(userId = user.id, userHash = session.parleyUserHash) }

// On sign-out
Parley.logout()

Name	Type	Description
Parley.initialize(context, appKey, options)	fun	Call once in Application.onCreate().
Parley.identify(...)	fun	Fire-and-forget with an optional callback.
Parley.awaitIdentify(...)	suspend fun	Coroutine version of identify.
Parley.updateCustomer(email, name, attributes)	fun	Update details.
Parley.track(name, properties)	fun	Record an event.
Parley.logout()	fun	End the session.
Parley.presentSupport(context)	fun	Opens ParleySupportActivity.
ParleySupportScreen(onClose)	@Composable	Embed in your own UI.
Parley.unreadCount	StateFlow<Int>	Unread replies, for badges.

See Appearance and Push notifications.