Brand Concierge API reference (Android)

Managed Integration

The SDK manages the chat lifecycle. Provide a trigger UI element — the SDK shows it when the extension is ready and opens the chat as a full-screen dialog when the trigger is invoked.

Jetpack Compose

Syntax

Copy
@Composable
fun ConciergeChat(
    modifier: Modifier = Modifier,
    viewModel: ConciergeChatViewModel,
    surfaces: List<String>? = null,
    handleLink: LinkHandler? = null,
    content: @Composable (showChat: () -> Unit) -> Unit
)
Copied to your clipboard
@Composable
fun ConciergeChat(
    modifier: Modifier = Modifier,
    viewModel: ConciergeChatViewModel,
    surfaces: List<String>? = null,
    handleLink: LinkHandler? = null,
    content: @Composable (showChat: () -> Unit) -> Unit
)

Parameters

• viewModel required - A ConciergeChatViewModel instance. Obtain via viewModel<ConciergeChatViewModel>().
• surfaces - Surface identifiers sent to the Brand Concierge server.
• modifier - Optional Modifier to apply to the composable.
• handleLink - Optional LinkHandler callback. Return true to claim the URL; return false for default behavior.
• content required - Composable lambda receiving a showChat function. Call showChat() to open the chat.

Example

Copy
@Composable
fun MyScreen() {
    val viewModel = viewModel<ConciergeChatViewModel>()

    ConciergeChat(
        viewModel = viewModel,
        surfaces = listOf("web://example.com/your-surface.html")
    ) { showChat ->
        MyTriggerButton(onClick = { showChat() })
    }
}
Copied to your clipboard
@Composable
fun MyScreen() {
    val viewModel = viewModel<ConciergeChatViewModel>()

    ConciergeChat(
        viewModel = viewModel,
        surfaces = listOf("web://example.com/your-surface.html")
    ) { showChat ->
        MyTriggerButton(onClick = { showChat() })
    }
}

XML/Views

Syntax

Copy
fun bind(
    lifecycleOwner: LifecycleOwner,
    viewModelStoreOwner: ViewModelStoreOwner,
    surfaces: List<String>? = null,
    theme: ConciergeThemeData? = null,
    handleLink: ((String) -> Boolean)? = null,
    triggerView: View
)
Copied to your clipboard
fun bind(
    lifecycleOwner: LifecycleOwner,
    viewModelStoreOwner: ViewModelStoreOwner,
    surfaces: List<String>? = null,
    theme: ConciergeThemeData? = null,
    handleLink: ((String) -> Boolean)? = null,
    triggerView: View
)

Parameters

• lifecycleOwner required - The LifecycleOwner (typically your Activity or Fragment).
• viewModelStoreOwner required - The ViewModelStoreOwner (typically your Activity or Fragment).
• surfaces - Surface identifiers sent to the Brand Concierge server.
• theme - Optional ConciergeThemeData to apply to the chat UI.
• handleLink - Optional callback. Return true to claim the URL; return false for default behavior.
• triggerView required - The View that launches the chat when clicked.

Example

Copy
val chatView = findViewById<ConciergeChatView>(R.id.concierge_chat)
val triggerButton = Button(this).apply { text = "Chat" }

chatView.bind(
    lifecycleOwner = this,
    viewModelStoreOwner = this,
    surfaces = listOf("web://example.com/your-surface.html"),
    triggerView = triggerButton
)
Copied to your clipboard
val chatView = findViewById<ConciergeChatView>(R.id.concierge_chat)
val triggerButton = Button(this).apply { text = "Chat" }

chatView.bind(
    lifecycleOwner = this,
    viewModelStoreOwner = this,
    surfaces = listOf("web://example.com/your-surface.html"),
    triggerView = triggerButton
)

Custom Integration

Embed the chat interface directly into your screen and manage its lifecycle yourself. Use this for dedicated chat screens or custom layouts where you control when chat appears and handle dismissal.

Jetpack Compose

Syntax

Copy
@Composable
fun ConciergeChat(
    viewModel: ConciergeChatViewModel,
    onClose: () -> Unit,
    modifier: Modifier = Modifier,
    handleLink: LinkHandler? = null
)
Copied to your clipboard
@Composable
fun ConciergeChat(
    viewModel: ConciergeChatViewModel,
    onClose: () -> Unit,
    modifier: Modifier = Modifier,
    handleLink: LinkHandler? = null
)

Parameters

• viewModel required - A ConciergeChatViewModel instance. Obtain via viewModel<ConciergeChatViewModel>().
• onClose required - Callback invoked when the user dismisses the chat (back press, close button, or gesture).
• modifier - Optional Modifier to apply to the composable.
• handleLink - Optional LinkHandler callback. Return true to claim the URL; return false for default behavior.

Example

Copy
@Composable
fun YourChatScreen() {
    val viewModel = viewModel<ConciergeChatViewModel>()
    val conciergeState by ConciergeStateRepository.instance.state.collectAsStateWithLifecycle()
    val surfaces = listOf("web://example.com/your-surface.html")

    ConciergeStateRepository.instance.setSessionSurfaces(surfaces)

    val ready = conciergeState.configurationReady &&
        conciergeState.experienceCloudId != null &&
        conciergeState.surfaces.isNotEmpty()

    if (ready) {
        ConciergeChat(
            viewModel = viewModel,
            onClose = { /* navigate back */ }
        )
    }
}
Copied to your clipboard
@Composable
fun YourChatScreen() {
    val viewModel = viewModel<ConciergeChatViewModel>()
    val conciergeState by ConciergeStateRepository.instance.state.collectAsStateWithLifecycle()
    val surfaces = listOf("web://example.com/your-surface.html")

    ConciergeStateRepository.instance.setSessionSurfaces(surfaces)

    val ready = conciergeState.configurationReady &&
        conciergeState.experienceCloudId != null &&
        conciergeState.surfaces.isNotEmpty()

    if (ready) {
        ConciergeChat(
            viewModel = viewModel,
            onClose = { /* navigate back */ }
        )
    }
}

XML/Views

Syntax

Copy
fun bind(
    lifecycleOwner: LifecycleOwner,
    viewModelStoreOwner: ViewModelStoreOwner,
    surfaces: List<String>? = null,
    theme: ConciergeThemeData? = null,
    handleLink: ((String) -> Boolean)? = null,
    onClose: () -> Unit
)
Copied to your clipboard
fun bind(
    lifecycleOwner: LifecycleOwner,
    viewModelStoreOwner: ViewModelStoreOwner,
    surfaces: List<String>? = null,
    theme: ConciergeThemeData? = null,
    handleLink: ((String) -> Boolean)? = null,
    onClose: () -> Unit
)

Parameters

• lifecycleOwner required - The LifecycleOwner (typically your Activity or Fragment).
• viewModelStoreOwner required - The ViewModelStoreOwner (typically your Activity or Fragment).
• surfaces - Surface identifiers sent to the Brand Concierge server.
• theme - Optional ConciergeThemeData to apply to the chat UI.
• handleLink - Optional callback. Return true to claim the URL; return false for default behavior.
• onClose required - Callback invoked when the user dismisses the chat.

Example

Copy
val chatView = findViewById<ConciergeChatView>(R.id.concierge_chat)

chatView.bind(
    lifecycleOwner = this,
    viewModelStoreOwner = this,
    surfaces = listOf("web://example.com/your-surface.html"),
    onClose = { finish() }
)
Copied to your clipboard
val chatView = findViewById<ConciergeChatView>(R.id.concierge_chat)

chatView.bind(
    lifecycleOwner = this,
    viewModelStoreOwner = this,
    surfaces = listOf("web://example.com/your-surface.html"),
    onClose = { finish() }
)

ConciergeThemeLoader.load

Loads a ConciergeThemeData from a JSON file in the app's assets directory. Returns null if the file cannot be found or parsed.

Syntax

Copy
@JvmStatic fun load(context: Context, filename: String): ConciergeThemeData?
Copied to your clipboard
@JvmStatic fun load(context: Context, filename: String): ConciergeThemeData?

Parameters

• context required - An Android Context used to access the assets directory.
• filename required - The filename of the JSON theme file (including the .json extension).

Example

Copy
val theme = ConciergeThemeLoader.load(context, "my-theme.json")
    ?: ConciergeThemeLoader.default()
Copied to your clipboard
val theme = ConciergeThemeLoader.load(context, "my-theme.json")
    ?: ConciergeThemeLoader.default()

ConciergeThemeLoader.default

Returns the built-in default ConciergeThemeData.

Syntax

Copy
@JvmStatic fun default(): ConciergeThemeData
Copied to your clipboard
@JvmStatic fun default(): ConciergeThemeData

Example

Copy
val theme = ConciergeThemeLoader.default()
Copied to your clipboard
val theme = ConciergeThemeLoader.default()

Last updated 4/22/2026

Was this helpful?

Yes

No