メモ:

1. この機能は現在、β版です。必要に応じて、ウィジェットをさらに洗練させるために、JS APIコード/フォーマットが変更されることがあります。
2. また、ウィジェットのJS APIは新規SalesIQ有効チャットでのみ機能します。古いバージョンを使用している場合は、新規有効チャットウィジェットを使用する必要があります。切り替えるには、更新された有効チャットウィジェットを取得するために、以下にてサポートに連絡してください：サポート@zohosalesiq.com

このガイドは、JS APIを使用してZoho SalesIQチャットウィンドウにパーソナライズされたウィジェットを統合する設定手順を説明しています。

パーソナライズされたウィジェットがあなたの企業にどのようなメリットをもたらすか？

1. 強化されたユーザーエンゲージメント: パーソナライズされたウィジェットにより、あなたのWebサイトの訪問者/ユーザーとのエンゲージメントを大幅に向上させることができます。訪問者は情報を受動的に消費するのではなく、動的なウィジェットと対話することで、経験をよりエンゲージングで直感的なものにすることができます。
2. すべてのページでの表示増加:ウィジェットはあなたのWebサイトのすべてのページに表示され、一貫した表示を保証します。これにより、サイト上の位置に関係なく、訪問者に対して重要なメッセージやオファーを効果的に伝えることができます。
3. インタラクティブな情報提供: 訪問者は視覚的に魅力的で対話的な形式で提供されるコンテンツにより高い確率でエンゲージすることができます。インタラクティブなウィジェットを使用することで、伝統的なWebサイトテキストよりも効果的に重要な情報を伝えることができます。
4. 商品への簡単なアクセス: 訪問者はウィジェットをクリックするだけであなたの商品やサービス、お知らせに簡単にアクセスすることができます。このシームレスなアクセスは探求心を刺激し、コンバージョンの増加につながる可能性があります。
5. 柔軟なお知らせ設定: SalesIQでは、チャットウィンドウ用の3種類のカスタムウィジェット（アナウンスメント、情報、リストメッセージ）をサポートしています。これにより、あなたは、訪問者との情報共有をパーソナライズし、カスタマイズすることができます。内容をあなたの企業のニーズと訪問者の関心に合わせて調整できます。

ウィジェット	説明	機能性	出力
アナウンスメント	このウィジェットは、今後のイベント、特別な提供、商談、その他を強調するために使用中することができます。このウィジェットには、ユーザーのエンゲージメントを促進するためのクリアな通話-to-操作ボタン（CTA）が含められます。	メディア（ビデオまたは画像）のオプション付きバナー 件名 本文テキスト 記事または選択したURLにリンクする通話 to 操作
情報	このウィジェットは、興奮したアップデートやニュースを共有することが出来ますが、通話から操作へのボタン（CTA）はありません。	メディア（ビデオまたは画像）のオプション付きバナー 件名 本文のテキスト
リスト	このウィジェットは、チャット/通話の開始、URLの開覧、カスタム処理の起動など、複数の処理をラベルで表現できます。さまざまなサービスやオファリングを提示し、ユーザーがウィジェットから直接予約や記事へのアクセスなど、複数の処理を行うことができます。	件名 手順 チャットを開始する 通話を開始する URLを開く カスタムクライアント操作を起動する

SalesIQチャットウィンドウにカスタムウィジェットを追加する

アナウンスメッセージ

1. アナウンスメッセージのための構文コードは以下の通りです。
   

構文:

1. {
2. '種類': 'announcement',
3. 'data': {
4. 'banner': {
5. 'video_url': 'URL_TO_VIDEO',
6. 'image_url': 'URL_TO_IMAGE'
7. },
8. '件名': 'STRING',
9. '本文': {
10. 'text': 'STRING'
11. },
12. '操作': {
13. 'invoke': 'STRING',
14. 'article_id': 'STRING',
15. 'url': 'URL',
16. 'text': 'STRING'
17. }
18. }
19. }

1. 上記の構文コードを必要に応じて変更し、インストールコードのready関数内に貼り付けてください。

コード構造を含むアナウンスメッセージの例

以下にサンプルコードを提供します。ご参照ください。

1. //SalesIQダッシュボードから、設定 > ブランド > ブランドを選択 > インストール > Webサイト > コードをコピー ここにペースト中でこのサンプルコードが動作します。
   
2. 
   

出力

情報メッセージ

1. Information messageの構文コードは次の通りです。
   

1. 上記の構文を必要に応じて修正し、それをインストールコードのready関数内に貼り付けます。

コード構造を用いたinfoメッセージの例

出力

コード構造を持つリストメッセージの例

出力

記憶すべきポイント:

1. Invoke 処理: Invoke 項目は、メッセージまたはリスト商品が引き金にする操作の種類を決定します。可能な値には以下のものが含まれます:
1. 開始する。chat: チャットセッションを開始します。
2. 開始する。通話: 通話を開始します。
3. 開く。url: 操作オブジェクト内で提供されたurlキーに基づいてブラウザでURLを開きます。
4. 開く。article: 操作オブジェクト内のarticle idに基づいて特定の記事を開きます。
5. カスタム。操作: 操作オブジェクト内のclientaction_nameキーに基づいてカスタムのクライアントサイドの操作をトリガーします。 クライアント操作 JS API ドキュメントを参照してください。
2. オプション項目: video_url、image_url、article_id、clientaction_name、およびurlなどの項目は、必要な場合にのみ含めるべきです。実行する必要がある操作により、キーを定義します。例えば、操作がチャットの開始である場合、article idを提供しても効果はありません。
3. Client 処理: リスト商品の操作がWebサイト上でカスタム動作を必要とする場合、clientaction_name項目でクライアントが処理できるカスタム処理を指定できます。