トラブルシューティング
Apple プッシュ通知サービス (APNs) の通知がモバイル端末に届きません。
クライアントWebサーバーを実行中のホスト上のJava JDKのバージョンを確認してください。バージョンは8u252以降である必要があります。APNsが基盤としているHTTP/2をサポートするには、このバージョンのJavaが必須です。
Mobile/Web Messaging API v2 で、Get Case History または Close Case メソッドをコールした際にエラー 406 が返されます。
チャットセッションを処理するシナリオでは、API がアクセスできる CRM ケースを指定する必要があります。これは、 Set Case シナリオブロックと 「チャット API 経由でのケース履歴へのアクセスを許可」 チェックボックスをオンにするか、またはシナリオ変数 $(item.allowChatHistoryForCase) をCRMケースオブジェクトのidに設定することで、ケースシナリオブロックを設定します。
私のモバイルアプリケーションでは、同じチャットメッセージが複数回受信されます。
モバイルアプリケーションが同じチャットメッセージを複数回受信するのは、アプリがチャットセッションのサーバーイベントを取得する方法が2つあるためです：
- 現在のチャットセッションにおける新規イベントの背景ポーリングが行われます。これは、iOS および/または Android のライブラリによって自動的に実行されます。ライブラリは、これらの新規イベントを、iOS では ContactCenterEventsDelegating.chatSessionEvents デリゲートとして、Android では ContactCenterEventsInterface.chatSessionEvents コールバックとして配信します。
- チャットセッションのイベントを取得するもう1つの方法は、 Get Chat History リクエストを使用することです。このリクエストは、コールバックやデリゲートを経由してすでに配信されたイベントを含め、現在のセッションに関するすべてのイベントを返します。これらのイベントの表示を調整し、同じイベントが2回表示されないようにするのは、アプリケーション側の責任となります。
私のデバイスのシステム通知センターに表示されるプッシュ通知のタイトルが、「keyChatNewMessageTitle, keyChatInactivityTimeoutTitle」となっています。なぜでしょうか？
プッシュ通知のタイトルとサブタイトルは、ローカライズ可能な文字列です。サーバーは、Appleのドキュメントに従って、iOSのクライアント側ローカライゼーション方式を使用しています。 Appleのドキュメントに従って、iOSのクライアントサイドローカライゼーションを採用しています。Androidのクライアントサイドローカライゼーションについては、 Firebaseのドキュメントに従っています。
iOSモバイルアプリケーションでは、各対応言語の文字列を指定するために `Localizable.strings` を使用する必要があります。Androidアプリケーションでは、文字列リソースを使用してください。サーバーは、iOSの通知に対して以下の文字列キーを使用します：
- keyChatNewMessageTitle: これは、新規メッセージ通知のタイトル文字列のキーです。引数はありません。典型的な値としては、iOSの場合は「新規メッセージがあります」、Androidの場合は「%1$s から新規メッセージがあります」などがあります。 Android（のみ）を使用する場合、新規メッセージ通知では単一のタイトル引数（送信者の名前）が送信されます（例：タイトル引数が ["John Doe"] の場合、Android 通知には「John Doe から新規メッセージがあります」と表示されます）。
- keyChatNewMessageSubtitle: これは、新規メッセージ通知のサブタイトル文字列のキーです。iOSでのみ存在します。 代表的な値として、「From %@」が挙げられます。新規メッセージ通知では、送信者の名前という単一のサブタイトル引数が送信されます（例：サブタイトル引数が ["John Doe"] の場合、通知には「From John Doe」と表示されます）。
- keyChatTimeoutWarningTitle: これは、タイムアウト警告通知のタイトル文字列のキーです。一般的な値は、「セッションがまもなくタイムアウトします。」です。
- keyChatInactivityTimeoutTitle: これは、非アクティブタイムアウト通知のタイトル文字列のキーです。代表的な値は、「まだおられますか？」です。
なお、Android の場合、通知にはタイトルのみが表示され（サブタイトルはありません）、メッセージの送信者名はタイトル文字列に含まれます。