本オペレータ機能はオプション機能です。ご利用希望のお客様はお気軽に弊社サポートまたは貴社担当者までご連絡下さい。

---

オペレータ機能は、無人対応（チャットボット）から有人対応（オペレータチャット）に処理を移し、必要に応じて無人／有人対応を切り替える機能です。

・オペレータ対応チャットは、Botbird for Businessの管理画面内から行います。
・オペレータ対応中はチャットボットは自動返答を停止し、対応終了後に再開します。
・オペレータ呼び出しをボット会話のどのようなタイミングで開始するかを、シナリオによって任意に変更可能です。
・オペレータがログインしているときにだけ、オペレータを呼び出す選択肢を提示することが可能です。
・対応プラットフォーム：WEBチャット・LINE WORKS

---

１）WEBチャット／LINE WORKSでの設定（管理者）
２）オペレータアカウントの作成（管理者）
３）オペレータ起動シナリオの作成（管理者）
４）ボット会話からオペレータ呼び出しへ（会話ユーザー）
５）オペレータアカウントのログインとオペレータ会話の開始（オペレータ）
６）オペレータ会話の終了（オペレータ）

---

１）WEBチャット／LINE WORKSでの設定（管理者）

①WEBチャットの場合
オペレータ機能に対応したHTMLタグが必要ですので、別途弊社より発行を受けて下さい。（既存のオペレータ無し用HTMLタグと別ページで共用可能です）

②LINE WORKSの場合
こちらのLINE WORK設定画面ヘルプをご確認のうえ、LINE WORKS Developerページ上で作成するボット作成時の「Callback URL」を、別途弊社にて発行するURLに変更してご利用下さい。
なお、こちらは既存のボットとの併用は出来ません。お試しになる場合は、既存のBot設定の「Callback URL」を一時的に変更してお試し下さい。

２）オペレータアカウントの作成（管理者）

①左メニューから「オペレータ」-「オペレータ管理」を選んで下さい。

②オペーレータID、オペレータアカウント名、パスワード、ニックネーム、Eメール等を入力して、「サーバに保存」を押して下さい。

３）オペレータ起動シナリオの作成（管理者）

①シンプル返信やシナリオボットにて、ボットが「/manual」と返信する設定を作成して下さい。

②シナリオボットの選択肢では、オペレータがログインしている時だけその選択肢を表示する{operator_login}タグや、オペレータがログインしていない時だけその選択肢を表示する{operator_nologin}タグを利用することも出来ます。

４）ボット会話からオペレータ呼び出しへ（会話ユーザー）

①会話ユーザーにて上記の会話が呼び出されると、オペレータ呼び出しが開始されます。

②オペレータ呼び出しが行われると、オペレータに通知メールが届きます。

５）オペレータアカウントのログインとオペレータ会話の開始（オペレータ）

①上記２）で作成したオペレータ用アカウントにログインしておきます。

オペレータ対応をする際の管理画面は通常のものとログインURLが異なりますのでご注意ください。
https://botbird.biz/member/login_operator
ログインには、「アカウントID」「オペレータID」「オペレータパスワード」の３つの情報を必要とします。

②左側メニュー「オペレータ」内の「オペレータ手動返信」の画面を開きます

③対応するIDのリンクを選ぶと、その会話ユーザとチャットできる画面が開きます。そちらでチャット応対を行って下さい。

(Tips:) 対応リストのある画面をクリックしておくと、ユーザーから呼び出しがあった際に音で知らせることができます(Google Chromeでのみ動作します)

※その他画面に設置しているプレビュー用のチャットウィンドウと間違えないようにご注意ください。横幅が広いものがオペレータ対応用のチャットウィンドウです。

 

６）ビデオ通話の開始（オペレータ）

①オペレータは、チャット画面のビデオアイコンを利用してビデオ通話を開始することが可能です。

②利用者には、下記のようにビデオ通話画面へのリンクが表示されます。

 

 

 

③ビデオ通話画面は下記のようになります。

　

７）オペレータ会話の終了（オペレータ）

①会話を終了する場合は、「/bye」と入力して下さい。
　ユーザーが「Close」ボタンを押した場合も会話が終了します。

②終了後、会話ユーザはもとのボット対応に戻ります。

 

動作環境

オペレータ

• プラットフォーム
  • Windows
  • macos
• ブラウザ
  • Chrome 最新安定版
  • Firefox 最新安定版
  • Windows: Microsoft Edge(Chromium版) 最新安定版
    • ※Internet Explorer、Microsoft Edge旧版ではご利用になれません
  • macos: Safari 最新安定版

ユーザー

• プラットフォーム
  • Windows
  • macos
  • iOS 最新安定版
  • Android 最新安定版
• ブラウザ
  • PC/Mac
    • Chrome 最新安定版
    • Firefox 最新安定版
    • Windows: Microsoft Edge(Chromium版) 最新安定版
      • ※Internet Explorer、Microsoft Edge旧版ではご利用になれません
    • macos: Safari 最新安定版
  • iOS
    • Safari 最新安定版
  • Android
    • Chrome 最新安定版

 

■「ゴール」測定について

Botbird for Businessでは、ダッシュボードやシナリオ毎の統計画面にて表示される
「ゴール」測定によって、特定のシーンに到達したユーザー数を取得することが出来ます。

 

＜ダッシュボードでの「ゴール」数表示例＞
表示期間はお好きな期間を選択することが出来ます。
（特定の期間を選択後、「アップデート」ボタンをクリックすると、下部に反映されます。）

 

＜「統計・ログ＞シナリオ毎の統計」での「ゴール」数表示例＞
各テーブルには、以下の情報が表示されます。

シナリオ毎の統計
シナリオ名
シナリオトーク数
シナリオ開始数
シナリオ開始ユーザー数
シナリオゴール数
ゴール到達ユーザー数：そのシナリオの「終了」チェックを付けているシーンに到達したユーザーの数です。
指定ゴール数
指定ゴール到達ユーザー数
ゴール到達率
指定ゴール到達率

 

---

 

■「ゴール」測定方法

シナリオの任意のシーンに「ゴールID」文字列をつけた場合、そのIDをシナリオ毎の統計ページの
「指定ゴール名」の欄に記載して集計取得して頂けますと、そのシーンに到達したユーザ数を
取得することが出来ます。

＜測定例＞
「シナリオボット」の各シーン設定時に
「GOODEND」「BADEND」「CHECKPONT1」「CHECKPONT2」「CHECKPONT3」
などのゴールIDを付与します。

その後、「統計・ログ＞シナリオ毎の統計」ページの「指定ゴール名」の欄に
集計したいゴールIDを入力して「アップデート」ボタンをクリックして下さい。
下部に「指定ゴール名」に到達したユーザー数が表示されます。

ゴールIDを指定していない場合は、メッセージを作成時、最後のシーンに「終了」チェックを
付けていらっしゃると思いますので、そこまで到着したユーザの数となります。

 

 

CSSを編集し、WEBチャットの見た目を自由に変更することができます。

---

---

■ CSSの編集方法

１)　デフォルトのCSSをコピーする

https://botbird.biz/css/chatbox.css よりデフォルトのCSSを全てコピーし、新規CSSファイルにペーストします。

２)　CSS内容を編集する

お手元のエディタソフトを利用し、CSSを編集します。
以下に、代表的なid・classの一例を記載します。

.chatBoxHeader：WEBチャットボックスのタイトル

.speech-bubble-user：ユーザーが発話した内容(吹き出し)

※吹き出し下部の三角は::after要素で定義

.speech-bubble-bot：ボットが返答した内容(吹き出し)

吹き出し下部の三角は::after要素で定義

#inputBox：ユーザーが入力するテキストボックス

#inputBoxSubmitBtn：送信ボタン

３)　編集したCSSファイルをサーバーにアップロードする

先ほど編集したCSSファイルを、サーバーにアップロードします。どのディレクトリにアップロードしても構いません。アップロードが完了したら、CSSファイルのパスを控えておきます。

４)　WEBチャット貼り付けタグ内の、CSSファイルURLを独自のものに変更する

WEBチャットボックスタグ内の、下記”https://botbird.biz/css/chatbox.css”の部分を、3)でアップロードしたCSSファイルのパスに変更してください。

---

以上が、CSSのカスタマイズ(独自CSSの読み込み)方法です。

■自動翻訳による返信機能とは

Botbird for Business の自動翻訳機能を使うことで、AIスマートスピーカーやチャットボットと自動翻訳により会話をすることが出来るようになります。
例えば日本語で会話の設定をしたチャットボットに対して英語で会話（翻訳機能を通して）する、といったことが可能となります。

■利用の御準備

Botbird for BusinessのGoogle翻訳機能をご利用になるには、別途お客様による 「Google Translate API」 サービス（有料）の登録が必要となります。
詳しくは　(https://cloud.google.com/translate/?hl=ja)　こちらを御覧ください。
以下で必要になるGoogle Translate API Keyも上記サービスへの登録をすることで取得できます。

※Translation API Basic（Google Cloud Translation API V2）のAPIキーを取得ください。

■自動翻訳による返信機能の設定方法

左側メニュー「全体設定」→「ボット設定」の「GOOGLE翻訳設定」という欄で設定します。

1）「Botbird上でシナリオ作成する言語のコード」に、Botbird for Businessで会話コンテンツを作成している言語コードを入力します。
（例：日本語で作成しているなら ja、英語で作成しているなら en。空白にすると利用OFFとなります。）

2)　「実際の会話の言語のコード」というところに、実際に会話をしたい言語コードを入力してください。ここを空白のままにしておくとチャットボットに対して送られたメッセージの言語を自動判定します。
（例：英語でボットと会話したい場合は en 、フランス語でボットと会話したい場合は fr 。言語の自動判定をする場合は空白）
（Google HomeやAmazon Echoなどのスマートスピーカーでは、機器によって言語設定が決まっています。その場合は、自動判定ではなく、その機器で利用されている言語を指定する必要が有ります。）

3）　「Google Translation API Key」にお客様のGoogle Translation API Keyを入力してください。

4)　「アップデート」をクリックしてください。

■実際に使ってみる

例として以下のようにシンプル返信を日本語で設定します。

自動翻訳設定を以下のように設定します。
（Botbird上でシナリオ作成する言語のコード）：ja
（実際の会話の言語のコード）：en

すると、チャットプレビュー画面で以下のように英語でボットに話しかけると、日本語で設定したシンプル返信の内容を英語に自動翻訳して返答するようになります。

■置き換えタグを使ってユーザー毎の言語設定を行う

置き換えタグを使うことで、ボットとの会話を通してユーザー毎に異なる言語設定を利用するという使い方も可能です。

{set_user_lang:言語コード}　という置き換えタグを使って言語設定を変更します。

（例：{set_user_lang:ja} は日本語での会話を行う設定になります。）
（例：{set_user_lang:}　このように言語コードを書かないと言語の自動検出の設定になります。）

・使用例

以下のようにシンプル返信を設定します。

ボットとの会話を通して言語の設定が行えるようになります。この設定は、現在会話したユーザーにのみ有効です。

■スマートスピーカーで使用する場合

スマートスピーカーからボットと会話をする場合、一つのデバイスにつき一つの言語しか同時に設定できません。（2018/04/18現在）
例えば日本語設定をしたスマートスピーカーでは英語を認識することが出来ません。

従って、下記の制限にて自動翻訳をご利用下さい。
・言語の自動検出は出来ません。全てデバイスで設定されている言語として認識されます。
・デバイスの言語設定と、Botbirdで有効な言語（「実際の会話の言語のコード」または「{set_user_lang:言語コード} で設定された言語コード」）を合わせて利用頂く必要が有ります。

Google Homeでの言語設定：
https://support.google.com/googlehome/answer/7550584?hl=ja

Amazon Alexaでの言語設定：
amazon alexaアプリを開く　→　ホーム画面の左上にあるメニューボタンをタップ　→　設定→　デバイス一覧から目的のデバイスを選択　→　言語　→　言語を選択して「設定を保存」）

・複数台のスマートスピーカーを用いた使用例
日本語と英語にそれぞれ設定したスマートスピーカーを用意し、以下のようにシンプル返信を設定します。

２つのスマートスピーカーに対して

日本語設定のスマートスピーカー　→　「日本語に設定する」
英語設定のスマートスピーカー　→　「Set to English」

言語設定の文言を事前に話しかけておくことで、スマートスピーカー毎にBotbird for Businessの言語設定を行うことができます。

■ユーザー変数とは

会話相手ごとに任意の値を覚えることの出来る機能です。
例えば、会話のなかで会話相手の趣味や好きな食べ物、年齢などを聞いて保存しておくことが可能です。

■ユーザー変数で利用する置き換えタグ

・変数に会話中ユーザーに関する値をセットする時：{set_var:変数名:値}
・会話中ユーザーの変数の値を利用する時：{get_var:変数名:デフォルト値}
・会話中ユーザーの変数の値を全て利用する時：{get_var_all}
この３種類の変数をシンプル返信機能やシナリオ機能に書くことでユーザー変数を使うことができます。

■使い方の例

・ユーザー変数の例１

以下は、変数を利用することで同じユーザーからの２回目以降の会話においてボットの返信のパターンを変えることができるようになるという例です。

変数に値をセットするとき（「シンプル返信（簡易 or 詳細）」）

①　検索ワードの項目に「はじめまして」、返信メッセージの項目に「はじめまして。{set_var:hello:また会いましたね。}」と書き込みます。

変数の値を利用するとき

①　検索ワードの項目に「こんにちわ」、返信メッセージの項目に「こんにちわ。{get_var:hello:はじめまして}」と書き込みます。

②プレビューで確認します。

①「はじめまして」と話しかけると、返信時にユーザー変数 hello に “また会いましたね。” という値が格納されます。
②「こんにちわ」と入力すると、ユーザー変数 helloに保存された”また会いましたね。” をつかってボットが返答をします。

---

・ユーザー変数の例２

変数に値をセットするとき（「シンプル返信（簡易 or 詳細）」）

①　検索ワードの項目に「趣味は(.*)です」、返信メッセージの項目に「趣味は{match0-1}ですね。{set_var:hobby:{match0-1}}」と書き込みます。

②　プレビュー機能（ヘルプ記事）を利用して確認

これで「音楽」という趣味が変数として格納されます。

③　格納された変数の確認
左側メニュー「統計・ログ」をクリックし、「ユーザー変数」を選択して下さい。
すると以下の様に　「音楽」　という変数が格納されているのがわかります。

変数の値を利用するとき

①　検索ワードの項目に「ひまだなー」、返信メッセージの項目に「趣味の{get_var:hobby:何か}をしてみたらどうでしょう？」と書き込みます。

②　プレビュー機能で

「ひまだなー」→「趣味の音楽をしてみたらどうでしょう？」　と返してきます。

---

・ユーザー変数の例３

他の置き換えタグとの組み合わせも可能です。

①　シンプル返信（簡易 or 詳細）の検索ワードの項目に「数えて」、返信メッセージの項目に「数を数えます。{set_var:mycount:{math::{get_var:mycount:0}+1}}{get_var:mycount:0}」と書き込みます。

②　プレビューで確認します

プレビュー機能で　「数えて」　と入力するたびに変数に数を加算してゆきます。

この例では、{get_var}　→　他の置き換えタグ　→　{set_var}　という順番で処理しています。

---

・ユーザー変数の例４

以下の例では、シナリオ機能を使って選択肢を提示し、ユーザーからの選択結果をユーザー変数として格納します。

①　シナリオボット画面で以下のように４つの選択肢を表示します。そして選択を行ったシーンIDのメッセージの部分に、{set_var:location:値} を書きユーザー変数を定義します。
シナリオボットの基本的な使い方に関しては（シナリオボット）を参照ください。

②　プレビュー機能でシナリオを呼び出して、選択肢を選択するとユーザー変数に値が格納されます。

上の図の例では、「東京」という値がユーザー変数として格納されます。

 

シナリオボットの設定情報は、各シナリオ毎にCSVファイルをダウンロード、アップロードしてご利用することが可能です。

■ファイル形式について

カンマ区切りのCSVファイル（UTF-8:BOM無し）です。

データは、「１行あたり１選択肢」で、左側から「シナリオ情報群」「シーン情報群」「選択肢情報群」が記載されています。
（例えば、あるシーンに複数の選択肢が登録されている場合は、左からシーン情報までの内容は全く同じで、選択肢情報のみ異なる行が選択肢の数だけ存在します。）

■Botbird for Businessへのダウンロード方法

上部[Tools]-[CSVダウンロード]をお選び下さい。

■EXCELでダウンロードしたCSVファイルを開く方法

データ内に改行が含まれる場合と含まれない場合によって、EXCELでの開き方が異なります。

（１）データ内に改行が含まれない場合
１）EXCELを起動し、メニューの「インポート」から、「CSVファイル」または「テキストファイル」をお選び下さい。
２）形式の設定は「Unicode(UTF-8)」「区切り文字:カンマ」をお選び下さい。

（２−１）データ内に改行が含まれる場合：Windows
１）Windowsのメモ帳で一度CSVファイルを開き、編集せずに「名前を付けて保存」して下さい。
（「UTF-8」エンコード形式になっているかをご確認下さい）
２）保存後、このファイルをEXCELで開きます。

（２−２）データ内に改行が含まれる場合：Mac

[ターミナルを使用する場合]
１）ターミナルを開き、CSVファイルが保存されている場所に移動します。
※「cd」コマンドを利用します。利用方法が不明な場合は別途お問い合わせ下さい。
２）次のコマンド実行して下さい。
cat <(printf "\xEF\xBB\xBF") output.csv > output_2.csv
＊output.csvは元のファイル名、output_2.csvは新ファイル名に適宜ご変更下さい。
３）新ファイルをEXCELで開きます。

[Googleスプレッドシートを使用する場合]
１）Googleスプレッドシートで新規のスプレッドシートを開きます。（Googleスプレッドシートの利用にはGoogleアカウントが必要です。詳しくはこちらをご覧ください。https://www.google.com/intl/ja_jp/sheets/about/）
２）「ファイル」　→　「インポート」 を選択して表示されるウィンドウの「アップロード」タブを選択し、csvファイルをドラッグアンドドロップしてアップロードします。
３）シート上にcsvの内容が表示されますので、データの範囲をすべて選択した状態でクリップボードにコピーします。
４）EXCELを開き、新規シートを作成します。
５）EXCELシート上の「A０」セル（一番左上のセル）に、クリップボードのデータを貼り付けします。

■EXCELでの編集後、CSV形式での保存方法

ファイル保存ダイアログから、必ず「CSV UTF-8(コンマ区切り)」をお選び下さい。
※「CSV UTF-8(コンマ区切り)」での保存にはEXCEL2016が必要です。
※EXCEL2016がない場合、個別にご相談下さい。

■Botbird for BusinessへのCSVアップロード方法

ファイルを選択してから、上部[Tools]-[CSVアップロード]ボタンを押して下さい。

・ID（シナリオID、シーンID、選択肢ID）を残したままCSV編集してアップロードすると情報の上書きとなります。

・シナリオIDとシーンIDを残し、選択肢IDを空白にしてアップロードすると、新規選択肢情報の追加となります（既存の選択肢行をコピーし、選択肢IDを空白にしてから選択肢情報の内容変更すると簡単です）。

■統計・ログ設定とは？

左側メニュー「統計・ログ」をクリックすると、以下のメニューが表示されますので、必要に応じてご活用下さい。

・統計分析
シナリオゴール到達等の統計分析を確認することが出来ます。
・シナリオ毎の統計
作成したシナリオ毎の統計分析を確認することが出来ます。
・会話履歴
作成したボットがどのように話したか確認することが出来ます。
・会話ユーザー情報
作成したボットが会話した相手の情報を確認することが出来ます。
・操作履歴
「Botbird for Business」ログイン後の操作履歴を確認することが出来ます。

 

 

 

■WEBチャットボックス設定方法

左側メニュー「全体設定」をクリックし「WEBチャットタグの取得」を選択して下さい。

「WEBチャットボックスタグの自動生成」設定欄が表示されますので、「WEBチャットボックスタグ」上（英数列上）で1回クリックをしてコピーして下さい。
※1回クリックすると、文字列を全て選択することが出来ます。

コピー後、ボットを表示させたい箇所（WEBページやブログパーツ）へ貼り付けて下さい。
初期設定時のまま編集されていない場合は、左下に「入力して下さい」と表示されたボックスが表示されますので、クリックして正しく動作するかご確認下さい。

WEBチャットボックスは、細かな設定を行うことが出来ます。
「WEBチャットボックスタグ」の下の各種設定欄で行えますので、必要に応じてカスタマイズを行って下さい。

＜設置例＞
初期設定時のまま「TEC29」ブログ内カスタムプラグインとして設置した場合
（使用ブラウザ：Google Chrome）

■チャットボックスを開いた時の表示設定を編集する場合
「WEBチャットボックスのタイトル」「WEBチャットボックスの副題」「初期メッセージ」「入力欄の背景文字」設定欄を編集して下さい。

①WEBチャットボックスのタイトル：チャットボックスを開いた時に、上部に表示されます
②WEBチャットボックスの副題：チャットボックスを開いた時に、上部に表示されます
③初期メッセージ：チャットボックスを開いた時、一番最初に表示される文言を設定出来ます
④入力欄の背景文字：チャットボックスを設置した際に表示される文言が設定出来ます

■チャットボックス設置時の表示設定を編集する場合
「高さ（画面に対する％）」「横幅（画面に対する％：PCのみ。モバイルは全幅）」「左端からの距離（px）」「右端からの距離（px）」「上端からの距離（px）」「下端からの距離（px）」「自動ポップアップまでの秒数」「会話内ボットアイコン画像URL」「未利用時のポップアップ用アイコン化」「ポップアップ用アイコン画像URL」設定欄を編集して下さい。

なお、表示設定のカスタマイズ（編集）を行いますと、即時「WEBチャットボックスタグ」が更新されます。
各設定を変更した後は、必ず「WEBチャットボックスタグ」をコピーして、貼り付けなおして下さい。

＜カスタマイズ後の設置例：Botbird for Business＞

■注意事項

管理画面の「WEBチャットボックスタグの自動生成」欄は、タイトル等の設定をBotbird for Business内に記憶するものではなく、様々なWEBページに合わせて、多種多様なWEBチャット設定タグを一時的に動的生成するための欄です。
生成されたタグを都度WEBサイトに貼り付け（更新）して、ご利用ください。

■botbird-webchat-component.js / chatbox.jsの指定可能なパラメータ（ご参考）

title　：　タイトル
subtitle　：　サブタイトル
placeholder　：　入力欄のメッセージ
inputHeight　：　高さ
inputWidth　：　横幅
inputLeft　：　左からの距離
inputRight　：　右からの距離
inputBottom　：　下からの距離
inputTop　：　上からの距離
initialMsg　：　初期メッセージ
initialMsg2nd　：　二度目の訪問以降の初期メッセージ
initialSubmitMsg　：　WEBチャットオープン時に背後で送るメッセージ（シナリオ開始タグなど）
botIconUrl　：　ボットメッセージに表示されるアイコン
popupSec　：　自動ポップアップまでの時間（秒）
chatBoxIcon　：　初期状態でアイコン画像化しておく場合は1
chatBoxIconImgUrl　：　初期状態のアイコン画像URL
slidesPerView　：　検索ボット結果のカルーセル表示時、可視領域に表示する枚数（デフォルトで1.25）
linkOpenTarget　：　URLリンクオープン時のTarget（デフォルトで_blank）
uname　：　任意のユーザー名（{name}で使われます）
uid　：　任意のユーザーID（会話履歴に表示されます）

※文字列は、URLエンコードしてご指定ください