inQuba Journey (プレビュー)

  • リファレンス

データを inQuba 顧客体験 API にシームレスに公開し、顧客体験を効果的に追跡します。

このコネクタは、次の製品および地域で利用可能です:

Service クラス 地域
Logic Apps 標準 以下を除くすべての Logic Apps 地域 :
     -   Azure 政府の地域
     -   Azure 中国の地域
     -   国防総省 (DoD)
Power Automate プレミアム 以下を除くすべての Power Automate 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21Vianet が運用する中国のクラウド
     -   国防総省 (DoD)
Power Apps プレミアム 以下を除くすべての Power Apps 地域 :
     -   米国政府 (GCC)
     -   米国政府 (GCC High)
     -   21 Vianet が運用する中国のクラウド
     -   米国国防総省 (DoD)
お問い合わせ先
件名 inQuba Support
[URL] https://inquba.com
メール support@inquba.com
Connector Metadata
発行者 Inquba Customer Intelligence Pty Ltd
Web サイト https://inquba.com/
プライバシー ポリシー https://www.inquba.com/data-privacy/
カテゴリー データ;コミュニケーション

inQuba Journey コネクタを使用すると、既存のシステムと inQuba Journey プラットフォームをシームレスに統合できます。 コネクタを使用してデータを簡単に送信することで、顧客体験をすばやく視覚化し、顧客の発言や行動に関する分析情報を取得します。 コネクタは、inQuba プラットフォームで使用される顧客体験とイベントを公開できるようにする、使いやすい REST API を提供します。

前提条件

inQuba Journey コネクタを利用するには、次のものが必要です:

  • 展開された登録済みの inQuba Journey インスタンス
  • 有効な Azure サブスクリプション
  • カスタム コネクタ機能を備えた Microsoft Power Apps または Power Automate プラン;

サブスクリプションを購入するには、Azure マーケット プレース にアクセスするか、inQuba ウェブサイト にアクセスして営業に連絡します。

資格情報の入手方法

すべての inQuba API で認証が必要です。 inQuba の登録プロセスが完了したら、アカウント マネージャーまたは inQuba Support に連絡して、API の認証情報を取得します。 これらの認証情報は、すべての API 操作の Journey コネクタで使用されます。

コネクタの使用を開始する

inQuba Journey コネクタには、すべてのアクションの承認が必要です。 「イベントの作成」または「トランザクションの作成」アクションを使用する前に、必ず「アクセス トークンの取得」アクションの使用から始めてください。

  1. inQuba からイベントまたはトランザクション属性の定義と認証情報を取得します。 これらの属性定義は、顧客とのやり取りや顧客体験の追跡に必要な属性を示します。 関連する定義と認証情報については、アカウント マネージャーまたは inQuba Support に連絡してください。

  2. アクセス トークンの取得アクションで提供された詳細を使用します: アクセス トークンの取得

  3. イベントの作成、またはトランザクションの作成 アクションのいずれかを使用します。 'Authroization Token' フィールドを更新するには、「アクセス トークンの取得」アクションの動的コンテンツを使用してください。 値 'Bearer ' を追加してから、以下に示すように、前のステップの認証トークン値を使用して動的コンテンツを選択してください。 イベントの作成

  4. その後、アクションのフォームに必要な詳細を記入し、inQuba プラットフォームとの統合に進むことができます。

Dynamics を使用した一般的なフローの例を以下に示します。 以下のフローは、Dynamics でフロー ステップが実行されたときにトリガーされます: Dynamics フロー

既知の問題と制限事項

create event および create transaction API は現在、リクエストごとにシングル イベントとトランザクション ペイロードのみをサポートしています。 複数のイベントおよびトランザクションの場合、多くの反復要求を開始することをお勧めします。

一般的なエラーと解決策

応答に HTTP 401 エラーが含まれています

認証情報が正しく、inQuba から提供された認証情報と一致していることを確認してください。 inQuba Support に連絡して認証情報を確認してください。

応答に HTTP 404 エラーが含まれています

inQuba から提供された正しいテナント名とホスト URL を使用していることを確認してください。 inQuba Support に連絡してテナント名を確認してください。

応答に HTTP 500 エラーが含まれています

属性配列入力を使用するか、未処理属性が正しいことを確認して、イベントまたはトランザクション属性配列が正しく定義されていることを確認してください。 inQuba Support に連絡して構成を確認してください。

よくあるご質問

  • イベントまたはトランザクション エンドポイントを使用して送信できるリクエストの数はいくつですか? 送信できるリクエストの数に厳しい制限はありませんが、体験とイベントの処理は、有料のサブスクリプション階層によって制限されます。 サブスクリプションの価格については こちら を参照してください。

  • イベントとトランザクションの Open API 定義はどこにありますか? Swagger ドキュメントは イベント と トランザクション API で利用できます。

  • 非運用エンドポイントをテストに使用できますか? はい。 アカウント マネージャー または inQuba Support に連絡して、テスト用の認証情報を取得してください。

  • コネクタではどのデータ ソースがサポートされていますか? コネクタは、Power Automate 内で使用できるすべてのデータ ソースをサポートします。 構成するフローへのステップとしてコネクターを追加できます。

調整制限

名前 呼び出し 更新期間
接続ごとの API 呼び出し 100 60 秒

アクション

アクセス トークンの取得

inQuba API で認証し、すべての API インタラクションに使用される認証トークンを受け取ります。
イベントの作成

イベント レコードを inQuba API に公開します。 API と対話するには、ベアラー トークンが必要です。
トランザクションの作成

トランザクション を inQuba Journey API に公開します。 API と対話するには、ベアラー トークンが必要です。

アクセス トークンの取得

操作 ID:
AcquireAccessToken

inQuba API で認証し、すべての API インタラクションに使用される認証トークンを受け取ります。

パラメーター

名前 キー 必須 型 説明
Tenant Name
 TenantName True string

inQuba に登録されているテナントの名前。
Host URL
 HostURL True string

トークン エンドポイントのホストは、スキーム名なしで指定する必要があります。 例: api.inqubacx.com
Username
 username True string

inQuba によって提供されたアカウント ユーザー名。
Password
 password True string

inQuba によって提供されたアカウント パスワード。
Client ID
 client_id True string

inQuba から提供された クライアント ID。
Client Secret
 client_secret True string

inQuba から提供されたクライアント シークレット。

戻り値

名前 パス 型 説明
Authorization Token
 access_token string

すべての API インタラクションに使用される認証トークン。

イベントの作成

操作 ID:
PublishEvent

イベント レコードを inQuba API に公開します。 API と対話するには、ベアラー トークンが必要です。

パラメーター

名前 キー 必須 型 説明
Tenant Name
 TenantName True string

inQuba に登録されているテナントの名前。
Authorization Token
 AuthorizationToken True string

inQuba への API リクエストを認証するための認証トークン。
Event Definition Code
 eventDefinitionCode string

このリクエストを発行するイベント コード。
Is Test
 isTest boolean

このイベントをテストまたはライブとして公開する必要があるかどうかを示すフラグ。
Code
 code string

イベント属性コード
Value
 value string

イベント属性値

戻り値

SuccessStatus
string

トランザクションの作成

操作 ID:
PublishTransaction

トランザクション を inQuba Journey API に公開します。 API と対話するには、ベアラー トークンが必要です。

パラメーター

名前 キー 必須 型 説明
Tenant Name
 TenantName True string

inQuba に登録されているテナントの名前。
Authorization Token
 AuthorizationToken True string

inQuba への API リクエストを認証するための認証トークン。
Transaction Definition Code
 transactionDefinitionCode string

このリクエストを発行するトランザクション コード。
Is Test
 isTest boolean

このトランザクションをテストまたはライブとして公開する必要があるかどうかを示すフラグ。
Code
 code string

トランザクション属性コード
Value
 value string

トランザクション属性値

戻り値

SuccessStatus
string

定義

文字列

これは基本的なデータ型 '文字列' です。