ダイアログのスタートアップガイドです。

こちらの記事は、ダイアログのツリー作成手順についてご紹介しております。
画面構成などダイアログ機能の概要については、スタートアップガイド（概要編）をご確認ください。

前提

ダイアログをご利用希望の場合は、弊社カスターマーサクセス担当者から概要及び設定方法についてご案内させていただきます。
ご利用をご希望の場合は、弊社カスターマーサクセス担当者にご連絡ください。

設定の流れ

ダイアログの設定の流れはこちらです。

ダイアログ画面でシナリオを設定
チャットボタン設定画面でチャットボタン設定とダイアログの紐付け

↑図を作成する

ダイアログ画面でシナリオを設定する

各メッセージタイプの役割について

シナリオ設定手順の前に、各メッセージタイプの役割についてご紹介します。
メッセージタイプの役割は、大きく分けて4つに分類できます。

メッセージをまとめる
メッセージを発話して繋げる
メッセージを発話してコンテンツを表示する
オペレータに繋げる

役割ごとにメッセージタイプと設定項目を1つずつ紹介いたします。

メッセージをまとめる

メッセージコンテナ

複数メッセージタイプをまとめて投稿したい場合などにご利用いただくメッセージタイプで
メッセージコンテナの中に、複数メッセージを設定します。
メッセージコンテナの詳しい内容についてはこちらの記事をご覧ください。

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。
2️⃣	必須	投稿メッセージ	吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	同時に投稿されるメッセージ	同時に投稿されるメッセージを設定してください。（複数メッセージ追加可能）新規メッセージを作成して追加もしくは設定済みのメッセージを追加ください。

メッセージを発話して繋げる

	設定項目名			設定項目の説明
1️⃣	任意	ラベル		こちらはチャット画面上には反映されない項目です。
2️⃣	必須	投稿メッセージ		吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	選択肢	リスト表示文	リスト上に表示される文字を設定してください。
4️⃣	必須	選択肢	メッセージを追加（ボタン上の表記）	リスト表示文（3️⃣）をクリックした後に、投稿させるメッセージを設定してください。新規メッセージを作成して追加もしくは設定済みのメッセージを追加ください。

チップ（値付き）

質問の選択肢チップを設定できます。ユーザーが選択したアイテムに応じて発話するメッセージを設定でき、次のメッセージに繋ぐことができます。

	設定項目名			設定項目の説明
1️⃣	任意	ラベル		こちらはチャット画面上には反映されない項目です。
2️⃣	必須	投稿メッセージ		吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	チップアイテム	チップ表示文	チップ上に表示される文字を設定してください。
4️⃣	必須	チップアイテム	メッセージを追加（ボタン上の表記）	チップ表示文（3️⃣）をクリックした後に、投稿させるメッセージを設定してください。新規メッセージを作成して追加もしくは設定済みのメッセージを追加ください。

画像スライダー（アイテム）

複数の画像をスクロールして閲覧することのできる画像タイプのメッセージタイプを設定できます。
ユーザーが選択したアイテムに応じて発話するメッセージを設定でき、次のメッセージに繋ぐことができます。

	設定項目名			設定項目の説明
1️⃣	任意	ラベル		こちらはチャット画面上には反映されない項目です。
2️⃣	必須	投稿メッセージ		吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	画像アイテム	画像上表示文	画像上に表示させるテキストを入力してください。
4️⃣	必須		メッセージを追加（ボタン上の表記）	画像上表示文（3️⃣）をクリックした後に、投稿させるメッセージを設定してください。新規メッセージを作成して追加もしくは設定済みのメッセージを追加ください。
5️⃣	必須		画像URL	表示する画像のURLを入力してください。
6️⃣	任意		代替テキスト	画像が表示されない時に表示されるテキストを入力してください。

メッセージを発話してコンテンツを表示する

テキスト

ユーザーが選択したリストの選択肢に応じて、発話させるテキストメッセージを設定できます。

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。
2️⃣	必須	投稿メッセージ	吹き出しとして投稿されるメッセージを入力してください。

画像

ユーザーが選択したリストの選択肢に応じて、発話させる画像タイプのメッセージを設定できます。

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。
2️⃣	任意	投稿メッセージ	吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	画像URL	表示する画像のURLを入力してください。
4️⃣	任意	代替テキスト	画像が表示されない時に表示されるテキストを入力してください。

イメージカード

ユーザーが選択したリストの選択肢に応じて、発話させる画像とテキストタイプのメッセージを設定できます。
画像、テキストにリンクボタンの設置ができます。

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。
2️⃣	任意	投稿メッセージ	吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	画像URL	表示する画像のURLを入力してください。
4️⃣	必須	キャプション	画像の下に表示されるテキストを入力してください。
5️⃣	必須	遷移先URL	リンクボタンをクリックした後に遷移するページのURLを入力してください。
6️⃣	必須	リンクテキスト	リンクボタンに表示させるテキストを入力してください。

YouTube

ユーザーが選択したリストの選択肢に応じて、発話させるYouTubeタイプのメッセージを設定できます。

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。
2️⃣	任意	投稿メッセージ	吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	動画ID	表示させるYouTube動画の動画IDを入力してください。
4️⃣	任意	オートプレイ	メッセージが表示後、自動で動画再生させたい場合はこちらの項目にチェックを入れてください。
5️⃣	任意	終了通知	動画再生終了時に、サーバーに終了通知を送る場合はこちらの項目にチェックを入れてください。

チップ（値なし）

ユーザーが選択したチップに応じて、ユーザー側の吹き出しとして発話させるメッセージを設定できます。

	設定項目名			設定項目の説明
1️⃣	任意	ラベル		こちらはチャット画面上には反映されない項目です。
2️⃣	必須	投稿メッセージ		吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	チップアイテム	チップ表示文	チップ上に表示される文字を設定してください。チップ表示文をタップ後、チップ表示文に設定した文字がユーザー側の吹き出しとして発話されます。

マークダウン

ハイパーリンク表示ができます。（以下画像の「こちら」）

設定項目名

設定項目の説明

1️⃣

任意

ラベル

こちらはチャット画面上には反映されない項目です。

2️⃣

必須

投稿メッセージ

[リンクテキスト](URL)と入力することで、［］内に入力したリンクテキストを、指定したURLへリンクできるようになります。

※上記サンプル画像を実現したい場合の記述例
空色商店へようこそ！

おすすめ商品一覧は [こちら](https://solairo.co.jp) をご覧ください。

吹き出し内で改行をしたい場合

以下のいずれかの方法で改行が可能です。
・1行空白の行を入れる
・文末に半角空白スペースを2つ入れる
※「\n」の使用はできません。

画像スライダー（リンク）

複数の画像をスクロールして閲覧することのできる画像タイプのメッセージタイプを設定できます。
ユーザーが選択したアイテムに応じて遷移させるページのURLを設定します。

	設定項目名			設定項目の説明
1️⃣	任意	ラベル		こちらはチャット画面上には反映されない項目です。
2️⃣	必須	投稿メッセージ		吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	画像アイテム	画像上表示文	画像上に表示させるテキストを入力してください。
4️⃣	必須		遷移先URL	画像クリック後に遷移するページのURLを入力してください。
5️⃣	必須		画像URL	表示する画像のURLを入力してください。
6️⃣	任意		代替テキスト	画像が表示されない時に表示されるテキストを入力してください。

画像スライダー（アタッチメント）

複数の画像をスクロールして閲覧することのできる画像タイプのメッセージタイプを設定できます。
ユーザーが選択したアイテムに応じて表示させるアタッチメント（アイテム一覧）を設定します。

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。
2️⃣	任意	投稿メッセージ	吹き出しとして投稿されるメッセージを入力してください。
3️⃣	必須	画像アイテム	スライダー上に表示させる画像アイテムを追加してください。
4️⃣	必須	画像上表示文	画像上及びスナックバー上に表示させるテキストを入力してください。
5️⃣	必須	タグ	アタッチメント検索に使用する商品に紐づくタグを入力してください。
6️⃣	必須	画像URL	表示する画像のURLを入力してください。
7️⃣	任意	代替テキスト	画像が表示されない時に表示されるテキストを入力してください。

アタッチメント

アイテムの一覧をWebサイトの商品を連携し、アイテム一覧を表示することができます。
※特定のサービスをお申し込み頂いているお客様のみ利用できます。通常はご利用いただけませんのでご了承ください。

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。
2️⃣	任意	テキスト	スナックバー上に表示させるテキストを入力してください。
3️⃣	任意	タグ	アタッチメント検索に使用する商品に紐づくタグを入力してください。
4️⃣	任意	スナックバー省略	スナックバーの表示を行わずにアタッチメントを起動させたい場合は、こちらの項目にチェックを入れてください。

スペシャルタグ

スペシャルタグで設定したアイテム一覧を表示することができます。
※スペシャルタグの設定方法についてはこちらの記事をご確認ください。
【スペシャルタグ】画面の解説

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。
2️⃣	任意	テキスト	スナックバー上に表示させるテキストを入力してください。
3️⃣	任意	タグ	スペシャルタグで設定したタグ名を入力してください。スペシャルタグの接頭文字（デフォルトは##）の入力は不要です。
4️⃣	任意	スナックバー省略	スナックバーの表示を行わずにアタッチメントを起動させたい場合は、こちらの項目にチェックを入れてください。

オペレータに繋げる

オペレータ接続

有人接客に切り替えることができます。
※BOTのみをご利用の場合は、こちらのメッセージタイプはご利用いただけません。

	設定項目名		設定項目の説明
1️⃣	任意	ラベル	こちらはチャット画面上には反映されない項目です。

シナリオを新規作成する

まず、シナリオの新規作成方法をご案内します。
手順は以下の動画をご確認ください。

　　┗シナリオ先頭メッセージを追加する（メッセージコンテナを作成する）
　　┗メッセージをまとめる（メッセージコンテナにリストメッセージを格納する）
　　┗メッセージを発話して繋げる（リストメッセージにテキストメッセージをつなげる）
　　┗メッセージを発話してコンテンツを表示する（テキストメッセージを編集する）
　　┗テスト環境：保存する
　　┗本番環境に反映する
　　┗テストを行う

シナリオ先頭メッセージの追加について

シナリオ先頭にチェックあり：「シナリオ先頭メッセージ追加」の場合

シナリオ先頭にチェックがある場合は、追加されたメッセージがシナリオのTOPに表示されます。
まずシナリオのTOPに表示させたいメッセージを追加したい場合は、「シナリオ先頭メッセージ追加」をクリックし、メッセージを設定してください。

「シナリオ先頭メッセージ追加」でメッセージを設定すると、タブ：ツリー上に設定したメッセージが表示されます。

シナリオ先頭にチェックなし：「新規メッセージ追加」の場合

一気にメッセージを追加し、後からツリー上のメッセージに紐づける場合は、「新規メッセージ追加」をクリックし、メッセージを設定してください。
※なお、デフォルトでチェックは入っておりませんが、メッセージ編集中にチェックを入れることも可能です。

ダイアログ画面のタブ：テスト環境をクリック
左上の「編集」ボタンをクリック
「シナリオ先頭メッセージ追加」ボタンをクリック
シナリオ先頭メッセージ追加後、ラベルを設定します。
※こちらは必須項目ではありませんが、チャットボタンと紐づける際にどのシナリオかを識別するために設定いただくことを推奨いたします。
次にメッセージタイプを設定します。
シナリオ先頭メッセージの場合、複数のメッセージタイプをまとめることが可能な「メッセージコンテナ」を選択いただくことをおすすめいたします。
※メッセージコンテナの詳細はこちらをご覧ください。
投稿メッセージは吹き出しに表示されるテキストメッセージです。
投稿メッセージは任意項目となります。
次に同時に投稿するメッセージを設定します。
以下画像の赤枠内をクリック

ウィンドウの左上：「新規メッセージを追加して設定」ボタンをクリック
※すでに作成されたメッセージを選択することも可能です。
「新規メッセージを追加して設定」ボタンをクリック後
メッセージが追加されるので、メッセージをクリックしメッセージを編集します。

こちらの見本設定では、メッセージタイプから「リスト」を選択します。

投稿メッセージは吹き出しに表示されるテキストメッセージです。
投稿メッセージは任意項目となります。

リストの選択肢を追加します。
「選択肢を追加」ボタンをクリックします。

選択肢上の表示文を設定します。
リスト表示文に任意のテキストを入力ください。

次にリストの選択肢をクリック後に投稿されるメッセージを設定します。
「メッセージを追加」ボタンをクリックします。
「新規メッセージを追加して設定」をクリックします。

「確定」ボタンをクリックします。

※複数選択肢を追加する場合は「選択肢を追加」ボタンをクリックし、選択肢を追加ください。
次にリストの選択肢をクリック後に投稿されるメッセージを設定します。
リスト表示文の右側に表示されているメッセージ（赤枠）をクリックします。

メッセージ設定に切り替わった後、ラベルを設定します。
※こちらは必須項目ではありませんが、チャットボタンと紐づける際にどのシナリオかを識別するために設定いただくことを推奨いたします。

次にメッセージタイプを設定します。
こちらの見本設定では、メッセージタイプから「画像スライダー（リンク）」を選択します。

投稿メッセージは吹き出しに表示されるテキストメッセージです。
投稿メッセージは任意項目となります。

画像スライダーに表示される画像アイテムを設定します。
「画像アイテムを追加」ボタンをクリックします。

画像アイテムの設定をします。
まず、画像上の表示文を設定します。

画像アイテムをクリックした後に、遷移するページのURLを設定します。

表示される画像を設定します。
「追加」ボタンをクリックします。

表示される画像のURLを設定し、「確定」ボタンをクリックします。

代替テキストを設定します。
画像が表示できない時に、画像の代わりに表示されるテキストです。

「確定」ボタンをクリックし、画像アイテムの追加が完了です。

※複数画像アイテムを追加する場合は「画像アイテムを追加」ボタンをクリックし、画像アイテムを追加ください。
左側に表示されているリストをクリックし、リストの設定画面に戻ります。
リストの設定画面に戻った後、リストの選択肢をクリック後に投稿されるメッセージを設定します。
リスト表示文の右側に表示されているメッセージ（赤枠）をクリックします。
※リストの選択肢をクリック後に投稿されるメッセージの設定方法は、手順9と同じなので割愛します。
設定が全て完了しましたら、「保存」ボタンをクリックします。
右下に「保存しました」が表示されましたら、テスト環境での設定保存が完了となります。

シナリオを編集する

シナリオの編集方法についてご紹介します。

タブ：テスト環境の「編集」ボタンをクリック
タブ：ツリーを選択
「＋」をクリックし、ツリーを展開
ツリー上から編集をするメッセージをクリックします。

画面下部のメッセージ編集画面でメッセージの編集または追加を行ってください。
編集作業が完了したら「保存」ボタンをクリックします。

右下に「保存しました」が表示されましたら、テスト環境での設定保存が完了となります。

タブ：テスト環境で保存した設定を本番反映させたい場合は、「テスト環境を本番環境へ反映」ボタンをクリックしてください。

本番環境への反映確認ウィンドウが表示されましたら、右側「はい」ボタンをクリックします。

右下に「環境への反映が完了しました」が表示されましたら、本番環境への反映が完了となります。

メッセージの複製について

一つのツリーを全て複製したい場合

シナリオ先頭メッセージを選択し、メッセージ詳細の「このメッセージを複製する」をクリックします。
ツリーごとそのまま複製されます。

一つのメッセージを複製したい場合

複製したいメッセージをタブ：ツリーもしくはタブ：一覧から選択し、「このメッセージを複製」ボタンをクリックします。
タブ：一覧上に、複製したメッセージが追加されます。

テスト方法について

https://solairo.atlassian.net/wiki/spaces/WHAT1/pages/2577662531#%E8%A8%AD%E5%AE%9A%E3%81%97%E3%81%9F%E3%82%B7%E3%83%8A%E3%83%AA%E3%82%AA%E3%81%AE%E5%8B%95%E4%BD%9C%E7%A2%BA%E8%AA%8D%E3%81%AB%E9%96%A2%E3%81%97%E3%81%A6%E3%81%AETips

　┗シナリオをボタンへ紐づけて反映（これをやらないと、影響がない旨を明記）
　　┗チャットボタンに紐づける→チャットボタン設定を本番反映で本番環境に反映される
　　┗チャットボタンに紐づける→チャットボタン設定をテスト環境に反映で確認
　┗簡易にシナリオチェックを行う場合
　　┗IDをチャットウィンドウへ投稿する

チャットボタン設定画面でシナリオをボタンに紐づける

シナリオをボタンに紐づける

最後に、チャットボタン側の設定を行います。チャットボタン設定にシナリオを紐づけます。

チャットボタン設定画面を開き、保存済み一覧から使用するリビジョンを選択します。
「編集」ボタンをクリックします。
シナリオを紐づけるボタン設定の右側「∨」をクリックします。
初期化メッセージのプルダウンから「ダイアログ」を選択します。
ダイアログのプルダウンから紐づけたいシナリオを選択します。
「保存」ボタンをクリックします。

任意でコメントを編集する場合は、コメントを編集し、「確定」ボタンをクリックします。

右下に「保存しました」が表示されましたら、チャットボタン設定の保存が完了となります。
次にダイアログを紐付けたチャットボタン設定をテスト環境に反映します。
該当のリビジョンをクリックします。

「テスト環境に反映」ボタンをクリックします。

任意でコメントを編集する場合は、コメントを編集し、「確定」ボタンをクリックします。

右下に「環境への反映が完了しました」が表示されましたら、テスト環境への反映が完了となります。
最後にダイアログを紐付けたチャットボタン設定を本番環境に反映します。
※本番環境に反映前に、テスト環境で動作を確認したい場合はこちらをご確認ください。

「テスト環境を本番環境へ反映」ボタンをクリックします。

任意でコメントを編集する場合は、コメントを編集し、「確定」ボタンをクリックします。

右下に「環境への反映が完了しました」が表示されましたら、本番環境への反映が完了となります。