JSONイベント

スイート
Customer Experience Employee Experience Strategy & Research
製品
Qualtrics
このページの内容
Qtip:JSONイベントは、クアルトリクスAPIへのアクセスを購入したユーザーのみが利用できます。この機能にご興味のある方は、営業担当またはアカウントサービスにご相談ください。

JSONイベントについて

ウェブサイトで行ったリクエストをクアルトリクスでチケットのトリガーにしたいと思ったことはありませんか？クアルトリクスと社内システムのシームレスな統合を実現したいと思ったことはありませんか？ワークフロータブでタスクをトリガーしたいが、クアルトリクスの外部で発生したイベントをトリガーしたいと思ったことはありませんか？

JSONイベントにより、外部ソフトウェアがHTTPリクエスト経由でワークフローを開始することができます。クアルトリクスでイベントが発生し、プラットフォームでさらなるアクションがトリガーされるのを待つ代わりに、JSONイベントを設定するだけで、サードパーティーからのリクエストを受け取ることができます。

Qtip:この機能を利用するには、事前にAPIトークンを生成する必要があります。すでにAPIトークンをお持ちの場合は、新たに生成する必要はありません。
注意: JSONイベントを設定するには、高度なプログラミング知識が必要です。私たちのサポートチームは、イベントに情報を入れる基本的なことについては喜んでお手伝いいたしますが、プログラミングの面についてはサポートいたしかねます。ただし、コミュニティの経験豊かなユーザーに尋ねてみることは可能です（英語）。

制約

JSONイベントは、以下のセットアップやコンフィギュレーションとは互換性がありません：

  • HTTP以外のもの（メッセージキュー、SMSなど）。
  • アウトバウンドHTTPコール。
  • XMLを処理する(XMLリクエストボディは無視される)。
  • JSON以外を処理する。
  • X-API-トークン・ヘッダ、またはHTTPベーシック認証以外の方法で自分らしくいられることを認証してください。
    Qtip:OAuthやその他の認証機能はJSONイベントと互換性がありません。
  • JSONボディのJSONPathクエリを使用しても満たされないJSONパース。
  • 1分あたり3,000のAPIレート制限を超える通話。
  • 100KBを超えるペイロード。
  • 10個の手動入力フィールド。
    Qtip:イベント・キャプチャで情報が取り込まれると、それはJSONボディに追加される。イベントキャプチャは、10以上のフィールドを追加する唯一の方法です。

対応する認証の種類

トークン・ベース認証／ヘッダー認証

リクエストのヘッダーにX-API-TOKENとしてAPIトークンを渡すことで、自分らしくいられることを認証することができます。

例: 以下のPOSTの例では、cURLでBase URL、Content-Type、Tokenをヘッダーで指定している。アンケートの ID とエクスポートのフォーマットは body

.curl -X POST -H 'X-API-TOKEN: yourapitokenhere' -H 'Content-Type: application/json' -d '{

”

surveyId"："SV_012345678912345",

"format"："csv"

}' 'https://yourdatacenterid.qualtrics.com/API/v3/responseexports'.

HTTPベーシック認証

Basic Authは通常、username:passwordをBase64エンコードしたものです。ただし、クアルトリクスではセキュリティ向上のため、username:x-Api-tokenをBase64エンコードした文字列を使用しています。

Basic Authを使用するには、HTTPリクエストにヘッダーを設定する必要があります。特定のヘッダーはAuthorizationである。

例: クアルトリクスのユーザー名がdemo@qualtrics.com、APIトークンがf8gIK7G6GFH985Y4だとします。まず、こう書くだろう、

demo@qualtrics.com:f8gIK7G6GFH985Y4

そして、Base64エンコード後は次のように表示される、

ベーシック ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=

したがって、HTTPリクエストに追加するAuthorizationヘッダーの値は、Basic ZGVtb0BxdWFsdHJpY3MuY29tOmY4Z0lLN0c2R0ZIOTg1WTQ=となる。

qtip:base64エンコードとbase64デコードのためのツールをチェックしてください。

JSONイベントの設定

まず、ワークフローを作成する必要があります。スタンドアローンのワークフローページに移動します。
ワークフロー]タブで、[ワークフローを作成する]をクリックし、イベントが受信されたときに開始されます。
ワークフロー]タブで、[ワークフローを作成する]をクリックし、イベントが受信されたときに開始されます。
Qtip:JSONイベントを プロジェクトまたはXM DIRECTORYのワークフロータブを選択します。ワークフローを特定のプロジェクトに追加することを推奨するのは、それらが明示的に関連している場合だけです（例えば、JSONイベントでそのプロジェクトを配信する場合など）。JSON イベントは、インポートされたデータプロジェクトを除くすべてのワークスペースで使用できます。
ワークフロー 」タブにいることを確認してください。
ワークフローの作成」をクリックします。
イベント受信時に開始を選択。
JSON イベントを選択します。
ワークフローを開始するJSONイベントの選択
ワークフローを開始するJSONイベントの選択
必要であれば、JSONイベントの目的を説明するトリガー・サマリーを指定します。
要約の追加、エンドポイントのコピー、自分らしくいられること認証機能
要約の追加、エンドポイントのコピー、自分らしくいられること認証機能
URLが表示されます。Postmanや社内システムなど、クアルトリクス外部から新しいワークフローを呼び出す場合に使用します。URLをコピーするには、「URLをコピー」をクリックします。
デフォルトでは、JSONイベントは認証を必要とします。未認証のリクエストを許可したい場合は、クアルトリクスによる認証を要求するを無効にすることができます。
ここで、イベントデータを定義することができる。これはインバウンドリクエストからデータを取得する。開始するには、詳細設定をクリックします。
詳細設定セクションでのイベントデータの定義
詳細設定セクションでのイベントデータの定義
Qtip：「テスト」セクションについては、下記の「イベントをキャプチャする」を参照してください。
左側のボックスで、JSONフィールド名を指定します。右側のボックスで、イベントデータ（HTTPリクエストボディ）内の場所を指定します。
Qtip:ロケーションはJSONPathフォーマットでなければなりません！JSONPath構文のクイックガイドについては、以下の表を参照してください。
別のフィールドを追加するには、Add a JSON fieldをクリックします。
QUERYパラメータを追加したい場合は、 QUERYパラメータ セクションに追加してください。これらのパラメータが何であり、APIでどのように機能するかについては、API Documentation on Parametersを参照してください。
警告: 個人を特定できるデータをQUERYパラメータで渡すことはお勧めしません。個人を特定できる情報や機密性の高いデータは、POSTの方がより安全であるため、可能な限りPOSTボディを通して渡されるべきです。
フィールドを削除するには、マイナス記号（–）をクリックします。
変更を保存するには、Saveをクリックします。
ワークフローに条件とタスクを追加するには、プラス記号(+)をクリックします。条件はワークフローがいつ実行されるかを決定し、タスクはワークフローの結果である。参照 ワークフローの構築 をご覧ください。
プラス記号をクリックすると、タスクの追加と条件の追加のメニューが表示されます。
プラス記号をクリックすると、タスクの追加と条件の追加のメニューが表示されます。

Qtip:パラメータとJSONフィールドを変更するには、JSONイベントをクリックしてください。

注意: JSONイベントは、イベントを作成したのと同じアカウントからのみ、API経由で発生させることができます。異なるアカウントを使用してJSONイベントのAPIを起動した場合でも、202-success APIレスポンスが返される場合がありますが、これは有効なリクエストに有効なApIトークンが使用されたことを意味し、必ずしも正しいAPIトークンが使用されたこと、またはJSONイベントが正しくトリガーされたことを意味するものではありません。202-success APIメッセージを受け取った場合、正しいAPIが使用されたことを確認するためにプラットフォームをチェックしたい。

イベントの捕捉

外部APIイベントを作成する際、post bodyからデータを解析する必要があるかもしれません。しかし、このデータを解析するのは時として難しい。外部APIが何を送信しているかを知りたい場合は、以下の手順に従ってください。

JSONイベントをクリックします。
JSONイベントの選択
JSONイベントの選択
デフォルトでは、テスト結果から JSON フィールドをキャプチャし、このワークフローの他のタスクでテキストの差し込みとして使用できるようにするオプションが有効になっています。このオプションは、ワークフロータスクを追加する際に、ペイロードのボディに解析されたフィールドが自動的にテキストの差し込みとして利用できるようにします。
新しいテストを実行する
新しいテストを実行する
Run a new testをクリックします。
クアルトリクスが外部システムからのイベント受信を待っているというメッセージが表示されます。外部APIを起動します。
外部システムからのイベントを待つJSONイベント
外部システムからのイベントを待つJSONイベント
Qtip:このテストをキャンセルするには、Cancel testをクリックします。
テストが成功すると、「サーバーへの接続に成功しました」というメッセージが表示されます。ペイロードは解析され、ウィンドウに追加される。
テスト成功 - JSONペイロードがイベントウィンドウに表示されます。
テスト成功 - JSONペイロードがイベントウィンドウに表示されます。
必要であれば、Run a new testをクリックして別のテストを実行します。このオプションをクリックした後、次へAPIコールを実行する必要があります。
［保存］をクリックします。

JSONPathの構文

以下の表は、JSONPath構文の基本を示したものである。これらはクアルトリクスによって確立されたものではなく、JSONで使用される標準であることに注意してください。

注意: JSONイベントを設定するには、高度なプログラミング知識が必要です。私たちのサポートチームは、イベントに情報を入れる基本的なことについては喜んでお手伝いいたしますが、プログラミングの面についてはサポートいたしかねます。その代わりに、私たちの熱心なユーザー・コミュニティに尋ねてみることもできます。
JSONPath 説明 例
$ ルート・オブジェクト/要素 $.stores[0].name
@ 現在のオブジェクト/要素 .stores[?(@.name====”ACMEストア”)].
を選択します。 子オペレーター イベント説明
.. 再帰的子孫演算子 $.stores[0].価格
* ワイルドカード $.stores[*].name
［］ 添え字演算子 $.stores[0].name
[,] ユニオン・オペレーター $.stores[0,1]
[開始:終了:ステップ］ 配列スライス演算子 $.stores[0:10:2]である。
?() フィルター適用 .stores[?(@.name==”ACMEストア”)].
（） スクリプト表現 .stores[(@.length-1)]。

JSONPath構文の例

この例では、JSONオブジェクトが与えられた場合、JSONPathテーブルをどのように使用できるかを示します。

これがJSONオブジェクトだ：

{
"eventDescription"："Monthly Revenue",
"stores"：[
{
"name"："Acme Store",
"total": 1000000,
"topItem":

{ "price"：「50", "description"："Anvil" }
},
{
"name"："The Banana Stand",
"total": 250000,
"topItem":

{ "price"："4", "description"："The Gob" }
},
{
"name"："Pizza Planet",
"total": 80000,
"topItem":

{ "price"：「15", "description"："Pepperoni" }
}
]
}.

ここで、JSONPathテーブルで見た戻り値を追加して、より明確にしよう。

$ -> Acme Store
@ -> [
{
"name"："Acme Store",
"total": 1000000,
"topItem":

{ "price"：「50", "description"："Anvil" }
}
]
. -> 月収
. -> 50

-> ["Acme Store", "The Banana Stand", "Pizza Planet"]
[] -> Acme Store
[,] -> [
Unknown macro: { "name"}
,

Unknown macro: { "name"}
]

**[start:end:step]のExampleを「$.stores[1:3:1]"
[start:end:step] -> [
{
"name"："The Banana Stand",
"total": 250000,
"topItem":

{ "price"："4", "description"："The Gob" }
},
{
"name"："Pizza Planet",
"total": 80000,
"topItem":

{ "price"：「15", "description"："Pepperoni" }
}
]

?() -> [{
"name"："Acme Store",
"total": 1000000,
"topItem":

{ "price"：「50", "description"："Anvil" }
}]

() -> [
{
"name"："Pizza Planet",
"total": 80000,
"topItem":

{ "price"：「15", "description"："Pepperoni" }
}
].

Node JavascriptでのAPI例

以下の例は、イベントデータをフォーマットする際に従うことができる基本的なテンプレートです。

注意: JSONイベントを設定するには、高度なプログラミング知識が必要です。私たちのサポートチームは、イベントに情報を入れる基本的なことについては喜んでお手伝いいたしますが、プログラミングの面についてはサポートいたしかねます。その代わりに、私たちの熱心なユーザー・コミュニティに尋ねてみることもできます。
var request = require('request-promise');
var surveyId = "SV_XXXXXXXXXX";
var triggerId = "OC_XXXXXXXXX";
var brandId = "YOUR_BRAND_ID"；
var userId = "UR_XXXXXXXXXXXX";
var datacenter = "xx1";
var apiToken = "YOUR_QUALTRICS_API_TOKEN";

var url = "https：//" + datacenter + ".qualtrics.com/inbound-event/v1/event/JSON/triggers" +
"?contextId=" + surveyId + "&userId=" + userId + "&brandId=" + brandId + "&triggerId=" + triggerId;
var payload = {
"text"："This is some text",
"object"：{
"number"：4
},
"array"：["a", "b", "c", "d"]
};

var options = {
url: url,
json: true,
body: payload,
headers：{
"Content-Type"："application/json", // 必須!!!!

"X-API-TOKEN": apiToken
}
};

request.post(options).then(function (ret) {
console.log("success:", url, payload);
}).catch(function (err) {
console.log("error: ", url);
})；

例Freshdeskとの統合

Qtip:これはFreshdeskタスクとは別のものです。

JSONイベントは、Dispatch’rのWebhookルールとしてFreshdeskと統合するために使用できます。つまり、Freshdeskのイベントは、チケットの作成やアンケートの配信など、クアルトリクスでのタスクをトリガーすることができます。

Qtip:クアルトリクスサポートでは、JSONイベントを設定し、Freshdeskを通じて接続するお手伝いをいたします。しかし、Freshdeskの機能に関する質問で答えられないものもあるかもしれません。Freshdesk側について質問がある場合は、Dispatch’r Rulesに関するドキュメントをチェックしてみてください。
クアルトリクスで、イベントをJSONイベントに設定します。
JSONイベントの選択
JSONイベントの選択
URLをコピーしてください。
JSON イベントで URL をクリックするとコピーされます。
JSON イベントで URL をクリックするとコピーされます。
新しいタブでFreshdeskにログインします。
Adminセクションで、設定したいルールの種類に最も適したオプションに移動します。
左のサイドバーにある管理ギアをクリックすると、ヘルプデスク生産性セクションのトップに3つの異なるオプションが表示されます。
左のサイドバーにある管理ギアをクリックすると、ヘルプデスク生産性セクションのトップに3つの異なるオプションが表示されます。
Qtip:Freshdeskのサポートドキュメントで、Dispatch’r、Supervisor、Observerの違いを学んでください。
新しいルールを作成する。
右上の黒い「新規ルール」ボタン
右上の黒い「新規ルール」ボタン
クアルトリクスでタスクをトリガーするFreshdeskイベントを決定する条件セット。
名前はクアルトリクスCSAT、アンケートの説明はチケット解決時に送信されるアンケート調査です。条件セットをここに示した例に設定すると、ステータスは解決される。アクションが展開され、トリガーウェブフックが表示されます。
名前はクアルトリクスCSAT、アンケートの説明はチケット解決時に送信されるアンケート調査です。条件セットをここに示した例に設定すると、ステータスは解決される。アクションが展開され、トリガーウェブフックが表示されます。
例: Freshdeskエージェントがチケットのステータスを任意のステータスからアンケートのステータスに変更した場合、クアルトリクスを使用してCSATアンケートを送信したいとします。
新しいアクションを追加し、トリガーウェブフックを選択します。
アクションは、トリガーウェブフックが強調表示された状態でメニューが展開されます。
アクションは、トリガーウェブフックが強調表示された状態でメニューが展開されます。
リクエストタイプをPOSTに設定する。
リクエストタイプはPOST、コールバックURLはJSONイベントのURLです。
リクエストタイプはPOST、コールバックURLはJSONイベントのURLです。
Callback URLに、ステップ2のJSONイベントURLを貼り付けます。
トークン認証を使用するには、カスタムヘッダを追加し、X-API-TOKEN:を入力し、APIトークンと同じ値を設定します。
カスタムヘッダーボックスには、X-API-TOKEN: と表示され、APIトークンがぼやけて表示されます。
カスタムヘッダーボックスには、X-API-TOKEN: と表示され、APIトークンがぼやけて表示されます。
HTTP Basic認証を使用するには、Requires Authenticationをクリックし、クアルトリクスユーザー名を追加し、パスワードの代わりにApiトークンを入力します。
Basic authentication - requires authが選択され、前述の情報が入力された。
Basic authentication - requires authが選択され、前述の情報が入力された。
EncodingがJSONであることを確認してください。
エンコーディングはJSONで、リクエスト者のEメールはボディから選択される。
エンコーディングはJSONで、リクエスト者のEメールはボディから選択される。
渡すコンテンツを手動で選択するか、Advancedを選択してJSONボディを入力する。
ルールを守れ。
クアルトリクスで、ワークフローを終了します。この例では、「メールでアンケートを送信する」または「テキストメッセージ (SMS) でアンケートを送信する」タスクを追加します。
タスクを選択するウィンドウで、アンケートを送信を検索すると、メールとテキストメッセージのオプションが表示されました。
タスクを選択するウィンドウで、アンケートを送信を検索すると、メールとテキストメッセージのオプションが表示されました。
アンケートの公開準備ができたら、アンケートの変更を公開することを忘れないでください。
Qtip:Freshdesk のWebhooks については、サポートサイトのリンク先のドキュメントを参照してください。

例ServiceNowとの統合

Qtip:これはServiceNowタスクとは別のものです。

JSONイベントは、ServiceNowと統合するために使用することができます。つまり、ServiceNowのイベントは、チケットの作成やアンケートの配信など、クアルトリクスでのタスクをトリガーすることができます。

Qtip：クアルトリクスサポートでは、JSONイベントのセットアップとServiceNow経由での接続をサポートします。しかし、ServiceNowの機能に関する質問には答えられないこともあるでしょう。ServiceNow開発者インスタンスへのログインおよびアクティベーション方法についてご質問がある場合は、個人開発者インスタンスに関するドキュメントをご覧ください。
クアルトリクスで、イベントをJSONイベントに設定します。
JSONイベントの選択
JSONイベントの選択
URLをコピーしてください。
JSON イベントで URL をクリックするとコピーされます。
JSON イベントで URL をクリックするとコピーされます。
新しいタブで、ServiceNow開発者インスタンスにログインします。
RESTメッセージを選択します。
RESTメッセージの選択
RESTメッセージの選択
Newをクリックする。
RESTのメッセージに名前をつける。
メッセージに名前を付け、エンドポイントを指定し、自分らしくいられること認証機能を選択する。
メッセージに名前を付け、エンドポイントを指定し、自分らしくいられること認証機能を選択する。
Endpointフィールドに、ステップ2でコピーしたURLを貼り付けます。
自分らしくいられること認証機能をBasicに変更する。
HTTP Requestタブに移動する。
HTTPリクエストを選択し、X-APIトークンを追加する。
HTTPリクエストを選択し、X-APIトークンを追加する。
ダブルクリックしてX-APIトークンを追加します。
ダブルクリックしてAPIトークンを貼り付けます。
APIトークンの貼り付け
APIトークンの貼り付け
新しい行に、Content-typeという名前を追加する。
値をapplication/jsonにする。
［送信］をクリックします。
送信をクリックする
送信をクリックする
RESTメッセージを開き直す。
RESTメッセージを開く
RESTメッセージを開く
HTTP Methods］で［New］をクリックする。
クリック・ニュー
クリック・ニュー
メソッドに名前をつける。
HTTPメソッドを設定し、名前をつける。
HTTPメソッドを設定し、名前をつける。
HTTPメソッドをPOSTに設定する。
自分らしくいられること認証機能を親から継承に設定する。
［送信］をクリックします。
先ほど作成したPOST HTTPメソッドを開き直す。
POSTメソッドを開く
POSTメソッドを開く
ページの下部で、［スクリプトの使用状況をプレビュー］を選択します。
テキストをコピーする
テキストをコピーする
テキストをコピーする。
検索し、ビジネスルールを選択します。
サービセナウビジネスルールを検索し、左側に選択。ティール・ニュー・ボタン・トップ、中央
サービセナウビジネスルールを検索し、左側に選択。ティール・ニュー・ボタン・トップ、中央
新規を選択する。
テーブルを選択する。
ページ上で赤く強調表示されている重要項目
ページ上で赤く強調表示されている重要項目
詳細」を選択する。
ビジネスルールが実行されるタイミングを決定する。
例: テーブルに Incident を選択し、解決されたチケットに対して CSAT アンケートを送信したい場合、Incident の状態が Resolved に変わったときにこのルールを実行するという条件を追加できます。
Qtip：クアルトリクスサポートでは、JSONイベントのセットアップとServiceNow経由での接続をサポートします。しかし、ServiceNowの機能に関する質問には答えられないこともあるでしょう。ビジネスルールの実行方法/タイミングについてご質問がある場合は、ビジネスルールの仕組みに関するServiceNowのドキュメントを参照してください。
詳細設定タブに移動する。
Advancedタブが開き、JSONボディが強調表示されている。送信ボタン下部
Advancedタブが開き、JSONボディが強調表示されている。送信ボタン下部
ステップ22でコピーした内容を、「ここにコードを追加してください」と書かれているところに貼り付けます。
コンテンツの貼り付け
コンテンツの貼り付け
ボディを追加する。ここで、クアルトリクスに渡したい情報をコミュニケーションします。
ボディの追加
ボディの追加

例: このフィールドに入れる最終的なコードの例です。このコードのほとんどは、ServiceNowが提供する送信メッセージであり、例によって異なります。残念ながら、クアルトリクスサポートではカスタムコーディングのサポートは行っておりません。コードに問題がある場合は、ServiceNowのコミュニティにお問い合わせください。

太字の部分には、元のコードには含まれていない3つの追加関数が含まれています。ユーザーIDとインシデントの状態をプルするJSONボディと、CSATを送信できるようにインシデントの顧客の電子メールアドレスを取得する呼び出しです（以下イタリック体）。その他の質問がある場合は、ServiceNowのドキュメントを参照してください。

(function executeRule(current, previous /*null when async*/) {

// ここにコードを追加

try {
var r = new sn_ws.RESTMessageV2('クアルトリクス JSON イベント ', 'JSON イベント POST')
;var body = {
"ユーザーID": gs.getUserID()
"インシデント状態": current.state.getDisplayValue()
}；

var target = new GlideRecord('sys_user');
target.addQuery('sys_id', '=', current.caller_id);
target.query();
while(target.next()) {
body["email"] = target.email.getDisplayValue();
}.

var response = r.execute();
var responseBody = response.getBody();
var httpStatus = response.getStatusCode();
gs.addInfoMessage(httpStatus);
}
catch(ex) {
var message = ex.message;

}

}(current, previous)；
リクエストにボディを追加する。前のステップのコードの太字のイタリック体の部分の下に以下を追加する： r.setRequestBody(JSON.stringify(body))；
［送信］をクリックします。
クアルトリクスで、ワークフローを終了します。CSAT アンケートの例を続けるには、メールアンケート送信またはテキストメッセージ（SMS）アンケート送信タスクを追加します。
タスクを選択するウィンドウで、アンケートを送信を検索すると、メールとテキストメッセージのオプションが表示されました。
タスクを選択するウィンドウで、アンケートを送信を検索すると、メールとテキストメッセージのオプションが表示されました。
アンケートの公開準備ができたら、アンケートの変更を公開することを忘れないでください。

例Microsoft FlowによるMicrosoft Dynamicsとの統合

Qtip:これはMicrosoft Dynamicsタスクとは別のものです。

JSONイベントを利用することで、Microsoft Dynamicsのイベントをトリガーとして、チケットの作成やアンケートの配信など、クアルトリクスのタスクを実行することができます。例えば、マイクロソフトのアカウントレコードを削除するたびに、クアルトリクスアンケートをアカウント所有者に配信し、退職に関する質問をすることができます。(例：お名残惜しいです！私たちとの時間はいかがでしたか？

JSONイベントをMicrosoft Dynamicsで発生するアクションと統合するには、DynamicsではなくMicrosoft Flow内でセットアップを行う必要があります。Microsoft FlowはMicrosoft Dynamicsアカウントに無料で付属していますので、Dynamicsの情報を使ってFlowにログインできます。

Qtip:クアルトリクスサポートでは、JSONイベントの設定やMicrosoft Flow、Microsoft Dynamicsとの接続をサポートいたします。しかし、マイクロソフトの機能に関する質問には答えられないこともあるだろう。マイクロソフト側について質問がある場合は、FlowのドキュメントやDynamicsのリソースをチェックしてみてください。
クアルトリクスで、イベントをJSONイベントに設定します。
JSONイベントの選択
JSONイベントの選択
URLをコピーしてください。
JSON イベントで URL をクリックするとコピーされます。
JSON イベントで URL をクリックするとコピーされます。
別のタブでhttps://us.flow.microsoft.com/en-us/、Microsoft Dynamicsの情報を使ってFlowにログインする。
左側のMy Flowsを選択します。
マイクロソフトフローの左上隅、左メニューの3番目のオプションから私のフローを選択し、上部の新しいボタンをクリックして展開すると、リストの3番目の空白のオプションから自動化されたフローが表示されます。
マイクロソフトフローの左上隅、左メニューの3番目のオプションから私のフローを選択し、上部の新しいボタンをクリックして展開すると、リストの3番目の空白のオプションから自動化されたフローが表示されます。
New をクリックし、Automated – from blank を選択する。
流れに名前をつける。
左側に画像と説明書、右側にウィンドウを下降させる手順が記載されている。
左側に画像と説明書、右側にウィンドウを下降させる手順が記載されている。
トリガーを選択します。これは、クアルトリクスでタスクを開始するためにMicrosoftで発生するイベントです。目的に合ったものを選べばよいが、この例では「レコードが削除されたとき（Dynamics 365）」を選択する。
作成」をクリックする。
組織名]で、Dynamicsアカウントにログインします。
レコードが削除されたときに拡大表示され、真下に組織名とエンティティ名のフィールドがある。
レコードが削除されたときに拡大表示され、真下に組織名とエンティティ名のフィールドがある。
エンティティ名]で、レコードまたはファイルのタイプを選択します。この例では、”アカウント “を使う。
次へ」をクリックし、「アクションの追加」を選択します。
HTTPを選択する。
httpおよびオプション拡大
httpおよびオプション拡大
メソッドをPOSTに変更します。
URIフィールドにJSONイベントURLを貼り付けます。
トークン認証を使用すること。Headersの下にX-API-TOKENと入力し、次へAPIトークンを貼り付けます。
BodyにはJSONのボディを入力します。これは、Dynamicsからクアルトリクスに渡す情報を決定するのに役立ちます。
Qtip:ダイナミックコンテンツの追加ボタンを使用して、クアルトリクスに引き継ぐDynamicsレコードフィールドを選択します。スクリーンショットに表示されているように、適切なJSONフォーマットに従っていることを確認してください。動的コンテンツのトラブルシューティングについては、マイクロソフト サポートにお問い合わせください。
終了したら、Saveをクリックします。
クアルトリクスで、ワークフローを終了します。この例では、「メールでアンケートを送信する」または「テキストメッセージ (SMS) でアンケートを送信する」タスクを追加します。
タスクを選択するウィンドウで、アンケートを送信を検索すると、メールとテキストメッセージのオプションが表示されました。
タスクを選択するウィンドウで、アンケートを送信を検索すると、メールとテキストメッセージのオプションが表示されました。
アンケートの公開準備ができたら、アンケートの変更を公開することを忘れないでください。
qtip:Microsoft Flowは、JSON Bodyにより多くの情報をクアルトリクスに送信できるため、これらの手順にはMicrosoft Flowを使用することを推奨します。FlowではなくMicrosoft Dynamics内で設定した場合、Dynamicsイベント中に変更されたフィールドのみがクアルトリクスに送信されます。たとえば、レコードの更新に基づいてトリガーを選択し、「メール」フィールドだけが変更された場合、本文でそれらのフィールドを特に要求しても、「名前」と「住所」はクアルトリクスに送信されません。Flowは、トリガーイベントでそのフィールドが変更されたかどうかに関係なく、要求されたすべてをクアルトリクスに送信します。

例Genesys PureCloudとの統合

Qtip:このインテグレーションをセットアップするには、Genesys Cloud ArchitectとGenesys Web Service Data Actionsにアクセスする必要があります。

JSONイベントを使用して、Genesys PureCloudと統合し、電話やチャットでのサポート対応完了後に顧客にフォローアップ調査を送信できます。

グローバルワークフローページに移動します。
ワークフローを作成し、イベントベースでクリックする。
ワークフローを作成し、イベントベースでクリックする。
イベントベースのワークフローを新規作成します。
ワークフローイベントでは、JSON イベントを選択します。
JSONイベントの選択
JSONイベントの選択
URLをコピー」をクリックすると、イベントのエンドポイントがクリップボードにコピーされます。
URLをコピーしてクリックする
URLをコピーしてクリックする
JSONイベント・ウィンドウを閉じずに、ブラウザで新しいタブを開き、Genesysに移動します。
［管理］ページに移動します。
管理タブからのアクションへのアクセシビリティ
管理タブからのアクションへのアクセシビリティ
アクションをクリックする。
Add Actionをクリックする。
アクション追加ボタン
アクション追加ボタン
統合名としてWeb Services Data Actionsを選択します。
統合に名前をつけ、アクションに名前をつける。
統合に名前をつけ、アクションに名前をつける。
Qtip:Web Services Data Actionsを選択するオプションがない場合、統合を有効にする必要があります。詳しくはこのページをご覧ください。
アクションにアクション 名をつける。
追加をクリックします。
Setupタブに移動します。
JSONを選択し、コントラクト設定タブでプロパティを定義する。
JSONを選択し、コントラクト設定タブでプロパティを定義する。
契約タブを開く。
Input Contract」で「JSON」を選択します。
クアルトリクスに送信するプロパティを設定します。

例: 例えば、以下のコードはメールアドレス、電話番号、名前、姓を渡します。

{
"type"：「object",
"properties"：{
"emailAddress"：{
"type"："string"
},
"phoneNumber"：{
"type"："string"
},
"firstName"：{
"type"："string"
},
"lastName"：{
"type"："string"
}
},
"additionalProperties": true
}.
コンフィギュレーション・タブに 移動する。
リクエストをPOSTに変更し、JSON URLを貼り付ける。
リクエストをPOSTに変更し、JSON URLを貼り付ける。
リクエストタイプをPOSTに変更します。
Request URL Templateフィールドに、クアルトリクスのJSONイベントのURLを貼り付けます。
ヘッダーの追加をクリックする。
APIトークンをヘッダーとして追加する。
APIトークンをヘッダーとして追加する。
Key」 ボックスに「X-APIトークン」と入力する。
Value]ボックスに、クアルトリクス API トークンを入力します。
テスト」タブを開く。
テスト実行前のテスト値の追加
テスト実行前のテスト値の追加
プロパティのテスト値を入力します。
Run Actionをクリックする。
Genesysは、アクションが成功したかどうかを通知します。失敗した場合は、問題を解決するためのエラー回答が表示されます。
アクション成功のメッセージ
アクション成功のメッセージ
クアルトリクスのJSONイベントに戻り、プロパティが正常にクアルトリクスに渡されたことを確認します。
テストペイロードを表示し、保存をクリックします。
テストペイロードを表示し、保存をクリックします。
［保存］をクリックします。
JSONイベントがトリガーされたときにフォローアップするタスクを設定するには、プラス記号（+）、 タスクの順にクリックします。このケースでは、回答者にアンケートを送信したいので、メールによるアンケート調査またはテキストメッセージ（SMS）によるアンケート調査のタスクを選択します。
プラス記号をクリックし、次にタスクをクリックする。
プラス記号をクリックし、次にタスクをクリックする。
Qtip:タスクをセットアップするとき、Genesysから渡された値（例えば、顧客のメール、名前など）を使用するためにテキストの差し込みメニューを使用してください。
クアルトリクスでタスクを設定した後、Genesysに戻り、「Save & Publish」をクリックします。
アクションの公開
アクションの公開
はい」をクリックする。
［管理］ページに移動します。
管理画面から建築家を選択
管理画面から建築家を選択
アーキテクトをクリックする。
フローのドロップダウンメニューで、アンケート調査の招待を選択します。
アンケートの招待をフロードロップダウンから選択します。
アンケートの招待をフロードロップダウンから選択します。
追加をクリックします。
フローに名前、説明、部署をつける
フローに名前、説明、部署をつける
フローに名前、説明、部署をつける。
フローの作成」をクリックする。
ツールボックスの「データ」セクションで「データアクションの呼び出し」を選択し、フローのドロップボックスにドラッグする。
コールデータアクションのタイトルをフローにドラッグする
コールデータアクションのタイトルをフローにドラッグする
アクションに名前をつける。
コールデータアクションに名前をつけ、カテゴリーを選択し、先ほど作成したデータアクションを選択する
コールデータアクションに名前をつけ、カテゴリーを選択し、先ほど作成したデータアクションを選択する
Category（カテゴリー）」で「Web Services Data Action（ウェブサービス・データ・アクション）」を選択する。
Data Action（データ・アクション）」で、先ほど作成したデータ・アクションを選択する。
各プロパティの次へ、ドロップダウンメニューをクリックし、Expressionを選択します。
各プロパティに式を追加する
各プロパティに式を追加する
プロパティ値については、各プロパティについてどのようなデータが送信されるかを入力する。フィールドタイプは自動入力されます。
Qtip: このページには、アンケートの招待フローに含まれるすべてのデフォルトプロパティがあります。また、顧客の連絡先情報が不足していたり、追加の書式設定が必要な場合には、複雑な式を使用することもできます。
Qtip:連絡先の前にSurvey.CustomerContact を付けます。
フローの一番下のボックスをクリックします。
アンケート調査の中止アクションをフローの最後に追加する
アンケート調査の中止アクションをフローの最後に追加する
ツールボックス]、[アンケートの招待]、[アンケートの中止] の順に選択します。
Disposition にoptOutを選択します。
フローを公開する前に、オプトアウトに変更する。
フローを公開する前に、オプトアウトに変更する。
［公開］をクリックします。Genesysはフローを検証し、公開する。これが完了すると、フローが整い、サポート対応を完了した顧客にアンケート調査を送信するようになります。

FAQs

JSONイベントによって、_と連携することはできますか？

JSONイベント（op_start）に対して、スロットルされる前に、1分間にいくつのイベントを作ることができますか？

JSONイベントのワークフローが失敗した場合、どのようにすれば分かりますか？

ワークフローとは何ですか？/ アクションはどこですか？
当サポートサイトの日本語のコンテンツは英語原文より機械翻訳されており、補助的な参照を目的としています。機械翻訳の精度は十分な注意を払っていますが、もし、英語・日本語翻訳が異なる場合は英語版が正となります。英語原文と機械翻訳の間に矛盾があっても、法的拘束力はありません。

この記事は役に立ちましたか

いただいたフィードバックはこのページの改善の目的のみに利用します。

素晴らしい！ フィードバックありがとうございます！

フィードバックありがとうございます！