このユースケースでは、モバイルアプリケーションにログインしているユーザーを支援するために必要な構成とAPIの使用例の手順について説明します。
詳細なAPIについては、AndroidおよびiOS APIドキュメントをご覧くださいませ。
このガイドでは、Androidのコードを使用した手順について説明しますが、一般的な手順はiOSアプリケーションにも同じように適用できます。
1.プラグインを有効にして構成する
Webアプリケーションを開き、「CoBrowsing / Analytics」プラグインを作成します。ユーザーがヘルプを必要とするときにのみ画面送信を開始するには、オプトインタイプを構成します。このユースケースでは、「サポートエージェント」を選択することをお勧めします。画面送信を開始する前にユーザーに許可を求めるには、「共同閲覧」タブに変更し、「共同閲覧を有効にする」と「共同閲覧開始時に追加のオプションポップアップ」を有効にします。
2.SDKの統合
モバイルSDKはアプリケーションパッケージに統合する必要があります。
3.LiveViewの起動
ユーザーがアプリケーションを起動したら、SDKのLiveViewモジュールを起動する必要があります。これにより、Chatvisor Webサービスにセッションが登録されますが、前の手順でオプトインを有効にした場合、画面送信は開始されません。
たとえば、アプリケーションクラスのonCreateメソッドで、API設定ページにあるモバイルクレデンシャルを使用してstartメソッドを呼び出します: https://app.chatvisor.com/#/components/tenant/settings/api
Chatvisor.liveView.start("<your user id>", "<your token>");
以上で、LiveViewセッションリストにセッションが表示されます。
4.認証されたユーザーにタグを付ける
ユーザーがアプリケーションのユーザーアカウントにログインしたら、ユーザーに関する情報でセッションにタグを付けします。 idフィールドには必ずユーザー名または任意の一意の値を使用してください。これにより、すべてのセッションが関連付けられた新しいユーザーがバックエンドに作成されます。
List<String> labels = new ArrayList<String>();
labels.put("foo")
Chatvisor.user.tag(
new ActiveUser()
.widthId("john.doe")
.withEmail("john.doe@example.com")
.withFirstname("John")
.withLastname("Doe")
.withLabels(labels)
);
セッションリストは次のようになります。セッションに追加されたタグをご覧ください。
5.ユーザーがログアウトしたらタグを削除する
ユーザーがアプリケーションからログアウトした場合は、clearメソッドを呼び出して、セッションに関連付けられているタグを削除します。
Chatvisor.user.clear()
6.サポートユーザー
ユーザーがあなたに電話連絡したと想定します。セッションのリストを開いて、ユーザー名john.doeを探すことができます。セッションをクリックすると、ユーザーにリクエストを受け入れるように求めるボタンが表示されます。ユーザーがリクエストを受け入れると、モバイルデバイスの画面が表示されます。