Messengerは、モバイルで最高の体験を提供するために最新のモバイルSDKが必要です。この記事では、モバイル用Messengerのカスタマイズ方法とiOSおよびAndroidアプリでサポートされている機能について説明します。
注意：最新のMobile Messengerを使用するには、最新のモバイルSDKが必要です。インストールの詳細はDeveloper Docsでご確認ください。
モバイルMessengerが設定 > チャンネル > Messenger > インストールから有効になっていることを確認してください。無効の場合、すべてのIntercomへのリクエストが失敗し、loginUnidentifiedUserまたはloginUserメソッドに関連するエラーが返される可能性があります。
モバイル用Messengerのカスタマイズ
設定 > チャンネル > Messenger > Mobile SDKsからモバイル用Messengerをカスタマイズおよびプレビューでき、iOSまたはAndroidのデバイスプレビューを選択できます。
モバイルアプリで利用可能
usersがiOSまたはAndroidアプリでMessengerにアクセスすると、ネイティブのボトムシートとして起動します。これにより、Messengerが自然に埋め込まれているように見え、シームレスで一貫した顧客体験を提供します。usersはアプリ内の現在位置を正確に把握し、Messengerでのやり取り方法を選択できます。
Messengerスタイルの設定
モバイルMessengerスタイルはマルチブランドHelp Centerもサポートしているため、このMessengerスタイルで使用するブランドに正しいHelp Centerが接続されていることを確認してください。
各Messengerスタイルをビジネスニーズに合わせてデザインしてください。ロゴやヘッダーの背景色または画像でスタイルを設定します。
直接Conversationを起動
次に、Messenger > Mobile SDKs > Contentで「Launch directly into a Conversation」を有効にして、Messengerを直接Messagesスペースで起動（新しい会話を開始または過去のメッセージを表示）するかどうかを決めてください。
この新しい設定により、usersはサポートへのアクセスが速くなり、チームとの新しいチャット開始の手順が減ります。
Messengerスペースの設定
現在、Messenger > Mobile SDKs > Content > SpacesでTicketsおよび/またはHelpスペースを追加・削除して、usersがHomeスペースで操作できるボタンを設定できます。（Messagesは無効にできません）
usersはHomeおよびMessagesスペースから、オーディエンスルールに合致すれば会話を開始できます。
usersはticketsを提出し、専用のTicketsスペースで進捗を追跡できます（有効にしている場合）。
ウェルカムメッセージの設定
MessengerのHomeスペースでusersをどのように迎えるかをウェルカムメッセージで決めてください。ウェルカムメッセージは対応言語すべてで設定可能です。
アプリでHomeをカスタマイズ
Messenger > Mobile SDKs > Content > Customize home with appsから、Send us a messageやSearch for helpなど、ワークスペースにインストールした他のアプリをHomeスペースに追加できます。
ウェブとモバイルSDKの違い
スペース
Web - スペースはMessengerの下部にタブとして表示されます。このタブバーは各スペースの最上位レベルで常に表示されます。
Mobile SDKs - スペースはHomeスペースの上部にボタンとしてのみ表示され、他のスペースには表示されません。
ナビゲーション
Web - usersがスペース内のコンテンツ（記事、会話、ticketなど）に移動するとタブバーは消え、Messengerの上部に「戻る」ボタンが表示されます。
Mobile SDKs - usersはどのスペースからでも「戻る」ボタン（Androidではシステムの「戻る」ボタン）でHomeスペースに戻れます。
通知
Web - スペースタブは新しいコンテンツ（会話の新しいメッセージなど）があると通知バッジを表示します。
Mobile SDKs - スペースボタンは新しいコンテンツ（会話の新しいメッセージやticketのステータス更新など）があると通知バッジを表示します。
モバイルSDKのMessages
MessagesスペースのヘッダーにはiOSで新しい会話を開始するボタンがあります。Androidでは代わりにフローティングアクションボタンがあります。
Android SDK
これは大きなアップデートのため、以下のようにいくつかのAPI変更があります。
メソッド - Kotlin | 説明 |
fun present(space: IntercomSpace) | Intercomの特定のスペースを開きます。（Home、Messages、Help Center）。デフォルトはHomeスペース。戻り値はvoidで、コールバックは受け付けません。 |
fun present() | Intercomを開きます - デフォルトはHomeスペース。戻り値はvoidで、コールバックは受け付けません。 |
fun presentContent(content: IntercomContent) | Intercomコンテンツを表示します。有効なコンテンツタイプはArticle、Carousel、Help Center Collectionsです。 |
注意：この表のメソッドはすべてコールバックやリスナーのパラメータを受け付けません。present()、present(space)、presentContent(content)はすべてvoidを返します。present()が成功するかどうかに影響する唯一のポイントは、loginIdentifiedUserのonSuccessが発火した後に呼び出すことです。
重要：loginIdentifiedUser（またはloginUnidentifiedUser）のonSuccessコールバックが発火した後にのみ、present()またはpresent(space: IntercomSpace)を呼び出してください。ログイン開始直後に呼び出すと、SDKがまだ準備できていないため「Something went wrong」というエラーで静かに失敗します。
これらのメソッドは引き続き使用可能ですが、将来のリリースで削除される予定です。
メソッド - 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設定が尊重されます。 |