Messengerは、モバイルで最高の体験を提供するために最新のモバイルSDKが必要です。この記事では、モバイル用Messengerのカスタマイズ方法とiOSおよびAndroidアプリでサポートされている機能を説明します。
注意：最新のMobile Messengerを使用するには、最新のモバイルSDKを使用している必要があります。インストールの詳細はDeveloper Docsでご確認ください。
モバイルMessengerがIntercom設定パネル内で有効になっていることを確認してください。無効の場合、すべてのIntercomへのリクエストが失敗し、loginUnidentifiedUserまたはloginUserメソッドに関連するエラーが返される可能性があります。
モバイル用Messengerのカスタマイズ
設定 > チャンネル > Messenger > Mobile SDKsからモバイルでMessengerをカスタマイズおよびプレビューでき、iOSまたはAndroidのデバイスプレビューを選択します。
モバイルアプリで利用可能
usersがiOSまたはAndroidアプリでMessengerにアクセスすると、ネイティブのボトムシートとして起動します。これにより、Messengerは自然に埋め込まれたように見え、シームレスで一貫した顧客体験を提供します。ユーザーはアプリ内の現在地を正確に把握し、Messengerでのやり取り方法を選択できます。
Messengerスタイルの設定
Mobile MessengerスタイルはマルチブランドHelp Centerもサポートしているため、このMessengerスタイルで使用するブランドに正しいHelp Centerが接続されていることを確認してください。
各Messengerスタイルをビジネスニーズに合わせてデザインしてください。ロゴやヘッダーの背景色または画像でスタイルを設定します。
直接会話を開始する
次に、Messenger > Mobile SDKs > Contentで「直接会話を開始する」を有効にして、Messengerがメッセージスペースに直接起動するかどうかを決定します（顧客が新しい会話を開始したり、以前のメッセージを表示したりできます）。
この新しい設定により、顧客はサポートへのアクセスが速くなり、チームとの新しいチャット開始の手順が減ります。
Messengerスペースの設定
Messenger > Mobile SDKs > Content > Spacesで、顧客がホームスペースで操作できるボタンをTicketsおよび/またはHelpスペースの追加・削除で設定します。（Messagesは無効にできません）。
顧客はホームおよびMessagesスペースから、オーディエンスルールに合致すれば会話を開始できます。
顧客はticketsを提出し、専用のTicketsスペースで進捗を追跡できます（有効にしている場合）。
ウェルカムメッセージの設定
Messengerホームスペースで顧客をどのように迎えるかを決め、ウェルカムメッセージを設定します。ウェルカムメッセージは対応言語すべてに設定可能です。
アプリでホームをカスタマイズ
Messenger > Mobile SDKs > Content > Customize home with appsから、Send us a messageやSearch for helpなど、ワークスペースにインストールした他のアプリをホームスペースに追加できます。
ウェブとモバイルSDKの違い
スペース
Web - スペースはMessengerの下部にタブとして表示されます。このタブバーのナビゲーションは各スペースの最上位レベルから常に表示されます。
Mobile SDKs - スペースはホームスペースの上部にボタンとしてのみ表示されます。他のスペースには表示されません。
ナビゲーション
Web - 顧客がスペース内のコンテンツ（記事、会話、ticketなど）に移動するとタブバーは消え、Messengerの上部に「戻る」ボタンが表示されます。
Mobile SDKs - 顧客はどのスペースからでも「戻る」ボタン（Androidのシステム「戻る」ボタンも含む）を使ってホームスペースに戻れます。
通知
Web - スペースタブは新しいコンテンツ（例：会話の新しいメッセージ）があると通知バッジを表示します。
Mobile SDKs - スペースボタンは新しいコンテンツ（例：会話の新しいメッセージやticketのステータス更新）があると通知バッジを表示します。
モバイルSDKのメッセージ
MessagesスペースのヘッダーにはiOSで新しい会話を開始するボタンがあります。Androidでは代わりにフローティングアクションボタンがあります。
Android SDK
これは大きなアップデートのため、以下のようにいくつかのAPI変更があります。
メソッド - Kotlin | 説明 |
fun present(space: IntercomSpace) | Intercomの特定のスペースを開きます。（Home、Messages、Help Center）。デフォルトはHomeスペースです。 |
fun present() | Intercomを開きます - デフォルトはHomeスペースです。 |
fun presentContent(content: IntercomContent) | Intercomコンテンツを表示します。有効なコンテンツタイプはArticle、Carousel、Help Center Collectionsです。 |
これらのメソッドは引き続き使用できますが、将来のリリースで削除される予定です。
メソッド - Kotlin |
fun displayMessenger() |
fun displayHelpCenter() |
fun displayHelpCenterCollections(collectionIds: List<String>) |
fun displayArticle(articleId: String) |
fun displayCarousel(carouselId: String) |
fun displaySurvey(surveyId: String) |
iOS SDK
これは大きなアップデートのため、以下のようにいくつかのAPI変更があります。
メソッド - Swift | メソッド - Obj-C | 説明 |
func present(_ space:Space) | + (void)presentIntercom:(Space)space | Intercomの特定のスペースを開きます。（Home、Messages、Help Center）。 |
func present() | + (void)presentIntercom | Intercomを開きます - デフォルトはHomeスペースです。 |
func presentContent(_ content: Content) | + (void)presentContent:(IntercomContent *)content | Intercomコンテンツを表示します。有効なコンテンツタイプはArticle、Carousel、Help Center Collectionsです。 |
以下のメソッドは完全に非推奨となりました。
メソッド - Swift | メソッド - Obj-C |
func presentMessenger() | + (void)presentMessenger |
func presentHelpCenter() | + (void)presentHelpCenter |
func presentHelpCenterCollections(_ collectionIds: [String]) | + (void)presentHelpCenterCollections:(nonnull NSArray<NSString *> *)collectionIds |
func presentArticle(_ articleId: String) | + (void)presentArticle:(nonnull NSString *)articleId |
func presentCarousel(_ carouselId: String) | + (void)presentCarousel:(nonnull NSString *)carouselId |
func presentSurvey(_ surveyId: String) | + (void)presentSurvey:(nonnull NSString *)surveyId |
モバイルSDKの後方互換性と前方互換性
ワークスペースとモバイルSDKが同期していない場合があります。例えば、新しいMessengerが設定で有効になっていても、アプリのモバイルSDKがまだアップグレードされていない場合です。動作は以下の通りです。
| 以前のMessenger設定 （未オプトイン） | 新しいMessenger設定 （オプトイン済み） |
以前のMessengerモバイルSDK （v14.0.1未満） | これまで通り動作します。以前のMessenger設定はすべて尊重されます。 | 新しいMessenger設定は適切に適用され、モバイルアプリで以前のMessenger体験を再現します。
以前のMessengerモバイルSDKでは一部の新機能が動作しません：
|
新しいMessengerモバイルSDK （v14.0.1以上） | 新しいMessenger設定は適切に適用され、モバイルアプリで新しいMessenger体験を再現します。
例えば：
| すべての新しいMessenger設定が尊重されます。 |