ボットビルダーのカスタムAPI統合

API閉じた APIを使用すると、組織が使用する他のソフトウェアとCXoneシステムを接続することにより、特定の機能を自動化できます。でカスタムスクリプトを使用してカスタムボット応答アクションを作成することで、カスタム統合。これにより、ボットで独自のデータベースまたはサードパーティーのアプリケーションを使用できるようになります。 カスタム統合を設定することで、ボットビルダーと統合先のWebサービスを接続できます。

統合を設定したら、1つ以上のボットアクションを作成する必要があります。これにより、統合されたWebサービスに送信されるリクエストを定義できます。ダイアログ閉じた ボットビルダーのボットの話およびルール。でこれらのボットアクションを使用すると、会話の特定の時点でボットがWebサービスにリクエストを送信できます。

APIタブの[新しい統合]ページでは、認証を設定したりアクションを作成したりできます。

新しいAPI統合を作成する

接続するWebサービスごとに1つの統合を作成するだけで済みます。

  1. CXoneで、アプリセレクターをクリックして、選択しますボットビルダー。

  2. 作業したいボットをクリックします。
  3. 左側のアイコンメニューで連携プラグのように見えるアイコン。をクリックします。
  4. [API]タブで、新しい統合をクリックします。
  5. デフォルトの新しい統合タイトルをクリックして統合の名前を変更し、Enterキーを押して変更を保存します。
  6. [認証]で、認証方法を選択します。選択したタイプに必須情報を入力します。
    フィールド詳細
    パブリック

    API統合では認証は必要ありません。追加の手順は必要ありません。

    作成するすべてのアクションについて、JSONに認証ラインを追加できます。

    OAuth 2.0

    認証URL、キー、およびシークレットフィールドに入力します。スコープの詳細はオプションです。スコープを使用すると、アクセストークンに付与されるアクセスの量を制限できます。ボットビルダークライアント認証情報付与タイプOAuth2.0を使用します。

    この情報は、統合するWebサービスのアカウントで確認できます。

    カスタム

    JSONリクエストエディターで、ヘッダーセクションに認証用の行を追加し、使用する認証方法を入力します。ベーシック認証、JSON Web Token、Simple Web Token、または Bearer Tokenを使用できます。

    {
  "headers": {
  "Content-Type": "application/json",
  "Authorization": "[authentication_type] [token]"
  }
}
  7. 統合に1つ以上のアクションを追加します。
  8. 変更が完了したら、トレーニングとステージをクリックしてボットモデル閉じた トレーニングおよびステージングされたボットのバージョンを更新します。

  9. アクションをストーリー閉じた インテントとコンテキストに基づいた対話の処理のためにボットをトレーニングするために使用されます、ルール閉じた コンテキストによって変化しないメッセージに対するボットの応答を定義するために使用されます。、またはフォールバック閉じた 宛先がリッチメディアをサポートしない場合に送信される代替のプレーンテキスト。に追加します。ボットアクションオプションAPIのAPIセクションには、設定して有効にしたすべてのAPI統合アクションが表示されます。

    一般、フォーム、APIまたはスクリプトのタブからボットの応答を選択するウィンドウ。

統合のカスタムボットアクションを作成する

API統合には少なくとも1つのカスタムボットアクションが必要です。カスタムボットアクションを作成して有効にすると、ダイアログ閉じた 対話の終了後にエージェントが作業要件を完了できるようにする状態を操作するときにボット応答でそのアクションを使用できるようになります。

  1. CXoneで、アプリセレクターをクリックして、選択しますボットビルダー。

  2. 作業したいボットをクリックします。
  3. 左側のアイコンメニューで連携プラグのように見えるアイコン。をクリックします。
  4. 操作するインテント>インテントフォルダーを選択するか、新しいインテントフォルダーを作成します。
  5. アクションで、新しいアクションをクリックします。
  6. アクションの名前を入力し、Enterキーを押します。
  7. アクションをクリックして構成します。
  8. [設定]の[JSONをリクエスト]ウィンドウに設定を書き込みます。スロット値は、形式{{slot_name}}で変数として使用できます。テスト目的でmockSlotsパラメーターを使用できます。
  9. テストリクエストをクリックして、応答ウィンドウにデータを入力します。
  10. [エラー処理]のエラーメッセージフィールドを使用して、APIリクエストの失敗を受けてコンタクトに表示する内容を指定できます。
  11. デバッグモードチェックボックスを選択して、エラーメッセージにサフィックス応答を追加できます。
  12. アクションをボットで使用する準備ができたら、アクション設定ページの上部にあるアクショントグルクリックすると左右に動く、内部に円がある長い楕円。をクリックします。トグルがオフの場合、アクションは使用できません。

  13. 変更が完了したら、トレーニングとステージをクリックしてボットモデル閉じた トレーニングおよびステージングされたボットのバージョンを更新します。

ボットスキルにカスタムAPI統合を追加する

カスタムAPI統合を1つ以上のボットスキルに追加できます。これにより、統合を追加したスキルで統合のボットアクションを使用できるようになります。

  1. CXoneで、アプリセレクターをクリックして、選択しますボットビルダー。

  2. 作業したいボットをクリックします。
  3. 左側のアイコンメニューで連携プラグのように見えるアイコン。をクリックします。
  4. [API]タブで、操作する統合の上にカーソルを置きます。
  5. 省略記号3つのドットが並んだアイコン。をクリックし、スキルに追加を選択します。
  6. 1つまたは複数のスキルをクリックし、すべて選択をクリックして、利用可能なすべてのスキルに統合を追加します。
  7. 必要なスキルが利用できない場合は、検索バーに名前を入力し、スキルを作成をクリックします。