メモ:

1. この機能は現在、ベータ版として利用可能です。必要に応じて、ウィジェットをさらに洗練させるためのJS API コード/フォーマットを修正することがあります。
2. さらに、ウィジェットのJS APIは新しいSalesIQ 有効チャットでのみ機能します。もし古いバージョンを使用している場合は、新規 有効チャットウィジェットへの移行が必須となります。移行するには、以下のメールアドレス[support@zohosalesiq.com]にてサポート窓口にご連絡ください。
   

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

パーソナライズされたウィジェットは何の利点があるでしょうか？

1. ユーザーエンゲージメントの強化: パーソナライズされたウィジェットは、訪問者/ユーザーのウェブサイトでのエンゲージメントを大幅に強化することができます。訪問者は静的に情報を受け取るのではなく、動的なウィジェットと対話することで、体験がより巻き込まれやすく、直感的になります。
   
2. 全ページでの表示頻度の増加: ウィジェットはウェブサイトの全ページで表示されるため、一貫した表示頻度が確保されます。これにより、サイト上のどの場所にいても、訪問者に対してキーメッセージやオファーを効果的に伝えることが可能です。
   
3. インタラクティブな情報提供: 訪問者は視覚的に魅力的で、対話型の方法で提供されるコンテンツにより、エンゲージする可能性が高まります。対話型のウィジェットを利用することで、伝統的なウェブサイトテキストよりも効果的に重要な情報を伝えることが可能です。
   
4. 提供物への簡単なアクセス: 訪問者は、ウィジェットをクリックするだけであなたの製品、サービス、お知らせに簡単にアクセスできます。このシームレスなアクセスは、探索を促し、コンバージョンの増加につながる可能性があります。
   
5. フレキシブルなお知らせの設定: SalesIQは、あなたのチャットウィンドウのための3つの異なるカスタムウィジェット（お知らせ、情報、リストメッセージ）をサポートしており、視聴者との情報共有の方法を個別化し、カスタマイズすることが可能です。コンテンツをあなたのビジネスニーズと訪問者の興味に合わせて調整することができます。

ウィジェット	説明	機能	出力
アナウンスメント	このウィジェットは、今後のイベント、特別なオファー、商談、その他を強調するために使用中することができます。このウィジェットには、ユーザーのエンゲージメントを引き付けるクリアな通話-to-操作ボタン（CTA）が含めます。	バナー（ビデオまたは画像をオプションで追加可能） 件名 本文テキスト 記事或いは選択したURLへリンクする通話 to 操作
情報	このウィジェットでは、興奮する更新やニュースを共有することができますが、通話-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 ダッシュボードへ移動し、その後こちらのサンプルコードを機能させるためにコードをコピー&ペーストしてください。
   
2. 
   

出力

情報メッセージ

1. 情報メッセージの構文は以下に示されています。
   

1. 上記の構文を自分のニーズに合わせて調整し、それをインストールコードのready関数内に貼り付けます。

コード構造付きのinfoメッセージの例

出力

List メッセージ

1. list メッセージ の構文は以下の通りです。
   

1. 上記の構文を自分のニーズに合わせて調整し、それをインストールコードのready関数内に貼り付けます。
   

list メッセージ の例とそのコード構造

参考のためにサンプルコードを以下に提供します。

1. //SalesIQ ダッシュボードから、設定 > ブランド > ブランドを選択 > インストール > ウェブサイト > コードをコピーし、それをここに貼り付けます。これにより、この例のコードが機能します。
3. 
   

出力

考慮すべき点:

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. クライアント処理: リスト商品操作がWebサイト上でカスタム動作を必要とする場合、clientaction_name項目でクライアントが処理可能なカスタム処理を指定できます。