Intercom Android SDK 使用教程

Intercom Android SDK 使用教程

intercom-android Intercom for Android, for integrating Intercom into your Android application. 项目地址: https://gitcode.com/gh_mirrors/in/intercom-android

1. 项目介绍

Intercom Android SDK 是一个开源库，用于将 Intercom 的功能集成到 Android 应用程序中。它允许开发者轻松添加消息传递、用户支持、推送通知等功能，从而与用户建立更紧密的互动。

2. 项目快速启动

安装 Intercom SDK

首先，确保你的 Android 项目支持 API 21 或更高版本。

选项 1：使用 Firebase Cloud Messaging (FCM) 安装 Intercom

在你的应用的 build.gradle 文件中添加以下依赖：

dependencies {
    implementation 'io.intercom.android:intercom-sdk:15.16.0'
    implementation 'com.google.firebase:firebase-messaging:24.1.+'
}

选项 2：不使用推送消息安装 Intercom

如果你不希望在应用中添加推送通知，可以使用以下依赖：

dependencies {
    implementation 'io.intercom.android:intercom-sdk-base:15.16.0'
}

配置 ProGuard

如果你正在使用 ProGuard，请添加以下规则：

-keep class io.intercom.android.** { *; }
-keep class com.intercom.** { *; }

你可能还需要为 OkHttp、Okio 和 Retrofit 等依赖库添加规则。

请求权限

对于目标 Android 13 的应用，你需要请求运行时权限以启用通知。在代码中添加以下代码：

registerForActivityResult(ActivityResultContracts.RequestPermission()) { isGranted ->
    if (isGranted) {
        // 权限已授予。继续你的应用操作或工作流。
    } else {
        // 向用户解释该功能不可用，因为该功能需要一个用户已拒绝的权限。同时，尊重用户的选择。不要尝试引导用户进入系统设置以更改他们的决定。
    }
}

3. 应用案例和最佳实践

集成 Intercom Messenger

在你的应用中集成 Intercom Messenger，以便用户可以通过应用内的按钮与你的团队进行交流。你可以在用户执行特定操作时程序化地触发 Messenger，或者在你的应用 UI 上放置一个持久按钮。

Intercom.client().displayMessenger();

定制化 Messenger

在 Intercom 的设置中，你可以定制 Messenger 的外观和行为，以满足你的品牌和用户体验需求。

发送消息

使用 Intercom SDK，你可以向用户发送各种类型的消息，包括推送通知、聊天、轮播图、简报和全屏公告。

Intercom.client().sendMessage(new Message("Hello, World!"));

用户支持

如果你的用户需要帮助，他们可以通过 Intercom 发起对话。这些对话会出现在你的 Intercom 收件箱中，你可以实时回复。

4. 典型生态项目

Intercom Android SDK 是 Intercom 生态系统的一部分，该生态系统还包括用于其他平台的 SDK，如 Web、iOS 等。此外，还有针对特定框架（如 Cordova/Phonegap）的插件，以支持更广泛的应用开发需求。通过这些项目，开发者可以为不同平台和设备构建一致的用户体验。

intercom-android Intercom for Android, for integrating Intercom into your Android application. 项目地址: https://gitcode.com/gh_mirrors/in/intercom-android