メインコンテンツにスキップ

モバイルアプリ内でHelp Centerを開く

iOSおよびAndroidアプリにHelp Centerを統合する方法。

対応者:Beth-Ann Sher

Help Centerをモバイルアプリに直接組み込み、Intercom Articlesを活用して、ユーザーに柔軟なヘルプコンテンツの提供方法を多数用意しましょう。適切な情報を適切な人に適切なタイミングで届けます。👌

完全に統合されたセルフサービス体験を実現するには、各アプリのバージョンに対してIntercomの最新モバイルSDKをインストールする必要があります。

有効にすると、usersはアプリに最適な方法で表示される正確なヘルプコンテンツにアクセスできます。

  • SDKの「Presentation」メソッドを使うと、記事をインラインで起動したり、特定の記事やコレクションをアプリの異なる部分で紹介したりできます。

  • Dataメソッドを使うと、独自のネイティブUIに記事やコレクションを組み込むことができます。

プロのヒント:これらの方法のいずれで記事やコレクションを表示しても、usersはアプリ内に留まりシームレスな体験が可能です。これは、アウトバウンドメッセージのリンクやサポート会話でチームが送信したリンクも含みます。リンク付きマクロの作成は、usersを適切な方向に導く優れた方法です。👌

これらの方法の仕組みについて詳しく知るか、開発者向けドキュメントでの使用手順をこちらでご覧ください:iOSAndroidCordova & Phonegap、またはReact Native


プレゼンテーションメソッド

プレゼンテーションメソッドを呼び出すと、IntercomのデフォルトUIを使った新しいウィンドウが表示されます(ワークスペースのMessengerカラー設定を使用)。異なるメソッドで以下を表示できます:

  • Help Center全体。

  • 特定のコレクション内のすべての記事。

  • フィルタリングされたコレクションのセット。

  • 特定の記事。

ヒント:Help Center全体を表示し、コレクションが1つだけの場合、usersはそのコレクション内の記事とセクションを表示します。


Dataメソッド

Dataメソッドを呼び出すと、Help Centerとその記事の生データモデルが提供されます。アプリ内でこのデータをどのように表示するかは自由に選べます。利用可能なメソッドで以下を取得できます:

  • コレクションのリスト。

  • コレクション内のセクションと記事。

  • 提供した検索語に一致するHelp Center内の記事リスト。

注意:個別の記事のUIは常にデフォルトのIntercom UIでレンダリングされます。記事表示メソッドを使い、article_idを渡す必要があります。


よくある質問

Help CenterのダークモードはモバイルSDKでサポートされていますか?

Help Centerのダークモードは現在モバイルSDKではサポートされていません。

モバイルSDKで多言語記事はサポートされていますか?

はい。コンテンツはデバイスの言語設定、または言語オーバーライドを使用している場合はその設定に基づいて表示されます。モバイルusersは自分で言語を選択できません。

モバイルSDKのHelp CenterはWCAG準拠ですか?

モバイルSDKのHelp Centerでは特定のアクセシビリティ機能がサポートされていますが、現時点ではWCAG 2.1の基準を満たしていません。この分野の改善計画がありますので、ご期待ください。😉


トラブルシューティング

エラー:Intercomが正しく初期化されていません。

Intercomを初期化する前にアプリでHelp Centerを表示しようとすると、次のエラーが記録されます:

エラー:Intercomが正しく初期化されていません。最初に呼び出すIntercomメソッドはinitialize()であり、正しいapp IDとAPIキーを渡していることを確認してください。

こちらの回答で解決しましたか?