接続の管理

このページのコンテンツは、制御リリース（CR）の製品または機能用です。CRグループに所属しておらず、詳細情報が必要な場合は、CXoneアカウント担当者にお問い合わせください。

Integration Hub接続を使用すると、CXoneで使用するサードパーティのWebサービスへの統合を設定できます。

接続テンプレートの作成

接続テンプレートは、統合に関する基本情報を定義します。テンプレートは接続を作成するために使用され、特定のリクエストやその他の情報を設定できます。

接続テンプレートは作成後に変更することはできません。ヘッダーなどの詳細を変更する必要がある場合は、新しいテンプレートを作成する必要があります。

Integration Hubの[テンプレートの追加]ページのスクリーンショット
  1. CXoneで、アプリセレクターをクリックして、選択しますオートメーションとAI > Integration Hub.
  2. [テンプレートを追加]をクリックします。
  3. [詳細]タブで、テンプレートの名前を入力します。
  4. 接続するアプリケーションの名前を入力します。これは、アプリケーション、プラットフォーム、またはWebサービスである可能性があります。
  5. 統合方法としてRESTを選択します。現在、サポートされている方法はRESTのみです。

  6. 認証タイプのオプションを選択します。

    オプション 詳細
    OAuth 2.0 テンプレートにOAuth2.0認証を含める場合は、このオプションを選択します。現在、これが唯一サポートされている認証タイプです。
    認証なし テンプレートに認証を含めない場合は、このオプションを選択します。
  7. テンプレートの説明を入力します。他のユーザーは、接続ライブラリからこのテンプレートを選択するとそれを表示できます。
  8. 画像をドラッグアンドドロップするか、ファイルを閲覧をクリックしてアイコンをアタッチします。このアイコンは、接続ライブラリ内のこのテンプレートで表示され、このテンプレートから作成されたすべての[マイ接続]の下に表示されます。
  9. [設定]タブで、このテンプレートで使用できるようにするメソッド(動詞)を選択します。すべてのWebサービスがすべてのREST動詞をサポートしているわけではありません。
  10. このテンプレートのカスタム認証ヘッダーを定義するには、カスタムヘッダーを追加をクリックします。このオプションは、テンプレートで認証を有効にした場合にのみ使用できます。ヘッダーを定義するには:
    1. 表示されるフィールドにヘッダー名を入力します。
    2. さらにカスタムヘッダーを追加するには、カスタムヘッダーを追加をクリックします。
    3. 必須?を選択します。このテンプレートから作成された接続で使用する必要のあるヘッダーには。
    4. ヘッダーを削除するには、Xをクリックします。
  11. すべての設定を再確認してください。テンプレートを保存した後は編集できません。
  12. 次のいずれかを実行します。
    • 保存をクリックして、テンプレートを接続ライブラリに追加します。
    • 接続 + マイ接続を保存をクリックして、テンプレートを接続ライブラリに追加し、そこから接続を作成します。接続が作成されたら、認証の詳細、シークレット、またはリクエストを追加して接続を設定できます。リクエストには、これらの設定の一部またはすべてを含めることができます。

テンプレートから接続を作成する

接続を使用すると、リクエストを作成し、認証の詳細を追加できます。接続はIntegration Hubの[マイ接続]の下に表示されます。

接続テンプレートから接続を作成します。接続ライブラリには、CXoneシステム内に存在するすべての接続テンプレートが表示されます。必要な作業に一致するテンプレートがない場合は、テンプレートを作成できます。

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

  2. 接続ライブラリでテンプレートを見つけます。ライブラリはページの右側にあります。接続またはテンプレートを表示している場合は、ページの右上隅にあるXをクリックします。これにより閉じられ、接続ライブラリが表示されます。

  3. テンプレートのプロパティページでマイ接続をクリックして、テンプレートに基づいて接続を作成します。

  4. mTLS自己署名証明書を使用している場合は、次のフィールドに入力します。

    • クライアント証明書
    • クライアントの秘密鍵
    • キーパスフレーズ

    これらのフィールドは、認証タイプとしてOAuth2.0を使用する場合にのみ表示されます。クライアント証明書とクライアントの秘密鍵を一緒に入力する必要があります。クライアントの秘密鍵が暗号化されている場合は、キーパスフレーズを入力する必要があります。mTLS証明書は、認証URLがHTTPSである場合にのみ機能します。これらのフィールドの検証は、接続が保存された後に行われます。これらのフィールドはシークレットタブで参照できます。

  5. 接続の名前を入力し、保存をクリックします。

  6. ページの左側にあるリストで新しい接続をクリックします。

  7. [設定]タブで、タイムアウトをミリ秒単位で設定します。タイムアウトは、認証を含む、接続で設定されたすべてのリクエストに適用されます。

  8. 必要に応じて認証とリクエストを設定します。接続には、どちらか一方、または両方を含めることができます。

  9. 接続で使用するために暗号化する情報がある場合は、シークレットを設定します。

認証の詳細の設定

接続の[認証]タブで認証の詳細を設定できます。このタブは、この接続に使用されるテンプレートで認証が有効になっている場合にのみ表示されます。

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

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

  3. [認証]タブで、認証リクエストに使用するURLを入力します。URLはダイナミックにすることはできませんが、URL内のシークレットを参照することはできます。

  4. 認証リクエストで使用するRESTメソッド(動詞)を選択します。使用可能な動詞は、この接続に使用するテンプレートによって定義されます。

  5. ヘッダーの下で、各フィールドに適切な値を入力します。アスタリスク(*)の付いたフィールドは必須です。これらのフィールドは、この接続に使用されるテンプレートで定義します。

  6. この接続にカスタムヘッダーを追加するには:

    1. カスタムヘッダーの追加をクリックします。

    2. ヘッダー名とヘッダー値を入力します。

  7. 認証リクエストにクエリパラメーターを追加するには:
    1. クエリパラメーターを追加をクリックします。
    2. 追加するクエリパラメーターごとに、クエリパラメーター名とクエリパラメーター値を入力します。

  8. メディアタイプを選択し、本文の内容を入力します。メディアタイプは本文コンテンツの形式に影響します。Webサービスに必要なタイプと一致する必要があります。

    オプション 詳細

    ApplicationJson

    本文コンテンツは、application/json をコンテンツヘッダーとするJSON。
    ApplicationJsonPatch 本文コンテンツは、application/json-patch+json をコンテンツヘッダーである必要があります。
    FormURLEncoded

    本文コンテンツは、application/x-www-form-urlencoded をコンテンツヘッダーである必要があります。このメディアタイプにより、一般的なURL表記を使って申請を送ります。

    +フォームパラメーターから追加をクリックし、フォームパラメーター名とフォームパラメーター値を入力します。
    TextHtml 本文コンテンツは、text/html をコンテンツヘッダーとするHTML。
    TextPlain 本文コンテンツは、text/plain をコンテンツヘッダーで記述する必要があります。
    TextXml 本文コンテンツは、text/xml をコンテンツヘッダーとするXML。

  9. 保存をクリックします。

接続にシークレットを追加する

Integration Hub シークレットを使用すると、接続時に特定の情報を暗号化することができます。これにより、Studioスクリプトでパスワードなどの機密情報を使用する場合に、セキュリティがさらに強化されます。

シークレットは元に戻せません。シークレット値フィールドから離れてクリックすると、コンテンツは暗号化され、マスキングアスタリスク(*)に置き換えられます。マスクされた後はフィールドに入力した値を取得する方法はありません。

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

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

  3. [シークレット]タブで、シークレットを追加をクリックします。

  4. シークレットに含まれる内容を識別するシークレット名を入力します。接続でシークレットを使用する場合、名前は変数のように使用されます。名前にはスペースや特殊文字を含めることができます。

  5. シークレット値を入力します。これは暗号化される情報です。このフィールドからクリックして離れる前に、情報が正しいことを確認してください。

  6. 保存をクリックします。

接続でシークレットを使用する

シークレットは変数のように使われます。保持されている値の代わりに、シークレットのフォーマットされた名前を入力します。接続を使用すると、システムはシークレット名を暗号化された値に置き換えます。

シークレットはマニュアルまたはStudioリクエストで使用できます。認証の詳細では、ヘッダー、クエリパラメーター、本文コンテンツでシークレットを使用できます。

認証の詳細または手動リクエストでシークレットを使用する

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

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

  3. シークレットを使用するタブをクリックします。シークレットは、認証タブとリクエストタブで使用できます。

  4. 次のガイドラインに従って、シークレット値を入力したい場所にシークレットを入力します。

    • 名前を二重括弧で囲みます。たとえば、[[ secretName ]]。
    • [シークレット]タブのシークレット名フィールドに入力したとおりの名前を使用します。
    • シークレットは、それが作成された接続でのみ使用できます。

Studioリクエストでシークレットを使用する

Studioスクリプトでシークレットを使用するには、スクリプトにCONNECTAuthまたはCONNECTREQUESTアクションが必要です。アクションは、スクリプトをシークレットを含む接続にリンクする必要があります。

  1. Studioで、シークレットを使用するスクリプトを開きます。

  2. シークレットを追加するSnippetアクションをダブルクリックします。

  3. Snippetエディターウィンドウで、次のガイドラインに従って、シークレット値を使用する場所にシークレットを追加します。

    • 名前を二重括弧で囲みます。たとえば、[[ secretName ]]。
    • [シークレット]タブのシークレット名フィールドに入力したとおりの名前を使用します。
    • 括弧とシークレット名を二重引用符( " )で囲みます。たとえば、"[[ secretName ]]"です。シークレットがURLなどの文字列の一部である場合は、シークレットだけでなく文字列全体を二重引用符で囲む必要があります。たとえば、"[[ secretName ]]/location/anotherlocation/"。
    • シークレットは、それが作成された接続でのみ使用できます。接続は、CONNECTAuthまたはCONNECTREQUESTアクションを使用してスクリプトで指定する必要があります。

    例：

    • ASSIGN requestPayload.body = "[[client_id]]"

    • ASSIGN URL = "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS"

手動リクエストを作成する

リクエストは、統合が接続するWebサービスから必要な情報を取得する方法です。Studioスクリプト内で手動リクエストを使用したり、Integration Hubから実行したりできます。

リクエストにURL、ヘッダー、またはパラメーター内のパスパラメーターまたは変数置換が必要な場合は、Studioリクエストを作成する必要があります。手動リクエストではこれらのオプションはサポートされません。

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

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

  3. [リクエスト]タブで、リクエストを追加をクリックします。

  4. リクエスト名を入力します。

  5. トリガーとして手動を選択します。

  6. このリクエストのURLを入力します。

  7. このリクエストのメソッド(動詞)をクリックします。

  8. [ヘッダー]で、リクエストに必要なヘッダーを追加します。

    1. ヘッダーを追加をクリックします。

    2. ヘッダー名とヘッダー値を入力します。

  9. [クエリパラメーター]で、リクエストに必要なクエリパラメーターを追加します:
    1. クエリパラメーターを追加をクリックします。
    2. クエリパラメーター名とクエリパラメーター値を入力します。

  10. メディアタイプを選択し、本文の内容を入力します。メディアタイプは本文コンテンツの形式に影響します。に接続するWebサービスに必要なタイプと一致する必要があります。

    オプション 詳細

    ApplicationJson

    本文コンテンツは、application/json をコンテンツヘッダーとするJSON形式である必要があります。
    ApplicationJsonPatch 本文コンテンツは、application/json-patch+json をコンテンツヘッダーとするJSON Patch形式である必要があります。
    FormURLEncoded

    本文コンテンツは、application/x-www-form-urlencoded をコンテンツヘッダーとするキー/値のペアである必要があります。このメディアタイプにより、一般的なURL表記を使って申請を送ります。

    +フォームパラメーターから追加をクリックし、フォームパラメーター名とフォームパラメーター値を入力します。
    TextHtml 本文コンテンツは、text/html をコンテンツヘッダーとするHTML形式である必要があります。
    TextPlain 本文コンテンツは、text/plain をコンテンツヘッダーとするプレーンテキストで記述する必要があります。
    TextXml 本文コンテンツは、text/xml をコンテンツヘッダーとするXML形式である必要があります。
  11. このリクエストのアクティブステータスを変更する場合は、ページの上部にあるアクティブをクリックします。テキストが非アクティブに変わります。
  12. クリック確認。
  13. [リクエスト]タブで、追加したリクエストのテストをクリックします。Integration Hubがリクエストを試行します。ウィンドウが表示され、テストの結果が表示されます。
  14. 編集をクリックしてリクエストを変更するか、保存をクリックします。

Studioリクエストを作成する

Studioリクエストは、Integration Hubでは作成できないが、認証やシークレットでIntegration Hubを使用できるようにしたい APIリクエストがある場合に役立ちます。

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

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

  3. [リクエスト]タブで、リクエストを追加をクリックします。

  4. リクエスト名を入力します。

  5. トリガーとしてStudioを選択します。

  6. サンプルを使用してスクリプトでJSONを構築する場合は、[リクエストを追加]ページからサンプルのリクエストペイロードを選択してコピーします。

  7. クリック確認。

    StudioリクエストはIntegration Hubからテストできません。トレースを使用してスクリプトを実行してStudioでテストする必要があります。

  8. 保存をクリックします。
  9. Studioを起動してログインします。
  10. 既存のスクリプトを開くか、新しいスクリプトを作成します。
  11. スクリプトにSnippet アクションを追加し、それをダブルクリックしてSnippetエディターウィンドウを開きます。

  12. Snippetエディターウィンドウでダイナミックオブジェクトを構築し、JSONに変換します。作成するオブジェクトには、リクエストに必要なヘッダー、クエリパラメーター、および本文コンテンツを保持するメンバーが含まれている必要があります。

    オブジェクトを作成するときは、前の手順でIntegration Hubからコピーしたサンプルのペイロードをガイドとして使用します。ペイロードの例:

    {
 "URL": "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS",
 "HTTPMETHOD": "POST",
 "HEADERS": {
	"CONTENT-TYPE": "APPLICATION/JSON",
	"AUTHORIZATION": "BEARER[[BEARERTOKEN]]"
	},
 "QUERYPARAMETERS": {
	"ANI": "[[ANI]]",
	"ACCOUNTID": "123456"
	},
 "BODY": {
	"ANI": "[[ANI]]",
	"ACCOUNTID": "123456",
	"ACCOUNTNAME": "TESTACCOUNT"
	}
}

    サンプルのペイロードをガイドとして使用して作成されたダイナミックオブジェクトは次のとおりです:

    DYNAMIC requestPayload 
ASSIGN requestPayload.URL = "[[INSTANCEURI]]/INCONTACTAPI/SERBICES/V26.0/AGENTS"
ASSIGN requestPayload.HTTPMETHOD = "POST"
ASSIGN requestPayload.HEADERS.CONTENTHYPHENPLACEHOLDERTYPE = "APPLICATION/JSON"
ASSIGN requestPayload.HEADERS.AUTHORIZATION = "BEARER[[BEARERTOKEN]]"
ASSIGN requestPayload.QUERYPARAMETERS.ANI = "[[ANI]]"
ASSIGN requestPayload.QUERYPARAMETERS.ACCOUNTID = "123456"
ASSIGN requestPayload.BODY.ANI = "[[ANI]]"
ASSIGN requestPayload.BODY.ACCOUNTID = "123456"
ASSIGN requestPayload.BODY.ACCOUNTNAME = "TESTACCOUNT"
ASSIGN requestPayloadJSON = requestPayload.asjson()
ASSIGN requestPayloadJSON = requestPayloadJSON.replace("HYPHENPLACEHOLDER", "-")

    前の例の最後の行では、replace() 関数を使用してハイフン(-)文字をCONTENT-TYPEキー名に挿入しています。Studioでは、変数名にハイフンなどの特殊文字を含めることはできないため、このアプローチは回避策として使用されます。

  13. リクエストを使用するようにスクリプトを設定します。

リクエストの状態を変更する

各Integration Hub接続には最大50件のリクエストを含めることができます。一度にアクティブにできるリクエストの数に制限はありません。リクエストはデフォルトでアクティブです。

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

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

  3. [リクエスト]タブで、操作するリクエストをクリックします。

  4. 状態を変更するには、ページの上部にある非アクティブまたはアクティブをクリックします。