コア要素

コア要素は、すべてのチャネルで利用できます。ロジック、外部統合、データ操作、会話ルーティングを処理します。

API

API エレメントを使用して、外部システムから情報を取得し、チャットボットを介してこれらのシステムに情報を送信します。

エレメントで request パラメーターと response パラメーターを設定します。次の操作も実行できます。

• API要求設定をロードするには、cURL コマンドのインポート を使用します。
• リトライ API呼び出し。
• fallback オプションを設定します。
• プレビュー API呼び出し。

API呼び出しのインポート

API リクエスト・コレクションから cURL コマンドをインポートすることで、API リクエスト構成をロードできます。API エレメント内のリクエストのヘッダーと本文は、インポートされたコマンドから自動的に更新されます。

APIリクエストを手動で設定する代わりにインポートできるシナリオの例を次に示します。

• Postman で API 呼び出しをテストし、チャットボットの API エレメントで同じデータを使用します。
• NTT CPaaS API cURL コマンドをコピーし、API エレメントでテストします。

次の手順に従います：

1. API エレメントで、[cURL コマンドのインポート] を選択します。
2. cURL フィールドに、API の cURL コマンドを入力します。API エンドポイントに対して GET 要求が行われ、指定された URL からデータが取得されます。
3. Import (インポート) を選択します。

エレメントのフィールドは自動的に更新されます。

リクエスト

[要求] タブに移動し、次のフィールドに入力します。

Method (メソッド)

次のいずれかの API メソッドを選択します。

• 取得
• 投稿
• 置く
• 削除
• パッチ
• 頭

URL

外部システムのベース URL と必要なエンドポイントを入力します。プレースホルダーを含めることができます。

ベース URL の例を次に示します。コードでは使用しないでください。

https:example.infobip です。com/sms/2/テキスト/詳細

ここで、https:example.infobip です。com は、送信SMSエンドポイントで使用される基本URLです。

URL パラメーターのエスケープを有効にする

ベース URL に次の属性が 1 つ以上含まれている場合は、このフィールドを選択します。

• 非ASCII文字
• 予約文字
• ウェブ標準で安全でない文字

このフィールドを選択すると、これらの文字が置き換えられます。

例: ベース URL には、空のスペースを返すパラメーターがあります。エスケープ オプションを有効にすると、その文字がエスケープされ、有効な URL が返されます。

API 要求に mTLS 証明書を含める

相互TLS(mTLS)は、標準TLSプロトコルの拡張です。クライアントとサーバーの両方が相互に認証することを要求することで、セキュリティ層が追加されます。通信の両方の参加者が検証され、機密データを不正アクセスから保護する安全なチャネルが提供されます。

API リクエストに mTLS 証明書を含めるには、有効なクライアント証明書と秘密鍵の両方を指定します。これにより、チャットボットはサーバーに対して自分自身を認証し、サーバーは検証のために証明書も共有できます。

mTLS証明書を設定して使用するには、次の手順を実行します。

1. mTLS 証明書の設定: mTLS リクエストを行う前に、必要なクライアント証明書と秘密鍵を設定します。証明書の設定については、NTT CPaaS サポートにお問い合わせください。
2. API 要求の構成: mTLS 証明書を設定したら、証明書を含めるように API 要求を構成します。API 呼び出し構成で、[API 要求に mTLS 証明書を含める] を選択します。
3. 複数の証明書 (オプション): セキュリティ要件に応じて、複数の mTLS 証明書を設定し、API エレメントごとに異なる証明書を選択できます。

コンテンツタイプ

要求ヘッダーのコンテンツの種類を指定します。例: 要求データが JSON 形式で送信されることを示すには、[JSON] を選択します。

選択したコンテンツ タイプに応じて、ヘッダーと本文は次のとおりです。

ヘッダー (オプション)

要求ヘッダーを使用して要求に関する情報を提供し、サーバーが応答をカスタマイズできるようにします。例: Accept-Encoding ヘッダーを使用して、応答に必要なエンコードを指定します。

このメタデータはキーと値のペアで指定され、リクエストとともに送信されます。一部のコンテンツ タイプでは、キーと値のペアには、タイプを指定する定義済みの値があります。

ヘッダーに追加の値が必要な場合は、次の操作を行います。

1. キーと値のペアを追加 を選択します。
2. キー フィールドで、リストから必要な基準を選択します。例: Accept-language。
3. [値] フィールドに値を入力します。また、値を含む属性を追加することもできます。

キーと値のペアがリストにない場合は、次の操作を行います。

1. キーと値のペアを追加 を選択します。
2. キー フィールドで、カスタムの入力 を選択します。
3. キーの名前を入力します。
4. チェックマークを選択します。
5. [値] フィールドに値を入力します。また、値を含む属性を追加することもできます。

本体(オプション)

API 呼び出しの本文を指定します。コンテンツタイプに応じて、キーと値のペアやエディターを使用できます。

キーと値のペア: キーと値のペアを追加するには、次の操作を行います。

1. キーと値のペアを追加 を選択します。
2. キー フィールドに、必要な条件を入力します。例: 言語。また、キーを含む属性を追加することもできます。
3. [値] フィールドに値を入力します。また、値を含む属性を追加することもできます。

エディター: 要求の本文として含めるテキストを指定します。

Response (応答)

API 呼び出しへの応答は属性に保存されます。

レスポンスで受信したXMLファイルの保存については、操作方法をご参照ください。

受信する予定の応答を保存するには、[応答 タブに移動し、次のフィールドに入力します。

応答コードを属性に保存する (省略可能)

応答タイプを API に保存するには、次の操作を行います。

1. 作成 属性。
2. [応答コードを属性に保存] リストから属性を選択します。

応答ヘッダーの属性

応答ヘッダーを属性に保存するには、次の操作を行います。

1. 作成 応答ヘッダーを保存する 1 つ以上の属性。
2. 属性の追加 を選択します。
3. [属性] フィールドで、一覧から属性を選択します。
4. ヘッダー名 フィールドに、ヘッダーの名前を入力します。このフィールドでは、大文字と小文字は区別されません。

応答本文の属性

API 呼び出しの戻り値本文に値があり、それらを保存する場合は、次の操作を行います。

1. 作成 応答本文を保存する 1 つ以上の属性。
2. 属性の追加 を選択します。
3. [属性] フィールドで、一覧から属性を選択します。
4. パス フィールドに、属性へのパスを入力します。パスは、その属性の値が配置されている JSON ファイル階層内の場所です。属性が配置されているレベルに応じて、属性パスにドット "." で区切られた以前のすべてのレベルを含めます。

タイムアウト

応答を待機する時間を指定します。最小値は1秒、最大値は60秒です。デフォルト値は 10 秒です。

フォールバック

エラー時に再試行する

このオプションを使用して、次のエラーが発生した場合に要求を再試行します。

• 408
• 500, 502, 503, 504
• タイムアウト

その他のすべてのエラーについては、フォールバック がトリガーされます。

再試行する回数 フィールドで、次のいずれかを実行します。

• チャットボットがリクエストを再試行する必要がある回数を選択します。最大 3 回まで再試行できます。
• 要求を再試行しない場合は、[再試行なし] を選択します。

フォールバック

フォールバックを使用して、リクエストが失敗したり、API エレメントが失敗したりした場合など、エラーが発生した場合でも、エンド ユーザーがチャットボットから応答を確実に受け取るようにします。

このような場合、フォールバック アクション がトリガーされます。これらのフィールドの設定の詳細については、フォールバックドキュメントを参照してください。

API 呼び出しのプレビュー

API 呼び出しが期待どおりに機能するかどうかを確認するには、ペイロード内の実際のシナリオを表す定義済みの値を使用します。

次の手順に従います：

1. API エレメントで プレビュー を選択します。
2. API 呼び出しのプレビュー ウィンドウで、属性フィールドにサンプル値を入力します。
3. [要求の送信] を選択します。

応答は生成され、JSON などの構造化された形式で表示されます。応答データは [本文] タブで表示でき、更新された属性は [解決された属性] タブで表示できます。

エラーが発生した場合は、通知が表示されます。

シミュレーターでテストする

シミュレーション機能を使用して、APIエレメントが正しく構成されているか、期待どおりに動作するかを確認します。シミュレーターでは、属性に保存されている API 応答を確認できます。

API 呼び出しをシミュレートするには、チャットボットの テスト タブに移動し、シミュレーションを開始します。

SOAP API 呼び出し

SOAP API 呼び出しは、XML 形式でのみ送信できます。ファイル内には、エンベロープとして機能するルートエレメントを 1 つだけ存在させることができます。

ほとんどの SOAP API は、Web サービス定義言語 (WSDL (opens in a new tab)) を使用します。WSDL は XML の構造を定義します。例: エレメントまたは属性を複数回表示できるかどうか、必須かオプションか、および要素の順序。接続先のサービスに WSDL がある場合は、WSDL との接続が簡単です。

SOAP 呼び出しは、text、xml、および xml list の値を受け入れます。後でコードエレメントで値をどのように使用するかに応じて、形式を選択します。例: 応答から抽出する XML タグがあるかどうか。

リクエスト

SOAP API 呼び出しの XML は、次の方法で記述できます。

Response (応答)

SOAP 応答 XML は、着信要求と同じロジックに従います。エラーが発生した場合、XML にはメッセージの詳細が含まれます。

SOAP と REST API の比較

次の理由から、REST の使用を検討してください。

• SOAP API は、REST API よりも低速で複雑です。
• SOAP API は XML ファイルでのみ機能します。
• SOAP API は情報をキャッシュしません。

認証

認証エレメントを使用して、チャットボットフロー内でエンドユーザーを認証します。

チャットボット エディターで、チャットボット アクション から 認証 エレメントをドラッグ アンド ドロップします。

次のフィールドへの入力を完了します：

• URL: 認証エンドポイントの URL。
• 方法: HTTP メソッドを選択します。サポートされているメソッドは GET と POST です。
• ヘッダー (省略可能): リクエストヘッダーを追加します。
• 本文 (省略可能): 要求本文。POST 要求に適用できます。
• 認証属性: 認証トークンまたは結果を保存する属性を選択します。
• フォールバック: 認証が失敗した場合に実行するアクション。

セッションを閉じる

セッションを閉じるエレメントを使用して、チャットボットセッションを終了します。セッションが終了した後、エンドユーザーはチャットボットと再度対話するために新しいセッションを開始する必要があります。

チャットボット エディターで、チャットボット アクション から セッションを閉じる エレメントをドラッグ アンド ドロップします。

コード

コードエレメントを使用して、チャットボット フロー内にカスタム JavaScript コードを記述します。これにより、複雑なロジック、計算、データ変換、および他の要素では使用できないその他の操作を実行できます。

チャットボット エディターで、チャットボット アクション から コード エレメントをドラッグ アンド ドロップします。

受講可能なクラス

コードフィールドに、JavaScriptコードを記述します。attributeApi オブジェクトを使用して、属性値を取得および設定します。

利用可能な API メソッド:

• attributeApi.get('attributeName'): 属性の値を取得します。
• attributeApi.set('attributeName', value): 属性の値を設定します。

encryptionUtilsオブジェクトを使用して、属性値をハッシュします。

利用可能なハッシュ関数:

• encryptionUtils.md5('value'): MD5 を使用したハッシュ。
• encryptionUtils.sha1('value'): SHA-1 を使用したハッシュ。
• encryptionUtils.sha256('value'): SHA-256 を使用したハッシュ。
• encryptionUtils.sha512('value'): SHA-512 を使用したハッシュ。

エレメントの構成

コードを手動で入力する

コード フィールドに、JavaScript コードを直接入力します。

例: 条件に基づいて属性の値を設定します。

const score = attributeApi.get('score');
if (score > 80) {
  attributeApi.set('result', 'pass');
} else {
  attributeApi.set('result', 'fail');
}

GenAI を使用してコードを作成および管理する

組み込みの生成 AI アシスタントを使用して、コードエレメントの JavaScript コードを作成、編集、改善、修正します。

AI でコードを作成する

1. コード エレメントで、AI で作成 を選択します。
2. コードで何を行うかを説明します。例: *品目の一覧から合計価格を計算し、それを totalPrice 属性に保存します。
3. 生成 を選択します。

生成されたコードを適用する前に確認してください。必要な変更を手動で行います。

AIで編集

1. コード エレメントで、AI で編集 を選択します。
2. 変更内容を説明する。例: *比較する前に、スコアが数値であることを確認するチェックを追加します。
3. 生成 を選択します。

コードの可読性の向上

読みやすさの向上 を選択して、動作を変更せずに既存のコードを書式設定および簡略化します。

コードを修正する

コードにエラーがある場合は、コードの修正 を選択して、AI アシスタントが問題を特定して修正できるようにします。

ユースケース

既存の情報をランダム化する

コードエレメントを使用して、属性値をランダム化します。例: メッセージバリアントまたはおすすめ商品をランダムに選択します。

const options = ['Option A', 'Option B', 'Option C'];
const randomIndex = Math.floor(Math.random() * options.length);
attributeApi.set('selectedOption', options[randomIndex]);

カウンターを使用する

コードエレメントを使用して、カウンタ属性を増減します。

let count = attributeApi.get('retryCount') || 0;
count = parseInt(count) + 1;
attributeApi.set('retryCount', count);

大きなJSONファイルを属性に転送してデータ操作を可能にする

コードエレメントを使用して、属性に保存された JSON 応答を解析し、特定の値を抽出します。

const responseJson = JSON.parse(attributeApi.get('apiResponse'));
attributeApi.set('orderId', responseJson.order.id);
attributeApi.set('orderStatus', responseJson.order.status);

属性に暗号化を追加する

Code エレメントを使用して、外部システムに送信する前に encryptionUtils を使用して属性値をハッシュします。

const value = attributeApi.get('sensitiveData');
const hashed = encryptionUtils.sha256(value);
attributeApi.set('hashedData', hashed);

コンポーネント

コンポーネントエレメントを使用して、再利用可能なコンポーネントをチャットボットダイアログに追加します。コンポーネントは、複数のチャットボットで再利用できるダイアログロジックの事前構築済みセットです。

チャットボット エディターで、チャットボット アクション から コンポーネント エレメントをドラッグ アンド ドロップします。

エレメントの構成

コンポーネント フィールドで、追加するコンポーネントを選択します。コンポーネントの詳細については、 コンポーネント ドキュメントを参照してください。

条件

条件エレメントを使用して、チャットボットに分岐ロジックを追加します。条件に基づいて、チャットボットは異なるパスをたどります。

チャットボット エディターで、チャットボット アクション から 条件 エレメントをドラッグ アンド ドロップします。

条件は、1 つ以上のルールで構成されます。各ルールは、演算子を使用して属性値を指定された値と比較します。

チャットボットに条件 エレメントを追加する

ガイドライン

• ダイアログに追加できる条件エレメントは1つだけです。
• 最大10個の条件を追加できます。
• 各条件には、最大 10 個のルールを含めることができます。
• エレメントには、組み込みの Else 条件があります。この条件を削除したり、名前を変更したりすることはできません。
• 条件は、表示される順序で評価されます。チャットボットは、true と評価される最初の条件のパスを取ります。
• 条件が true と評価されない場合、チャットボットは Else パスを使用します。

条件 エレメントを追加する

1. チャットボット エディターで、チャットボット アクション から 条件 エレメントをドラッグ アンド ドロップします。
2. 条件の追加 を選択します。
3. 条件名 フィールドに、条件の名前を入力します。例: リピーターです。
4. ルールの追加 を選択します。
5. ルールで、以下を実行します。
   • 属性: 評価する属性を選択します。
   • 演算子: 比較演算子を選択します。
   • 値: 比較する値を入力または選択します。

演算子：

• 次の値に等しい
• 等しくない
• Contains関数
• 含まれていません
• StartsWith関数
• EndsWith関数
• 空です
• 空ではない
• GreaterThan (大なり)
• Less than (小なり)
• 以上
• 以下

ブランチを構成する

各条件は、チャットボット フローにブランチを作成します。各ブランチを適切な次のエレメントまたはダイアログに接続します。

Default ブランチは、条件が true と評価されない場合に取得されます。フォールバック ダイアログまたはエレメントに接続します。

例

単純条件

属性: customerType |演算子: 等しい |値: プレミアム

チャットボットは、エンドユーザーの顧客タイプがプレミアムの場合にこのブランチを使用します。

OR 演算子を使用する条件

ルール 1: language が en に等しいか、ルール 2: language が en-US に等しい

チャットボットは、言語が en または en-US の場合にこのブランチを使用します。

AND演算子を使用する条件

ルール 1: orderValue が 100 より大きい AND ルール 2: customerType が premium に等しい

チャットボットは、両方のルールが当てはまる場合にこのブランチを使用します。

OR 演算子と AND 演算子を使用する条件

条件グループを使用して、1 つの条件内で AND ロジックと OR ロジックを組み合わせることができます。

条件を削除する

条件名の横にある削除アイコンを選択して削除します。

すべての条件を削除する

[すべて削除] を選択して、すべての条件を削除し、最初からやり直します。

条件内の条件を削除する

ルールの横にある削除アイコンを選択して、条件から削除します。

条件を複製する

条件名の横にある複製アイコンを選択して、条件のコピーを作成します。

順序変更条件

条件名の横にあるハンドルを使用して条件をドラッグ アンド ドロップし、条件が評価される順序を変更します。

条件の名前を変更する

条件名を選択して、インラインで編集します。

Conversation tags (会話タグ)

会話タグエレメントを使用して、進行中の会話にタグを追加します。タグは、受信トレイの会話を分類およびフィルター処理するのに役立ちます。

チャットボット エディターで、チャットボット アクション から 会話タグ エレメントをドラッグ アンド ドロップします。

前提条件

チャットボットでタグを使用する前に、受信トレイでタグを作成します。詳細については、受信トレイのドキュメントを参照してください。

エレメントの構成

会話に追加するタグを 1 つ以上選択します。

例: 正しいキューにリダイレクトする

会話タグを使用して、会話を受信トレイの正しいサポート キューにルーティングします。

1. チャットボット フローで、チャットボットがエンド ユーザーの問題タイプを決定するポイントを特定します。
2. 会話タグ エレメントを追加します。
3. 課題タイプに対応するタグを選択します。例: 請求、技術サポート、または販売。
4. タグのエレメントの後に To Agent エレメントを追加します。

会話がエージェントに転送されると、タグが受信トレイに表示され、会話を正しいキューにルーティングできます。

CSAT調査

CSAT 調査エレメントを使用して、会話の最後に顧客満足度調査をエンド ユーザーに送信します。

チャットボット エディターで、チャットボット アクション から CSAT アンケート エレメントをドラッグ アンド ドロップします。

採点問題

スコアリングスケール

アンケートの評価尺度を選択します。次のオプションを使用できます。

• 1–2 スケール: 1 = ネガティブ、2 = ポジティブ。
• 1〜5スケール:1〜3=満足なし、4〜5=満足。
• 1〜10スケール:1〜6 =満足なし、7〜10 =満足。
• 絵文字スケール: ポジティブ、ニュートラル、ネガティブ。

スコアリングの質問メッセージ

スコアリングの質問とともにエンドユーザーに送信するメッセージを入力します。例: 今日の体験をどのように評価しますか? 属性を使用してメッセージをパーソナライズできます。

リピート回数

エンドユーザーが有効な回答を提供しない場合に、採点の質問を繰り返す回数を選択します。デフォルト値は 1 です。最大3回です。

フォールバック メッセージ

すべての繰り返しが使い果たされた後、エンドユーザーが有効な応答を提供しない場合にエンドユーザーに送信するメッセージを入力します。

フィードバックの質問 (オプション)

自由形式のフォローアップの質問を追加して、エンドユーザーから書面によるフィードバックを収集します。例: *何がもっとうまくできたでしょうか?

ありがとうメッセージ(オプション)

エンドユーザーがアンケートを送信した後に送信するメッセージを入力します。例: *フィードバックありがとうございます!

次のステップ

CSAT アンケートエレメントをフローの次のエレメントまたはダイアログに接続します。

• 標準ダイアログに CSAT アンケート エレメントを追加する場合は、その後に セッションを閉じる エレメントを追加して会話を終了します。
• CSATアンケートのエレメントをセッションの有効期限ダイアログに追加した場合、追加のエレメントは必要ありません。セッションは自動的に閉じます。

ガイドラインとおすすめの方法

• CSATアンケートは、エンドユーザーの問題が解決された後、会話の最後に配置します。
• 完了率を最大化するために、アンケートを短くします。
• 調査結果を属性に保存し、分析やルーティングに使用します。

解析学

CSATアンケートの結果は、チャットボットの分析で確認できます。平均スコア、スコア分布、および個々の回答を表示できます。

結果は、高度な分析でも利用できます。

• Voice of the customer 事前定義されたダッシュボード。
• カスタムダッシュボードの CSAT 指標。

遅延

遅延エレメントを使用して、次のエレメントに進む前に、指定した時間チャットボット フローを一時停止します。これは、より自然な会話のペースをシミュレートしたい場合や、外部プロセスが完了するのを待ちたい場合に便利です。

チャットボット エディターで、チャットボット アクション から 遅延 エレメントをドラッグ アンド ドロップします。

遅延 フィールドで、遅延期間を秒単位で指定します。最小値は 1 秒です。最大値は 30 秒です。

顧客プロファイルカスタムイベント

顧客プロファイルのカスタムイベントエレメントを使用して、顧客プロファイルでカスタムイベントをトリガーします。これにより、会話中の特定のエンドユーザーのアクションや行動を追跡できます。

チャットボット エディターで、チャットボット アクション から 顧客プロファイル カスタム イベント エレメントをドラッグ アンド ドロップします。

カスタムイベントとマッピング属性の作成に関する詳細な手順については、「顧客プロファイル](/automation-studio/integrations/チャットボット-integrations/customer-profiles#custom-events)を参照してください。

Contact information (連絡先情報)

連絡先情報属性フィールドに、エンドユーザーの連絡先情報を含むチャットボット属性を入力します。例: customerContact。

連絡先情報属性タイプ フィールドで、属性タイプを選択します。これが 連絡先情報属性 フィールドで選択した属性のデータ型と一致していることを確認します。

カスタムイベント

カスタムイベント設定 セクションで、個人プロファイルに対して保存するイベントを指定します。

1. **[カスタム イベントの追加] を選択します。
2. [顧客プロファイル] で作成したイベントを選択します。
3. (オプション)属性マッピングの追加を選択して、チャットボットの属性を顧客プロファイルのイベントプロパティにマッピングします。

顧客プロファイルプロファイル

顧客プロファイルプロファイルエレメントを使用して、エンドユーザーの顧客プロファイルプロファイルを取得または更新します。

チャットボット エディターで、チャットボット アクション から 顧客プロファイル プロファイル エレメントをドラッグ アンド ドロップします。

詳細な手順については、「顧客プロファイル](/automation-studio/integrations/チャットボット-integrations/customer-profiles)を参照してください。

アクションを選択

アクションの選択 フィールドで、次のいずれかを選択します。

• 情報の取得: エンドユーザーの個人プロファイルからデータを取得します。
• ユーザープロファイルを作成または更新: 会話中に収集されたデータを個人プロファイルに保存します。

Contact information (連絡先情報)

連絡先情報属性 フィールドで、個人プロファイルの識別に使用する属性を指定します。顧客プロファイルに保存されている標準のチャネル固有の属性、またはチャットボットのカスタム属性を使用できます。デフォルトでは、この値は endUserDestination に設定されています。

マップ属性

属性マッピングの追加を選択して、チャットボットの属性を顧客プロファイルの属性にマッピングします。

属性タイプに互換性があることを確認します。サポートされている組み合わせについては、属性マッピングの表を参照してください。

顧客プロファイルタグ

顧客プロファイル タグ エレメントを使用して、エンド ユーザーの顧客プロファイル プロファイルのタグを追加、取得、または削除します。

チャットボット エディターで、チャットボット アクション から 顧客プロファイル タグ エレメントをドラッグ アンド ドロップします。

アクションを選択

アクションの選択 フィールドで、次のいずれかを選択します。

• タグの追加または作成: 既存のタグを追加するか、新しいタグを作成します。
• タグの取得: 指定したタグがプロファイルに存在するかどうかを確認します。
• タグの削除: プロファイルから 1 つ以上のタグを削除します。

Contact information (連絡先情報)

連絡先情報属性 フィールドに、エンドユーザーのプロファイルを識別する属性を入力します。

既存のタグを追加するか、新しいタグを作成します

追加するタグを選択します。既存のタグを選択するか、新しいタグ名を入力して作成できます。

タグの削除

プロファイルから削除するタグを選択します。

タグを取得する

確認するタグを入力します。このエレメントは、結果 (true/false) を指定した属性に保存し、条件エレメントで使用できます。

プロファイル更新の状態を検証する

Customer Profiles タグエレメントの後に 条件 エレメントを追加します。エレメントを次のように設定します。

• 属性フィールドで、定義済みの属性 lastCustomerProfilesStatusCode を選択します。
• 演算子を is に設定します。
• ステータス — 成功 を指定します。
• 必要に応じてチャットボット フロー分岐します。

ユーザーの応答を保存する

[ユーザー応答の保存] エレメントを使用して、エンド ユーザーの応答の特定の部分をキャプチャし、属性に保存します。

チャットボット エディターで、チャットボット アクション から ユーザー応答の保存 エレメントをドラッグ アンド ドロップします。

エレメントの使い方

エンド ユーザーの応答を取得して保存する

このエレメントは、エンドユーザーに入力を求めるエレメントの直後に使用します。「ユーザー応答の保存」エレメントは、エンド・ユーザーの返信をキャプチャーし、指定された属性に保存します。

他の要素からの応答を保存する

このエレメントを使用して、検出されたエンティティや解析された値など、エンドユーザーの応答から抽出された特定の値を保存します。

エレメントの構成

次のフィールドへの入力を完了します：

属性がすでに収集されている場合は質問をスキップ

このオプションを有効にすると、属性にすでに値がある場合にエレメントをスキップします。これにより、チャットボットがすでに収集されている情報を要求するのを防ぎます。

メッセージ

応答を要求するエンドユーザーに送信するメッセージを入力します。属性を使用して、メッセージをパーソナライズできます。メッセージのバリエーションを追加することもできます — エンドユーザーはランダムに 1 つのバリエーションを受け取ります。

回答に名前を付けて保存

エンドユーザーの応答を保存する属性を選択します。既存の属性を選択することも、新しい属性を作成することもできます。

カスタム検証を有効にする

このオプションを有効にすると、保存する前にエンドユーザーの応答が検証されます。正規表現を使用するか、電子メール、電話番号、URL などの事前定義された形式を選択して、検証ルールを指定します。

メッセージを繰り返す

エンドユーザーが有効な応答を提供しない場合にメッセージを繰り返す回数を選択します。デフォルトは 繰り返しなし です。最大3回です。

フォールバック

すべての繰り返しが使い果たされた後、エンドユーザーが有効な応答を提供しない場合に実行するフォールバックアクションを設定します。フォールバックのドキュメントを参照してください。

リンクプレビュー(オプション)

リンクプレビューを有効にすると、チャットボットがリンクを含むメッセージを送信したときにURLのプレビューが表示されます。WhatsAppで利用可能。

タイムアウト

エンドユーザーが応答するまでチャットボットが待機する時間を指定します。タイムアウト期間内に応答がない場合、チャットボットはフォールバックアクションを実行します。タイムアウトドキュメントを参照してください。

エージェントへ

[エージェント宛先] エレメントを使用して、受信トレイの人間のエージェントに会話を転送します。

チャットボット エディターで、チャットボット アクション から エージェントへ エレメントをドラッグ アンド ドロップします。

次のフィールドへの入力を完了します：

• キュー (オプション): 会話の転送先のエージェント キューを選択します。
• メッセージ (オプション): 転送前にエンド ユーザーに送信するメッセージ。

タグ

エージェントに転送する前に、会話にタグを追加します。タグは、サポート リクエストを受信トレイの適切なキューにルーティングするのに役立ちます。

タグの作成

タグは、チャットボットで使用する前に、受信トレイで作成する必要があります。詳細については、受信トレイのドキュメントを参照してください。

会話にタグを追加する

エージェントへ エレメントの タグ セクションで、会話に追加するタグを 1 つ以上選択します。

エージェント転送の詳細については、「受信トレイ](/automation-studio/integrations/チャットボット-integrations/受信トレイ)を参照してください。

ダイアログへ

[宛先] ダイアログ エレメントを使用して、チャットボット フローを別のダイアログにリダイレクトします。

チャットボットエディターで、チャットボットアクションからダイアログへエレメントをドラッグアンドドロップします。

[ダイアログ] フィールドで、移動するダイアログを選択します。既存のダイアログを選択することも、新しいダイアログを作成することもできます。

属性の共有

別のダイアログにリダイレクトするときに転送する属性を選択できます。属性の共有 オプションを使用して、属性セレクターを有効にし、ターゲット ダイアログに渡す属性を選択します。

ユーザーの処置

ユーザー応答エレメントを使用して、エンド・ユーザーからの入力をキャプチャーし、属性に保存します。チャットボットは、エンドユーザーが応答するのを待ってから続行します。

チャットボット エディターで、チャットボットが受信する の ユーザー応答 エレメントをドラッグ アンド ドロップします。

エレメントの構成

キーワード

キーワードを使用して、エンドユーザーが提供できる有効な応答を定義します。

キーワードを追加する

キーワードの追加 を選択して、キーワードまたは語句を追加します。エンドユーザーがキーワードに一致するメッセージを送信すると、チャットボットは応答を保存して続行します。

キーワードを並べ替える

キーワードの横のハンドルを使用してキーワードをドラッグ アンド ドロップし、評価される順序を変更します。

自然言語処理

自然言語処理 (NLP) を有効にして、チャットボットが完全一致を要求するのではなく、構成されたキーワードと意味が類似した応答を理解できるようにします。

メッセージを繰り返す

エンドユーザーが有効な応答を提供しない場合にメッセージを繰り返す回数を選択します。デフォルトは 繰り返しなし です。最大3回です。

フォールバック

すべての繰り返しが使い果たされた後、エンドユーザーが有効な応答を提供しない場合に実行するフォールバックアクションを設定します。フォールバックのドキュメントを参照してください。

タイムアウト

エンドユーザーが応答するまでチャットボットが待機する時間を指定します。タイムアウト期間内に応答がない場合、チャットボットはフォールバックアクションを実行します。最小は 15 秒です。最大は 14400 秒 (240 分) です。タイムアウトドキュメントを参照してください。

Webhook (英語)

Webhook エレメントを使用して、チャットボットがフロー内のこのエレメントに到達したときに外部システムにデータを送信します。

チャットボット エディターで、チャットボット アクション から Webhook エレメントをドラッグ アンド ドロップします。

エレメントの構成

次のフィールドへの入力を完了します：

• Webhook URL タイプ: Webhook URL を 静的 (毎回同じ URL が使用される) か **動的 ** (URL が実行時に属性から構築される) にするかを選択します。
• URL: Webhook URL。動的を選択した場合は、URL を含む属性を入力します。
• セッションID本文パラメータ名(選択):チャットボットセッションIDの送信先の本文パラメータの名前を入力します。これを使用して、Webhookリクエストをチャットボットセッションと関連付けます。
• 方法: HTTP メソッドを選択します。サポートされているメソッドは POST と PUT です。
• ヘッダー (省略可能): リクエストヘッダーを追加します。
• 本文 (省略可能): 要求本文。属性を使用して、ボディをパーソナライズできます。

Webhook 要求コード

Webhook は、要求に応答して HTTP ステータス コードを返します。Webhook エレメントの後に 条件 エレメントを使用して、応答コードに基づいてチャットボット フローを分岐します。

「応答」タブの「応答コードを属性に保存」オプションを使用して、応答コードを属性に保存し、「条件」エレメントで評価します。

一般的な応答コード:

• 2xx: 要求は成功しました。
• 4xx: クライアント エラーにより要求が失敗しました。
• 5xx: サーバー エラーのため、要求が失敗しました。

スループットの制限

各エンドポイントの最大スループットは 100 リクエスト/秒です。IP アドレスあたりの各エンドポイントの最大スループットは、毎秒 50 リクエストです。

Webhook エレメントの使用例

Webhook エレメントを使用して、エンドユーザーがチャットボットを介して購入を完了したときに外部 CRM システムに通知します。

1. 購入フローの最後に、Webhook エレメントを追加します。
2. CRM エンドポイントを指すように URL を構成します。
3. 本文には、エンドユーザーの連絡先情報や注文の詳細などの関連属性を含めます。
4. Webhook の後に 条件 エレメントを追加して、応答コードを確認し、それに応じてフローを分岐します。