対応ブラウザ

対応ブラウザは以下となります。

・Google Chrome (PC & mobile)
・Safari (PC & mobile)
・Firefox (PC)
・Microsoft Edge (PC)

Internet Explorerには対応していません。
※詳細はこちらをご確認下さい。
┗/wiki/spaces/CDLAB/pages/661553186

導入可能な環境

1. 以下JavaScript形式の、タグが埋め込める環境をご用意下さい。
   <script src="https://whatya.solairo-api.com/xxxx/chat.js"></script>
   ※xxxxの部分は導入企業様ごとに異なります。
   

1. チャットボタン、チャットウインドウのデザインは、
   ・WebサイトのCSSで編集
   ・WhatYa管理画面の「カスタムCSS」から編集
   

1. 
   どちらかのパターンにて、CSSを記載していただく事でデザインを変更できます。
   

1. ※弊社にてサンプルも用意しておりますのでご活用ください。
   【カスタムCSS】CSSサンプル
   

1. 空色側のホワイトリストにドメイン許可がされていないと、
   タグを埋め込んでもチャットボットへ接続ができません。
   
   ドメイン(

1. FQDN）の許可を行う場合は、担当者まで登録依頼をお願いします。
   例：https://www.solairo.co.jp/
   
   ※ステージング環境をご利用の場合は
   ステージング環境のドメインも合わせてお知らせください。
   
   上記項目の詳細はこちらのガイドをご確認下さい。
   

1. WhatYaデザインベンダー向け導入資料

※タグを埋め込むと、Webサイトの右下にチャットアイコンが表示されます

準備するもの

準備に必要なもの ※以下資料のp.5〜7を参照下さい。
┗ WhatYaデザインベンダー向け導入資料

変更可能なUI

• お客さまにてCSSで変更が可能な箇所

空色担当から依頼をいただければ以下のUIを変更できます。
┗ 変更可能なUIについて　28ページ～
　WhatYaデザインベンダー向け導入資料
┗ 指定可能なid/class一覧　9ページ～
　WhatYaデザインベンダー向け導入資料
┗【WhatYa】チャットウィンドウ上の文言変更可能な箇所について
┗【WhatYa】自動OP接続機能はどんな機能か？

接客管理画面（OKSKY）との連携

• • チャットウィンドウやボタンなどの見た目

    • CSSで指定可能はid,classの一覧は以下をご確認ください。

    • WhatYaデザインベンダー向け導入資料　p.28〜

  • チャットウィンドウ上の文言など一部

    • WhatYa管理画面の「チャット設定」で設定・変更が可能です。

      • 詳細は以下をご確認ください。

      • 【チャット設定】画面の解説

• 弊社にて変更が可能な箇所

  • チャットウィンドウ上の文言など

    • 具体的な設定変更箇所は以下をご確認ください。

    • 【WhatYa】チャットウィンドウ上の文言変更可能な箇所について

接客管理画面（OKSKY）との連携

接客管理画面（OK SKY）と連携される機能については、以下をご確認下さい。
【WhatYa】接客管理画面(OKSKY)と連携される機能

init_bot

チャットボットを
開いたときの自動投稿文

init_botは、チャットボタンをクリックして、
チャットボットが起動した時、最初に表示される自動投稿文です。
テキストだけではなく、
様々なメッセージタイプを指定する事ができます。

※このinit_botは「list」で作成しています。

init_op

オペレーターに接続した
ときの自動投稿文

init_opは、有人接客に切り替えた時、表示される自動投稿文です。
テキストだけではなく、
色々なメッセージタイプを指定する事ができます。

※このinit_opは「text」で作成しています。

ボタン設定　
　＞　初期化メッセージ

WhatYa管理画面からボタンを設定する際に、
自由に自動投稿メッセージを変更することができます。
初期化メッセージ設定欄にて送信値を設定することで、
上記のinit_botやinit_op、その他自由に設定が可能です。

Image Modified

テキスト

テキストのみの表示

※テキストの改行：〇

○

画像

テキスト＋画像の表示

※テキストの改行：〇

○

リスト

選択式のリストの表示

※テキストの改行：〇
　ただしリスト内テキストの改行は×

○

チップ（値なし）

選択式のボタンの表示

※テキストの改行：〇
※ボタン押下後、テキストが投稿される。

○

チップ（値付き）

選択式のボタンの表示

※テキストの改行：〇
※ボタン押下後、指定したメッセージタイプが投稿される。

○

リンクイメージスライダー

リンク付きの複数画像をスライド式で表示

※テキストの改行：〇

○

アイテムイメージスライダー

複数の画像をスライド式で表示

※テキストの改行：〇

○

テレフォン

電話番号のリンクの表示

※テキストの改行：×

×

メール

メールアドレスのリンクの表示

※テキストの改行：×

×

イメージカード

テキスト＋リンク付きの画像の表示

※テキストの改行：×
※ただしカード内のテキストの改行は〇

○

オペレータ接続

※テキスト記入不可

○

YouTube

動画（YouTube）のストリーミング再生

※テキストの改行：〇
※デフォルトで機能がオンになっています。
　YouTubeのプラグインを取得するため、
　ボタン表示時点でwww.youtube.comにアクセスします。

○

スペシャルタグ

【スペシャルタグ】画面の解説

○

アタッチメント

スペシャルタグ同様の画面表示ですが、Webサイトの商品を連携し、
よりスムーズな商品検索が可能となります。

○

マークダウン

ハイパーリンクの表示

○

API

WhatYaは公開したAPIをご用意しております。
チャット機能の一部を利用するためのAPI資料：
┗WhatYa APIs

※APIのみを利用して、WhatYaの機能(オペレーターと接続・会話）を利用する場合、会話を処理する別サーバー(UIや、メッセージ変換など)を必要とします。

この場合、通常の通信方式(WebSocket)とは異なり、Webhookを利用した連携接続となります。※詳細は別途ご相談ください。

とは異なり、Webhookを利用した連携接続となります。

特殊パラメーター

wy_opn=true

上記パラメータ付きのURLにアクセスした際、自動的にWhatYaのウィンドウを開きます。
このパラメーターを指定したときは、ボタンは表示されず、クリックしたことは記録されません。

wy_init_msg=任意のメッセージ

上記パラメータ付きのURLにアクセスした際、パラメーターの値（上記の例であれば「任意のメッセージ」）をWhatYaに送信します。
主に自動投稿文章を変更する際に使用します。

wy_event=任意の値

上記パラメーター付きのURLにアクセスした際、パラメータの値のチャットボット設定を参照します。（内部設定（answers）を参照します。）

※すべてのパラメーターは?や&をつけてご使用ください。

会員情報連携（データ連携）

WhatYaは、Webサイトと簡易的にデータ連携する機能をご用意しております。

大きく分けて以下2つの事が出来るようになります。

・デバイスやブラウザが変わっても同じルームで会話が出来る
・ルームに連携した情報を表示させる。

※詳細設定については、別途ご相談ください。※詳細設定については、以下記事をご参照ください。

【WhatYa】会員情報連携のトラブルシューティング FlightBoardは2021年12月29日現在

ダッシュボード

チャットボタン利用統計のグラフや指標をご確認いただけます。ダッシュボードはチャットボタン利用統計のグラフや指標をWhatYa管理画面にてご確認いただけます。

Image Removed

Image Added

Image Added

Image Removed※詳細はこちらをご覧くださいをご覧ください。

チャット非表示機能

data-no-chat=”true” 属性を埋め込みタグに指定していただくことで、チャットボタンは非表示となります。

非表示タグが埋め込まれていれば、WhatYaよりTreasureDataへのデータ送信が可能になります。

利用例としては、サンクスページの様に、情報は取得したいが、
チャットボタンを表示させたくない場所などにご利用いただけます。

表示タグ例

<script src="https://whatya.solairo-api.com/XXX/chat.js"></script>

非表示タグ例 ※<scrptの後にdata-no-chat=”true” 属性を追加

<script data-no-chat="true" src="https://whatya.solairo-api.com/XXX/chat.js"></script>

WhatYaクライアントAPI

オペレーター接続時に、来訪者が見ている商品、もしくは見ているサイトの情報を、任意のメッセージとしてオペレーターに自動送信できます。

※詳細はこちらをご確認ください。また、導入の際はベンダー様にお問い合わせください。

バッジ機能

オペレーターからのメッセージの未読件数をチャットボタンにバッジとして表示します。

以下の条件を満たしているいずれかのタイミングで表示されます。
※常時、リアルタイムで表示更新保証がなされる機能ではございません。

• オペレーターへ接続中、かつ、チャットウィンドウを閉じていて（チャットボタンアイコン時）、オペレーターからの未読メッセージがある時。

もしくは

• ページが読み込まれた最初のタイミング（チャットボタンアイコン時）で、オペレーターからの未読メッセージがある時。

※詳細はこちらをご確認ください。