接続の使用

Integration Hubでは、接続によって認証の詳細とAPIリクエストが定義されます。 接続を作成して設定したら、CXoneで使用できるようになります。

Integration Hubのリクエストの実行

定義されているIntegration Hub接続からリクエストを実行できます。 Integration Hubからは手動リクエストのみが実行できます。

    CXoneで、アプリセレクターをクリックし、選択します：オートメーションとAI > Integration Hub.

  1. ページの左側にある[マイ接続]から、操作する接続をクリックします。

  2. [リクエスト]タブで、実行するリクエストの横にあるテストをクリックします。 ページがポップアップ表示され、接続されたWebサービスからの応答が表示されます。

  3. 応答の内容を保存する場合は、ページから応答を選択してコピーします。

  4. 応答の確認が完了したら、キャンセルをクリックします。

スクリプトで認証を使用する

接続では認証の詳細を保存できます。 スクリプト内の必要な場所で使用できます。 これらは単独でも、リクエストと一緒に使用することもできます。

  1. Studioを開いてログインします。

  2. リクエストを追加するスクリプトを開きます。

  3. スクリプトにConnectAuth アクションを追加します。

  4. ConnectAuthのconnectNameプロパティに、使用する接続の名前を入力します。 接続名がわからない場合：

    1. ConnectAuthをダブルクリックしてIntegration Hubを開きます。
    2. [マイ接続]で、使用する接続の横にあるチェックマークチェックマークのアイコン。をクリックします。
    3. アクションに割り当てるには、はいをクリックします。

    connectNameプロパティで特定の接続の名前を使用する代わりに、変数置換を使用できます。 接続名を保持する変数を作成し、スクリプトロジックを使用してその名前をConnectAuthに渡します。

スクリプトで手動リクエストを使用する

API呼び出しを行う必要があるスクリプト内の任意の場所で手動リクエストを使用できます。 リクエストはIntegration Hub接続で定義する必要があります。

リクエストが接続するリソースから返される応答に対応するには、スクリプトをさらに編集する必要がある場合があります。 さらに、ConnectRequest アクションには追加の設定が必要になる場合があります。

  1. Studioを開いてログインします。

  2. リクエストを使用するスクリプトを開きます。

  3. スクリプトにConnectRequest アクションを追加します。

  4. connectNameおよびrequestNameプロパティに、使用する接続とリクエストの名前を入力します。 名前がわからない場合：

    1. ConnectRequestをダブルクリックしてIntegration Hubを開きます。

    2. [マイ接続]で、使用する接続の横にあるチェックマークチェックマークのアイコン。をクリックします。

    3. アクションに割り当てるには、はいをクリックします。

    4. ConnectRequestに割り当てた接続を選択します。

    5. リクエストタブで、このアクションに割り当てるリクエストのボックスをクリックし、OKをクリックします。

    connectNameおよびrequestNameプロパティで特定の接続とリクエストの名前を使用する代わりに、変数置換を使用できます。 名前を保持する変数を作成し、スクリプトロジックを使用して名前をConnectRequestに渡します。

  5. スクリプト内でリンクされた接続から変数を使用するには、変数名を二重括弧([[ ]])で囲みます。

スクリプトでStudioリクエストを使用する

Studio リクエストは最初にIntegration Hub接続に追加され、次にConnectRequest アクションを通じてスクリプトに追加されます。 リクエストの詳細はStudioからの入力によって変更される可能性があるため、それらの詳細はSNIPPETアクションに組み込まれ、ConnectRequestアクションに渡すことができます。

リクエストが接続するリソースから返される応答に対応するには、スクリプトをさらに編集する必要がある場合があります。 さらに、ConnectRequestアクションまたはSnippet アクションには追加の設定が必要になる場合があります。

  1. まだ行っていない場合は、Integration HubでStudioリクエストを作成し、スクリプト内にリクエストオブジェクトを構築します。

  2. Studioで、使用するリクエストが含まれているスクリプトを開きます。
  3. リクエストオブジェクトを保持するSnippetアクションの後にスクリプトにConnectRequest アクションを追加し、それらを接続します。

  4. ConnectRequestのconnectNameプロパティに、使用する接続の名前を入力します。 名前がわからない場合：

    1. ConnectRequestをダブルクリックしてIntegration Hubを開きます。

    2. [マイ接続]で、使用する接続の横にあるチェックマークチェックマークのアイコン。をクリックします。

    3. アクションに割り当てるには、はいをクリックします。

    4. ConnectRequestに割り当てた接続を選択します。

    5. [リクエスト]タブで、このアクションに割り当てるリクエストのボックスをクリックし、OKをクリックします。

    connectNameプロパティで特定の接続とリクエストの名前を使用する代わりに、変数置換を使用できます。 名前を保持する変数を作成し、スクリプトロジックを使用して名前をConnectRequestに渡します。

  5. ConnectRequestアクションを選択し、JSONリクエストを保持する変数の名前を使用してRequestPayloadフィールドを設定します。 お客様はこの変数をSnippetで定義しました。

  6. スクリプト内でリンクされた接続から変数を使用するには、変数名を二重括弧([[ ]])で囲みます。

  7. 接続に認証が必要な場合は、スクリプトにConnectAuthアクションを追加して設定します。