■WhatYa仕様書
- 空色 小鮒 俊太朗
- 尾関沙紀
- 清水勇輔 (Unlicensed)
WhatYaの基本的な仕様をこのページにまとめています。
- 1 概要
- 1.1 本記事の内容
- 1.2 概要
- 1.2.1 WhatYaとは？
- 1.2.2 自動応答と有人応答について
- 2 前提条件
- 2.1 対応ブラウザ
- 2.2 導入可能な環境
- 2.3 準備するもの
- 2.4 変更可能なUI
- 2.5 接客管理画面（OKSKY）との連携
- 3 機能
- 3.1 自動投稿文
- 3.2 メッセージタイプ
- 3.3 SNS
- 3.4 その他機能
- 3.4.1 API
- 3.4.2 特殊パラメーター
- 3.4.3 ID連携（データ連携）
- 3.4.4 FlightBoard
- 3.4.5 チャット非表示機能
- 3.4.6 WhatYaクライアントAPI
- 3.4.7 バッジ機能
- 4 導入
- 5 よくある質問
概要
この資料について |
|---|
こちらの記事は、WhatYaでどのような事ができるか？どう利用するか？を |
本記事の内容
項目 | 内容 |
概要 | この資料とWhatYaの概要についての情報 |
前提条件 | WhatYaを導入する為に必要な前提条件 |
機能 | チャットボットの会話タイプや |
導入 | タグ埋め込み/CSSなど、WhatYaを導入する際に必要な作業 |
よくある質問 | 不明点を解消する為のヒント |
概要
項目 | 詳細 |
|---|---|
WhatYaとは？ | WhatYaとは「愉快性・役に立つ」というモットーから作られた ボットが文字だけで回答するだけではなく、多くのお客様が、 ・多彩なメッセージタイプでの表現 ・リストやチップボタンを利用した適切な回答への誘導 ・有人とチャットボットを利用したハイブリットな接客の実現 ・チャットに特化した傾向分析・CV計測 ・レコメンドの様な表示の商品紹介機能 ※AIエンジンにはWatsonを利用しています。 |
自動応答と有人応答について | WhatYaは、AIチャットボットによる自動応対だけではなく、 この連携により、自動応答と有人応答による、 |
※自動応答/有人応答の切り替えイメージ 
| |
前提条件
前提条件について |
|---|
WhatYaを導入する為に必要な前提条件となります。 |
必要要件 | 詳細 |
|---|---|
対応ブラウザ | 対応ブラウザは以下となります。 ・Google Chrome (PC & mobile) Internet Explorerには対応していません。 |
導入可能な環境 | ①以下JavaScript形式の、タグが埋め込める環境をご用意下さい。 <script src="https://whatya.solairo-api.com/xxxx/chat.js"></script>
②チャットボタン、チャットウインドウのデザインは、 ・WebサイトのCSSで編集 どちらかのパターンにて、CSSを記載していただく事で ③空色側のホワイトリストにドメイン許可がされていないと、 ドメイン(FQDN）の許可を行う場合は、 ※ステージング環境をご利用の場合は 上記項目の詳細はこちらのガイドをご確認下さい。 |
※タグを埋め込むと、Webサイトの右下にチャットアイコンが表示されます  | |
準備するもの
| 準備に必要なもの ※以下資料のp.5〜7を参照下さい。 |
変更可能なUI
| 空色担当から依頼をいただければ以下のUIを変更できます。 |
接客管理画面（OKSKY）との連携 | WhatYaで使えるOKSKYの機能については、こちらをご確認下さい |
機能
機能について |
|---|
チャットボットの会話タイプやダッシュボード機能・ID連携・SNSとの連携機能について |
自動投稿文
自動投稿文の種類 | 詳細 |
|---|---|
init_botチャットボットを | init_botは、チャットボタンをクリックして、 ※このinit_botは「list」で作成しています。
|
init_opオペレーターに接続した | init_opは、有人接客に切り替えた時、表示される自動投稿文です。 ※このinit_opは「text」で作成しています。
|
ボタン設定 | WhatYa管理画面からボタンを設定する際に、
|
メッセージタイプ
メッセージタイプ | 詳細 | WhatYa管理画面 |
|---|---|---|
テキスト | テキストのみの表示 ※テキストの改行：〇 | ○ |
画像 | テキスト＋画像の表示 ※テキストの改行：〇 | ○ |
リスト | 選択式のリストの表示 ※テキストの改行：〇 | ○ |
チップ（値なし） | 選択式のボタンの表示 ※テキストの改行：〇 | ○ |
チップ（値付き） | 選択式のボタンの表示 ※テキストの改行：〇 | ○ |
リンクイメージスライダー | リンク付きの複数画像をスライド式で表示 ※テキストの改行：〇 | ○ |
アイテムイメージスライダー | 複数の画像をスライド式で表示 ※テキストの改行：〇 | ○ |
テレフォン | 電話番号のリンクの表示 ※テキストの改行：× | × |
メール | メールアドレスのリンクの表示 ※テキストの改行：× | × |
イメージカード | テキスト＋リンク付きの画像の表示 ※テキストの改行：× | ○ |
オペレータ接続 | ※テキスト記入不可 | ○ |
YouTube | 動画（YouTube）のストリーミング再生 ※テキストの改行：〇 | ○ |
スペシャルタグ | https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/2521563137 | ○ |
アタッチメント | スペシャルタグ同様の画面表示ですが、Webサイトの商品を連携し、 | ○ |
マークダウン | ハイパーリンクの表示 | ○ |
|
|
|
|
|
|
SNS
SNS | 詳細 |
|---|---|
LINE | WhatYaとLINEを連携し、LINE上でチャットのやりとりができます。 対応メッセージタイプ： 設定方法： |
Facebook | WhatYaとFacebook Messengerを連携し、Facebook Messenger上でチャットのやりとりができます。 対応メッセージタイプ： 設定方法： |
その他機能
関連機能 | 詳細 |
|---|---|
API | WhatYaは公開したAPIをご用意しております。 ※APIのみを利用して、WhatYaの機能(オペレーターと接続・会話）を利用する場合、会話を処理する別サーバー(UIや、メッセージ変換など)を必要とします。 この場合、通常の通信方式(WebSocket)とは異なり、Webhookを利用した連携接続となります。※詳細は別途ご相談ください。 |
特殊パラメーター | wy_opn=true上記パラメータ付きのURLにアクセスした際、自動的にWhatYaのウィンドウを開きます。 wy_init_msg=任意のメッセージ上記パラメータ付きのURLにアクセスした際、パラメーターの値（上記の例であれば「任意のメッセージ」）をWhatYaに送信します。 wy_event=任意の値上記パラメーター付きのURLにアクセスした際、パラメータの値のチャットボット設定を参照します。（内部設定（answers）を参照します。） すべてのパラメーターは?や&をつけてご使用ください。 |
ID連携（データ連携） | WhatYaは、Webサイトと簡易的にデータ連携する機能をご用意しております。 大きく分けて以下2つの事が出来るようになります。 ・デバイスやブラウザが変わっても同じルームで会話が出来る ※詳細設定については、別途ご相談ください。 |
FlightBoard | FlightBoardは2021年12月29日現在 チャットボタン利用統計のグラフや指標をご確認いただけます。
※詳細はこちらをご覧ください |
チャット非表示機能 | data-no-chat=”true” 属性を埋め込みタグに指定していただくことで、チャットボタンは非表示となります。 非表示タグが埋め込まれていれば、WhatYaよりTreasureDataへのデータ送信が可能になります。 利用例としては、サンクスページの様に、情報は取得したいが、 表示タグ例
非表示タグ例 ※<scrptの後にdata-no-chat=”true” 属性を追加 |
WhatYaクライアントAPI | オペレーター接続時に、来訪者が見ている商品、もしくは見ているサイトの情報を、任意のメッセージとしてオペレーターに自動送信できます。 ※詳細はこちらをご確認ください。また、導入の際はベンダー様にお問い合わせください。 |
バッジ機能 | オペレーターからのメッセージの未読件数をチャットボタンにバッジとして表示します。 以下の条件を満たしているいずれかのタイミングで表示されます。
もしくは
※詳細はこちらをご確認ください。 |
導入
導入について |
|---|
タグ埋め込み/CSSなど、WhatYaを導入する際に必要な作業 |
作業 | 詳細 |
|---|---|
導入準備について | 導入時に必要な項目については前提条件の項目を参照してください。 |
よくある質問
よくある質問 |
|---|
WhatYaに関するよくある質問は以下にまとめております。 WhatYaの埋め込みタグによって取得される情報について（サードパーティークッキー、ローカルストレージについて） https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/2282455307
|