シリーズ: Web サービス データ ディップ コネクターでの Bridge アクション

Web サービス データ ディップ コネクターに Bridge アクションを追加


CRM またはサードパーティ システムから情報を取得するコネクター グループを指定するには、コール フローに Bridge アクションを追加します。 Bridge アクションはデフォルトのコネクター アクションまたはカスタムのコネクター アクションのいずれかに関連付けられています。デフォルトのコネクター アクションを使用して、アカウント、ケース、連絡先についての情報を取得します。または、カスタムのコネクター アクションを使用して、CustomAction を選択し、エンドポイントを設定し、リクエスト・レスポンス スキーマを追加することで、情報を扱えます。次に、こういった Bridge アクションを使用して、Architect のコールフロー内でのルーティングを決定します。

要件: コネクターを追加します。Bridge アクションを追加する場合は、Bridge アクションとこのコネクターを関連付けます。

  1. 管理をクリックします。
  2. Under Integrations, click Bridge.
  3. Click the Actions tab.
  4. クリックします。 アクションを追加します。.

ダイアログボックスが表示されます。

ダイアログ ボックスで、以下の手順を実行します。

  1. コネクター グループ、例えば、WebServicesDataDipConnector を選択します。 

    コネクター グループのこのリストは、Bridge ページの[コネクター]タブのコネクターの名前と一致します。このリストのコネクター グループを選択することで、コネクター アクションをコネクターに関連付けます。 

  2. Select a default or custom connector action that you want the connector group to use.

    デフォルトのコネクター アクションは Web サービスを使用して、アカウント、ケース、連絡先についての情報をサードパーティ システムから取得します。カスタムのコネクター アクションでは、Web サービスを使用して、サードパーティ システムの情報を扱うリクエスト・レスポンス スキーマを作成できます。

    The example uses the default connector action GetAccountByPhoneNumber.
  3. [次へ] をクリックします。

Web サービス データ ディップ コネクターの [新規 Bridge アクションの追加] ウィンドウのスクリーンショット

別のダイアログボックスが表示されます。

ダイアログ ボックスで、以下の手順を実行します。

  1. アクションの名前を追加します。

    名前はスペースや特殊文字があってはいけませんが、ハイフンやアンダースコアを含むことはできます。 

  2. 説明を入力します(任意選択)。
  3. Add a category (optional).

    カテゴリは、関連ブリッジ アクションのグループの名前です。 Architectの呼び出しのフローを作成すると、カテゴリは特定のグループの一部であるブリッジ アクションを見つけることを助けることができます。

    まず PureCloud のブリッジ アクションにカテゴリを割り当てます。 Architectで特定のブリッジ アクションをコール フローに追加するときはブリッジ アクションの一部であるカテゴリ名でArchitect検索します。

    たとえば、カテゴリ名サポート組織のためのアカウント情報を検索すべてのブリッジ操作をグループ化する SupportAccountLookup を作成できます。 

  4. [ヘルプ]ページのリンクを追加します(任意選択)。

    このテキスト ボックスを使用して、ブリッジ アクションについて内部サポート ドキュメントへのリンクできます。

  5. 推奨されるタイムアウトを追加します(任意選択)。

    デフォルトの 5 秒(5000 ms)のタイムアウトの場合は、このテキストボックスを空白のままにします。

  6. [メタデータのフラット化]を選択します。

    このボックスを選択します。そうしないと Architect では Bridge アクションが使用できません。

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

Web サービス データ ディップ コネクターの [新規 Bridge アクションの追加] ウィンドウのスクリーンショット

保存したブリッジ アクションのアクションの詳細ページが表示されます。

カスタム コネクター アクションを使用する Bridge アクションには、デフォルトのリクエスト・レスポンス スキーマを変更します。スキーマにより、Web サービスに要求し受信する情報を指定できます。 

キー
$schema 変更できません。デフォルト: “http://json-schema.org/draft-04/schema#”.
title Schema title
description Schema description
type 変更できません。デフォルト: “object”.
properties

The names of the objects of the properties (Code in the example Request Schema) appear under Inputs in your call flow in Architect.

警告! ネストされたオブジェクトは使用しないでください。ネストされたオブジェクトを含むスキーマは正しくフラット化されません。

{object} Property object
type Object type. Supports all JSON types, except object, null, and nested arrays.
description Object description
additionalProperties 変更できません。デフォルト: true。

メモ:コネクターは有効な JSON スキーマのみと動作し、スキーマに対してリクエスト・レスポンス ボディを検証しません。 

以下の例は、コード (文字列) が懸賞に当たったかどうかをチェックするスキーマです。 

リクエスト スキーマ

{ "$schema": "http://json-schema.org/draft-04/schema#", "title":"Code Request Schema", "description":"Schema to send a code for evaluation", "type": "object", "properties": { "Code": { "type": "string", "description":"Your entry code" } }, "additionalProperties": true } 

レスポンス スキーマ

{ "$schema": "http://json-schema.org/draft-04/schema#", "title":"Code Status Response Schema", "description":"The schema for the results of the code evaluation", "type": "object", "properties": { "status": { "type": "string", "description":"The status of your code" }, "prize": { "type": "string", "description":"The prize won, if any" } }, "additionalProperties": true } 

デフォルトのリクエスト・レスポンス スキーマを変更したら、スキーマが正しくフラット化されるかどうかをチェックします。[メタデータのフラット化] の横にあるプレビュー ボタン (アイ アイコン) をクリックします。 

メタデータ フラット化プレビュー アイコン

  1. [アクションの詳細] ページで [設定] タブをクリックします。
  2. Endpoint の値を追加します。

    このエンドポイントの値はスキーマで使用する Web サイトのためのものです。

    • http:// または https:// で開始する絶対 URL を追加すると、コネクターではこの完全な URL がエンドポイントとして使用されます。
    • 相対パスを追加すると、コネクターではコネクター設定の EndpointAddress に Endpoint が追加されます。

    例えば、アクションの Endpoint に「/custom」と入力し、コネクター設定の EndpointAddress に「https://www.acme.com/」と入力すると、コネクターでは https://www.acme.com/custom がエンドポイントとして使用されます。

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

Architect でアクションを使用するには、[アクションの詳細] ページの下にある [公開] をクリックします。

Note: Once you click Publish, you can no longer modify the bridge action. Instead, you must delete the bridge action and add a new bridge action by following the steps in this article. If you use the deleted bridge action in a call flow, you must update the call flow in Architect to use the new bridge action. For more information, see Use bridge actions.

(拡大するには画像をクリックします)

Web サービス データ ディップ コネクターの [アクションの詳細] ページのスクリーンショット

ブリッジは今、コネクタに関連付けられているし、Architectでそれを使用することができます。

次へ] ブリッジ アクションを使用します。 でArchitectの呼び出しのフロー。