AndroidでZendeskモバイルSDKを統合する方法：完全ガイド

Androidアプリにカスタマーサポートを直接組み込むことは、実際に実装しようとするまでは簡単に見える機能の1つです。ユーザーはアプリを離れることなくヘルプを得ることを期待しており、ZendeskのモバイルSDKはそれを実現するように設計されています。しかし、Zendeskは複数のSDKオプションを提供しており、間違ったものを選択すると、後々余分な作業が発生する可能性があります。

このガイドでは、ZendeskモバイルSDKをAndroidアプリに統合する方法を説明します。最新のMessaging SDKと従来のSupport SDKの両方をカバーするため、ニーズに合ったものを選択できます。また、アプリ内サポートに対する別のアプローチを提供するeesel AIも紹介します。これにより、開発時間を節約できる可能性があります。

ZendeskモバイルSDKのAndroid統合のためのSDKオプションを理解する

コードを記述する前に、どのSDKを使用するかを決定する必要があります。Zendeskは現在、2つの主要なAndroid SDKを維持しており、それぞれ異なるユースケースに対応しています。

Zendesk Messaging SDK（推奨）

Messaging SDKは、Zendeskの最新のアプローチです。リアルタイムでサポートエージェントとメッセージをやり取りできる会話型チャットインターフェイスを提供します。チャットアプリをアプリケーションに直接埋め込むようなものだと考えてください。

このSDKは、次のような場合に最適です。

• リアルタイムの会話型サポートが必要な場合
• チームがZendesk Agent Workspaceを使用している場合
• 入力インジケーターや既読確認などの機能が必要な場合
• 新しいメッセージのプッシュ通知がユーザーにとって重要な場合

Zendesk Support SDK（クラシック）

Support SDKは、古いながらもまだ維持されているオプションです。ライブチャットではなく、ヘルプセンターへのアクセスとチケットの作成に重点を置いています。

このSDKは、次のような場合に最適です。

• ユーザーがサポートに連絡する前にヘルプ記事を閲覧できるようにしたい場合
• ワークフローがチャットベースではなくチケットベースの場合
• 広範なUIカスタマイズオプションが必要な場合
• すでに従来のZendeskインターフェイスを使用している場合

Sunshine Conversations SDK

より複雑なユースケースには、Sunshine Conversations SDKもあります。これは通常、基本的なアプリサポートには過剰ですが、複数のプラットフォームでオムニチャネルメッセージングが必要な場合は検討する価値があります。

結論として、新たに始める場合は、Messaging SDKを使用してください。Zendeskが開発に力を入れている分野であり、ユーザーエクスペリエンスがよりモダンに感じられます。

ZendeskモバイルSDKのAndroid統合のための前提条件

コーディングを開始する前に、以下を確認してください。

• Zendesk SupportまたはSuiteアカウント（無料トライアルから始めることができます）
• Gradleを使用したAndroid Studio
• 最小SDK：APIレベル21（Android 5.0） - これはアクティブなAndroidデバイスの約95％をカバーしています
• Java 8以降
• Zendesk管理者からのチャネルキー（Messaging SDKの場合）またはアプリの認証情報（Support SDKの場合）

また、Zendesk管理センターでモバイルアプリを登録する必要があります。Zendesk管理者は、コードで使用する初期化認証情報を生成する必要があります。この手順は見落としがちなので、統合を開始する前に完了させてください。

ZendeskモバイルSDKのAndroid統合ガイド（ステップバイステップ）

Messaging SDKの統合について説明します。これは、ほとんどのチームが2026年に使用する必要があるものです。

ステップ1：Zendeskアカウントを構成する

まず、Zendesk管理センターにログインし、チャネルセクションに移動します。Androidアプリを登録して、チャネルキーを取得する必要があります。

そこにいる間に、認証アプローチを決定します。

• 匿名：ユーザーはログインする必要はありません（最も簡単なオプション）
• JWT：認証されたユーザーの場合、バックエンドがトークンを生成する必要があります

ほとんどのアプリでは、匿名認証から始めるのが適切です。JWTはいつでも後で追加できます。

ステップ2：SDKをプロジェクトに追加する

Android Studioでプロジェクトを開きます。まず、Zendesk Mavenリポジトリをsettings.gradle.ktsに追加します。

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://zendesk.jfrog.io/zendesk/repo") }
    }
}

次に、依存関係をアプリレベルのbuild.gradleに追加します。

dependencies {
    implementation "zendesk.messaging:messaging-android:2.37.0"
}

Java 8の互換性を構成することを忘れないでください。

android {
    compileOptions {
        sourceCompatibility JavaVersion.VERSION_1_8
        targetCompatibility JavaVersion.VERSION_1_8
    }
}

次のステップに進む前に、プロジェクトをGradleファイルと同期します。

ステップ3：SDKを初期化する

Applicationクラスを作成または開き、初期化コードを追加します。Kotlinでは次のようになります。

class MyApplication : Application() {
    override fun onCreate() {
        super.onCreate()

        Zendesk.initialize(
            context = this,
            channelKey = "your_channel_key_here",
            successCallback = {
                // SDKが正常に初期化されました
                Log.d("Zendesk", "Messaging SDK initialized")
            },
            failureCallback = { error ->
                // 初期化の失敗を処理する
                Log.e("Zendesk", "Failed to initialize: ${error.message}")
            }
        )
    }
}

Javaでは次のようになります。

public class MyApplication extends Application {
    @Override
    public void onCreate() {
        super.onCreate();

        Zendesk.initialize(
            this,
            "your_channel_key_here",
            () -> Log.d("Zendesk", "Messaging SDK initialized"),
            error -> Log.e("Zendesk", "Failed to initialize: " + error.getMessage())
        );
    }
}

"your_channel_key_here"を、Zendesk管理センターからの実際のチャネルキーに置き換えてください。

ステップ4：メッセージングインターフェイスを表示する

いよいよ楽しい部分です。チャットインターフェイスを表示します。任意のアクティビティから、次の1行でメッセージングを起動できます。

Kotlin：

Zendesk.instance.messaging.showMessaging(context)

Java：

Zendesk.instance.messaging().showMessaging(context);

後で起動する必要がある場合、またはPendingIntentで使用する場合は、Intentを取得することもできます。

val messagingIntent = Zendesk.instance.messaging.getMessagingIntent(context)
startActivity(messagingIntent)

SDKは、会話履歴、エージェントの可用性、メッセージのスレッド化など、すべてを処理します。ユーザーは、UIコードを記述することなく、シームレスなチャットエクスペリエンスを得られます。

ステップ5：統合をテストする

本番環境に出荷する前に、すべてが機能することを確認します。

1. 基本的な機能：アプリを起動し、メッセージングを開きます。チャットインターフェイスが読み込まれるはずです。
2. メッセージフロー：テストメッセージを送信します。Zendesk Agent Workspaceに表示されるはずです。
3. エージェントの返信：Zendeskから返信します。メッセージがアプリに表示されるはずです。
4. プッシュ通知：Firebaseを構成した場合は、アプリがバックグラウンドにあるときに通知が届くことをテストします。

可能であれば、複数のAndroidバージョンでテストしてください。特に、古いデバイスをサポートしている場合はそうです。

ZendeskモバイルSDKのAndroid統合に関する一般的な問題と解決策

いくつかの統合を経験した後、最もよく発生する問題を以下に示します。

URL形式の混乱 Support SDKを構成する場合、開発者はサブドメインの代わりにメールアドレスを使用することがあります。正しい形式はyoursubdomain.zendesk.comであり、email@company.zendesk.comではありません。

初期化の順序 SDKは、メッセージングを表示しようとする前に初期化する必要があります。「SDKが初期化されていません」というエラーが表示される場合は、Activityではなく、ApplicationクラスのonCreate()でZendesk.initialize()を呼び出していることを確認してください。

Proguard/R8による縮小化 コードの縮小を使用している場合は、Zendeskクラスを保持するためにProguardルールを追加する必要がある場合があります。SDKドキュメントには、proguard-rules.proに追加する特定のルールがあります。

プッシュ通知の構成 プッシュ通知には、Firebase Cloud Messagingの設定が必要です。FCMの依存関係を追加し、サーバーキーをZendeskにアップロードしたことを確認してください。これは、スキップされることが多い一般的な手順です。

認証トークンのエラー JWTを使用している場合、トークンの有効期限切れが原因で不可解なエラーが発生する可能性があります。トークンの更新ロジックを実装し、バックエンドが有効なトークンを生成することを確認してください。

ZendeskモバイルSDKのAndroid統合のカスタマイズオプション

SDKには、アプリのルックアンドフィールに合わせるためのいくつかの方法が用意されています。

Support SDKの場合、次のことができます。

• マテリアルデザインのテーマ（ライト、ダーク、またはダークアクションバー付きライト）を適用する
• colorPrimary、colorPrimaryDark、およびcolorAccentを介して色をカスタマイズする
• ヘルプセンターの記事スタイリングのCSSをオーバーライドする
• デフォルトのアイコンを独自のドローアブルに置き換える

Messaging SDKは、設計上、カスタマイズオプションが少なくなっています。テーマを構成してブランドカラーに合わせることができますが、インターフェイスはより標準化されています。これは実際には利点です。構成するものが少なく、ユーザーは使い慣れたチャットエクスペリエンスを得られます。

アプリが複数の言語をサポートしている場合、ローカライズは自動的に処理されます。SDKはデバイスのロケールを検出し、翻訳された文字列を表示します（利用可能な場合）。

ZendeskモバイルSDKのAndroid統合のAI搭載の代替手段を検討する場合

考慮すべきことがあります。SDKの統合は、優れたモバイルサポートを提供するための唯一の方法ではありません。eesel AIでは、ニーズにより適した別のアプローチを採用しています。

アプリにSDKを埋め込む代わりに、当社のAIエージェントはヘルプデスクと直接統合されます。これは、次のことを意味します。

• モバイル開発は不要：サポートチームは、アプリストアの承認を待つことなくAIをデプロイできます
• すべてのチャネルで動作：メール、チャット、ソーシャル、およびチケットを同時に処理します
• 複数のソースから学習：過去のチケット、ヘルプセンター、Confluence、Googleドキュメントなどでトレーニングします
• ライブ前にテスト：過去の数千件のチケットでシミュレーションを実行して、パフォーマンスを測定します

当社のAIは、最前線のサポートを自律的に処理し、必要な場合にのみ人間をエスカレーションします。「請求に関する紛争は常に人間にエスカレーションする」または「VIP顧客の場合は、アカウントマネージャーをCCに追加する」など、エスカレーションルールをわかりやすい英語で定義します。

価格は、返信の作成に役立つAI CopilotとSlack統合を含むTeamプランで月額299ドルから始まります。月額639ドルのBusinessプランでは、自律的なサポートのための完全なAIエージェントが追加されます。

すでにZendeskを使用している場合は、ワンクリックで統合できます。SDK、アプリの更新、待機は不要です。

ZendeskモバイルSDKのAndroid統合で、今日からより優れたモバイルサポートを構築しましょう

これで、ZendeskをAndroidアプリに統合するために必要なものがすべて揃いました。重要なポイントをまとめましょう。

• 最新のチャットベースのサポートには、Messaging SDKを選択してください
• コーディングする前に、Zendesk管理センターからチャネルキーを取得していることを確認してください
• Activityではなく、ApplicationクラスでSDKを初期化してください
• 特にプッシュ通知を使用している場合は、徹底的にテストしてください

統合プロセスは通常、基本的な設定で数時間、または大幅にカスタマイズしてデバイス全体でテストする場合は1〜2日かかります。

SDKが提供する以上の自動化が必要な場合、または既存のサポート履歴から学習するAI搭載の応答が必要な場合は、eesel AIをお試しください。モバイル開発作業なしで、既存のZendesk設定を補完します。

どちらのアプローチを選択しても、ユーザーはアプリを離れることなくヘルプを得られることを高く評価するでしょう。結局のところ、それが目標です。

ZendeskモバイルSDKのAndroid統合に関するよくある質問

Q1：一般的なZendeskモバイルSDKのAndroid統合にはどのくらいの時間がかかりますか？ A1：基本的な統合には2〜4時間かかります。カスタマイズ、デバイス全体のテスト、プッシュ通知の設定により、1〜2日かかる場合があります。

Q2：ZendeskモバイルSDKのAndroid統合に必要な最小Androidバージョンは何ですか？ A2：Messaging SDKとSupport SDKの両方で、APIレベル21（Android 5.0）以上が必要です。これは、アクティブなAndroidデバイスの約95％をカバーしています。

Q3：ZendeskアカウントなしでZendeskモバイルSDKのAndroid統合を使用できますか？ A3：いいえ、アクティブなZendesk SupportまたはSuiteアカウントが必要です。プラットフォームを評価している場合は、無料トライアルから始めることができます。

Q4：ZendeskモバイルSDKのAndroid統合は、アプリのサイズにどのくらい追加されますか？ A4：Messaging SDKは、Proguard/R8による縮小化の前に、APKに約7.5 MBを追加します。実際のインパクトは、最適化後には通常小さくなります。

Q5：AndroidアプリでZendeskモバイルSDKの外観をカスタマイズできますか？ A5：Support SDKは、マテリアルデザインのテーマとCSSを通じて広範なカスタマイズを提供します。Messaging SDKのテーマオプションはより制限されていますが、一貫性のある最新のチャットインターフェイスを提供します。

Q6：ZendeskモバイルSDKのAndroid統合の初期化に失敗した場合はどうすればよいですか？ A6：正しいチャネルキーを使用していること、ActivityではなくApplicationクラスで初期化していること、およびデバイスがインターネットに接続されていることを確認してください。特定の内容については、失敗時のコールバックエラーメッセージを確認してください。