コンタクト センター AI プラットフォーム(CCAI Platform)は、ServiceNow CRM との統合を提供します。
ServiceNow のデベロッパー設定
推奨される ServiceNow の最小バージョン要件: Tokyo patch 1
基本認証ユーザーを設定する
ServiceNow 管理者アカウントで 2 段階認証プロセスが有効になっていて、そのユーザーに関連付けられている可能性があります。そのため、CCAI Platform で管理者アクセス権を取得するために使用することはできません。この目的のために、ServiceNow でユーザー アカウントを作成する必要があります。
認証情報を使用して基本ユーザーを作成します。
[User] > [New] に移動します。
詳細を入力し、[Web service access only] を選択します。
ユーザー ID とパスワードをメモしておきます。
ServiceNow で必要なロール
ServiceNow のデフォルト ロールは、プラットフォーム内で特定のアクセス権と権限を付与するように事前構成されています。管理者は、特定の権限を付与するロールを作成して構成できます。これにより、そのロールを持つユーザーとグループが実行できる操作を制御できます。
この統合を行うには、ServiceNow で次のロールが必要です。
user_admin: このロールは、ServiceNow インスタンス内のユーザー、グループ、ロケーション、会社を管理する必要がある管理者向けに設計されています。
sn_incident_read: このロールは、インシデント管理アプリケーションとその関連機能への読み取り専用権限を付与します。ユーザーはインシデント レコードを表示できます。
sn_incident_write: このロールは、インシデント管理アプリケーションとその関連機能への書き込みアクセス権を付与し、ユーザーがインシデント レコードを作成および変更できるようにします。
personalize_dictionary: このロールでは、特定のビジネス要件に合わせて辞書エントリとラベルをカスタマイズできます。
function_field_admin: このロールは、レポート デザイナー内で関数フィールドを作成、編集、表示する必要があるユーザーを対象としています。プラットフォームのリストまたはフォームから関数フィールドを作成または削除する機能は提供されません。
インスタンス ビューを構成する
以降のセクションでは、インスタンス ビューに必要な構成変更の概要について説明します。
(省略可)お気に入りを追加する
お気に入りを使用すると、ServiceNow インスタンス内でよく使用するリンクをすばやく見つけることができます。お気に入りを追加するには、ナビゲーター パネルのフィールドの横にあるスターアイコンを選択します。後でナビゲータ パネルをフィルタして、お気に入りのみを表示する場合は、ナビゲータ パネルのフィルタ ナビゲータ フィールドのすぐ下にある星アイコンを選択します。
便利なお気に入りの例:
インシデント: カスタム CRM のレコードへの関連付け。
ユーザー: カスタム CRM のアカウントへの関連付け。
REST API Explorer: API をテストするのに適した方法です。
カスタム フィールドを手動で追加する
変更するオブジェクト ビューの左上にある展開アイコン(3 本の水平線)を選択します。これは、セルフサービス ビューまたはデフォルト ビューで行うことができます。
メニューで [Configure] > [Form Design] を選択して、フォーム デザイナーを開きます。
左側の列で、[Field Types] タブを選択します。
追加するカスタム フィールドのタイプをドラッグします。
目的のセクションにフィールド タイプをドロップしたら、歯車アイコンを選択して [設定] を表示します。
ウィンドウ内でラベルを変更し、名前をメモします。この名前は、CCAI Platform アプリの設定で使用します。
画面右上の [保存] を選択します。
セッション データを CRM にマッピングする
Dialogflow を使用して CCAIP から適切なセッション データをマッピングし、次のパラメータを使用する必要があります。
仮想エージェントのデータ
{
"ujet": {
"session_variable": {
"capture_target": "payload",
"payload": {
"value_one": "$session.params.payload_value_one"
};
"capture_type": [ "comment", "field" ] // optional, default of ["comment"]
}
}
}
メタデータ
https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dsys_user https://INSTANCE.service-now.com/api/now/table/sys_dictionary?sysparm_query=name%3Dincident
ラベル: column_label
API キー: element
カスタム フィールドは、sys_user または incident のレスポンスの標準フィールドと同じレベルです。
CCAI Platform から CRM にファイルをアップロードする
https://INSTANCE_URL.service-now.com/api/now/attachment/upload
メソッド: POST
リクエスト データの形式: property
レスポンス データの場所: data.result
タイプ: Multi-part form
添付ファイルの種類: Attachment Url
添付ファイルの URL: download_link
Params: table below
リクエスト例:
{
file: FILE_DATA,
table_name: incident,
table_sys_id: RECORD_ID
}
エージェント アダプタ(カスタム フォーム)を統合する
次の手順では、ServiceNow インスタンスでエージェント アダプタとクリック通話機能を有効にするプロセスについて説明します。
OpenFrame をインストールして構成する
[All] > [System Applications] > [All Available Applications] > [All] に移動します。
OpenFrame を検索します。
OpenFrame をインストールします。
インストール後、[All] > [OpenFrame] > [Configurations] に移動します。
URL を使用して構成を作成します。ServiceNow インスタンス内に複数の構成がある場合、ユーザーは新しく作成された構成にアクセスできないことがあります。グループと OpenFrame 構成の順序のリストを確認して、ユーザーが使用している構成を特定します。
検索に「
sys_properties.list」と入力します。glide.ui.concourse.onmessage_enforce_same_origin_whitelistを編集します。値のリストに新しい URL を追加します。
sn_openframe.cross.origin.accessを編集します。値のリストに
autoplayを追加します。
ユーザーに対して Next UI エクスペリエンスを有効にする
ナビゲーション バーに「
sys_properties.list」と入力して Enter キーを押します。システム プロパティ
glide.ui.polaris.experienceを true に設定します。システムでユーザー設定
glide.ui.polaris.useを false に設定します。ユーザーのユーザー設定
glide.ui.polaris.useを true に設定します。(ユーザー設定行を作成できます)。
システム プロパティを更新する
ナビゲーション バーに「
sys_properties.list」と入力し、Enter キーを押します。glide.ui.concourse.onmessage_enforce_same_origin_whitelistを編集します。URL を値のリストに追加します。複数の値はカンマで区切る必要があります。
sn_openframe.cross.origin.accessを編集します。値のリストに autoplay を追加します。
glide.ui.polaris.experienceを編集します。false に変更します。有効にすると、一部の機能が動作しないためです。
フォームの上部に電話専用広告を追加する
[System UI] > [UI Actions] に移動します。
[Create New Action] を選択します。
図に示すように、このクリック・トゥ・コールが属するテーブルを選択します。

連絡先またはユーザーへの参照を含むフォームの場合は、
g_form.getReferenceAPI を使用してユーザーの電話番号にアクセスします。カスタム テーブルの場合、参照 ID と結果の属性が異なる場合があります。CCAI Platform への通信は同じであるため、ペイロードとデータ構造は次のように同じである必要があります。function clickToDial() { var user = g_form.getReference('caller_id',function(res) { var phone = res.phone || res.mobile_phone; var payload = {"name": "clicktodial", "number": phone}; var data = {"payload": payload, "method": "openframe_communication" }; CustomEvent.fireAll("openframe_request", data); }); }フォーム内に電話番号があるフォームの場合は、
g_form.getValueAPI を使用して関連する値を取得します。これは、Users テーブルの UI アクションの例です。カスタム テーブルの場合、フォーム フィールド名は異なる場合があります。CCAI Platform への通信は同じであるため、ペイロードとデータ構造は次のように同じである必要があります。function clickToDial() { var phone = g_form.getValue('phone') || g_form.getValue('mobile_phone'); var payload = {"name": "clicktodial", "number": phone}; var context = {"payload": payload, "method" : "openframe_communication" }; CustomEvent.fireAll("openframe_request", context); }
参照の横に Click-to-Call を追加
連絡先への参照の横にある通話ボタンは、フォーム内で編集する必要があります。フィールドを右クリックして、[Configure Dictionary] に移動します。属性の場合は、値
show_phoneまたはshow_phone_customer_serviceをref_contributions値に追加します。UI マクロで、
show_phoneとshow_phone_customer_serviceを編集します。次のように置き換えます。
前へ:
var task = {"entity": p.attr('data-task-table'), "query" :"sys_id="+p.attr('data-task-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-task-value'),"label":p.attr('data-task-label')};
var company = {"entity": p.attr('data-company-table'),"query":"sys_id="+p.attr('data-company-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-company-value'),"label":p.attr('data-company-label')};
var caller = {"entity": p.attr('data-caller-table'),"query": "sys_id="+p.attr('data-caller-id')+"$[AMP]sysparm_view="+p.attr('data-task-view'),"value":p.attr('data-caller-value'),"label":p.attr('data-caller-label')};
var callContext = [];
callContext.push(task);
callContext.push(company);
callContext.push(caller);
var metaData = {"phoneNumber":p.attr('data-caller-phone'),"taskId":p.attr('data-task-id')};
var data = {"metaData":metaData , "data": callContext};
var payload = {"type": "OUTGOING_CALL", "data" : data};
var createInteractionData ={};
createInteractionData.interactionSysId = -1;
createInteractionData.direction = 'outbound';
createInteractionData.context_document = p.attr('data-task-id');
createInteractionData.context_table = p.attr('data-task-table');
createInteractionData.account = p.attr('data-company-id');
if(p.attr('data-caller-table') === 'customer_contact')
createInteractionData.contact = p.attr('data-caller-id');
createInteractionData.opened_for = p.attr('data-caller-id');
var ga = new GlideAjax('sn_openframe.OpenFrameAjaxUtility');
ga.addParam('sysparm_name', 'createInteractionWithPropertyCheck');
ga.addParam('context', JSON.stringify(createInteractionData));
ga.getXML(function(serverResponse) {
var result = serverResponse.responseXML.getElementsByTagName("result");
var output = JSON.parse(result[0].getAttribute("data"));
if(output.status == "success"){
var interaction = {"entity": "interaction", "query" :"sys_id="+output.fields.interactionSysId, "value":output.fields.number, "label":"Interaction", "display":false};
payload.data.data.push(interaction);
}
var context = {"payload": payload, "method" : "openframe_communication" };
jslog("context with interaction : "+ JSON.stringify(context));
CustomEvent.fireAll("openframe_request", context);
});
新規:
var phone = p.attr('data-caller-phone')
var payload = {"name": "clicktodial", "number": phone};
var data = {"payload": payload, "method": "openframe_communication" };
CustomEvent.fireAll("openframe_request", data);
CRM の設定
次の手順では、CCAI Platform ポータルを使用して API を ServiceNow に接続する方法について説明します。
CCAI Platform ポータルで、[Settings] > [Developer Settings] > [CRM] に移動します。
[Agent Platform] セクションで、[ServiceNow] を選択します。
[ServiceNow Domain] フィールドに ServiceNow ドメイン情報を入力します。これは、必要に応じてデベロッパー インスタンスまたはベンダー インスタンスにすることもできますが、インスタンスに直接関連付けられており、ServiceNow ポータルのウェブアドレス(
https://{your instance}.servicenow.com)の URL の最初の部分です。[ServiceNow Cloud Selection] フィールドで、基本的なチケットタイプとして
Incidentを選択します。[Custom] を選択すると、追加のオプションが表示されます。インシデントはタスクテーブルの拡張機能です。カスタム オブジェクトはインシデントの拡張機能である必要があります。[認証情報] フィールドにユーザー名とパスワードを入力します。
クラウド選択フィールド タイプに
Incidentを選択した場合、次のフィールドが表示されます。- アカウント オブジェクトの検索には、
Object Type、Phone Number lookup fields、Phone number primary fieldの 3 つのプルダウン フィールドがあります。
- アカウント オブジェクトの検索には、
クラウド選択フィールド タイプに
Customを選択した場合、次のフィールドが表示されます。ルックアップ レコード オブジェクト:
ベースレコード オブジェクト タイプ:
taskまたはincidentのテーブルタイプを選択します。レコード オブジェクト タイプ: インシデント テーブルが拡張されている場合、このフィールドにデータが入力されます。必要に応じて選択できます。
アカウント オブジェクトの検索には、
Object Type、Phone Number lookup fields、Phone number primary fieldの 3 つのプルダウン フィールドがあります。
カスタム ユーザー ID フィールド: モバイルまたはウェブ SDK、または Apps API(チャット)セッションのカスタム ユーザー検索フィールドを有効にする場合は、このチェックボックスをオンにします。
電話番号の形式: 電話番号の表示に使用する形式を選択できます。
セッション メタデータ ファイル: セッション メタデータを CRM レコードに添付するには、このチェックボックスをオンにします。
[保存] をクリックして、選択内容を保存します。
レコードのカスタム フィールド
これらは、フォーム デザイナーで ServiceNow インスタンス用にすでに作成されているカスタム フィールドであり、CCAI Platform で使用できます。メニューの [Custom Fields for Records] セクションで [Create] を選択して、他のカスタム フィールドを作成することもできます。
| フィールド | 種類 | 定義 |
|---|---|---|
u_ujet_custom_field_after_call_work |
文字列 | 通話後の作業時間 |
u_ujet_custom_field_call_duration |
文字列 | 通話時間 |
u_ujet_custom_field_comm_id |
Integer | お問い合わせの種類に応じた通話 ID またはチャット ID |
u_ujet_custom_field_rating |
Integer | CSAT スコア |
u_ujet_custom_field_email_via_web |
文字列 | ウェブから送信されたメール |
u_ujet_custom_field_feedback |
文字列 | フィードバック |
u_ujet_custom_field_from_phone_number |
文字列 | 発信者の電話番号 |
u_ujet_custom_field_hold_duration |
文字列 | 合計保留時間 |
u_ujet_custom_field_menu_path |
文字列 | メニュー選択 |
u_ujet_custom_field_queue_name |
文字列 | キューの名前 |
u_ujet_custom_field_session_type |
文字列 | セッション タイプ |
u_ujet_custom_field_verification |
正しい / 誤り | 確認が完了したことを確認する |
u_ujet_custom_field_wait_time |
文字列 | 合計待機時間 |
OAuth を設定する
OAuth を構成するには、ServiceNow で OAuth アプリケーションを作成する手順を行います。次に、[Developer Settings] > [CRM] > [認証方法] で認証情報(OAuth クライアント ID と OAuth クライアント シークレット)を入力します。
ServiceNow で OAuth アプリケーションを作成する
ServiceNow アカウントで、[All] > [System OAuth] > [Application Registry] に移動します。
OAuth アプリケーションを作成し、[外部クライアント向けの OAuth API エンドポイントを作成] を選択します。
次のフィールドを構成します。
Name: 一意の名前を入力します。
クライアント ID: クライアント ID は、ServiceNow OAuth サーバーによって自動的に生成されます。
クライアント シークレット: OAuth アプリケーションのクライアント シークレット。自動生成する場合は空欄のままにします。
更新トークンの有効期間: 更新トークンが有効な時間(秒単位)。
アクセス トークンの有効期間: アクセス トークンが有効な時間(秒単位)。
リダイレクト URL: 環境 URL とサブディレクトリを入力します。例:
https://servicenow.yourcompany.co/v1/servicenow/oauth_callbackトークン制限を適用する: アクセス トークンの使用を、ServiceNow ドキュメントの REST API アクセス ポリシーで定義されている API に制限します。このオプションの選択を解除すると、他の REST API でアクセス トークンを使用できるようになります。
[送信] をクリックします。
アプリケーションを作成したら、レコードに戻り、クライアント ID と新しく作成したクライアント シークレットを取得します。
デベロッパー設定で設定を更新する
[Developer Settings] > [CRM] に移動します。
設定が前の手順に沿って入力、構成されていることを確認します。
[認証方法] で [OAuth] をクリックします。
OAuth クライアント ID と OAuth クライアント シークレットを入力します。(上記のステップ 5 を参照)。
[保存] をクリックします。
[link credentials] をクリックします。
仮想エージェントのカスタム フィールド マッピング
Virtual Agent を使用している場合は、[カスタム フィールド マッピング] 画面でこのフィールドを構成します。これにより、Virtual Agent 変数を Virtual Agent セッション ペイロードから ServiceNow に転送できます。変数名には任意の文字列を使用できます。ここに記載されているフィールド ラベルは一例です。
[Custom Field Mappings] 画面で、最初の Virtual Agent 構成で使用したペイロード定義によって作成された変数と、ServiceNow 内の関連する変数との接続を構成します。
| フィールド マッピングのタイトル | CRM フィールド ラベル | カスタム データ フィールド ラベル |
|---|---|---|
| 仮想エージェントに関するフィードバック | ccaip_custom_field_incident_feedback |
va_feedback |
CRM フィールド マッピングを追加する
[設定] > [オペレーション管理] に移動します。
[CRM Custom Field Mapping](CRM カスタム フィールドのマッピング)セクションに移動 > [View All](すべて表示)をクリックします。
[+ Add CRM Field Mapping] リンクをクリックします。
フィールド マッピングのタイトル: CCAI Platform ポータルで使用されるこのカスタム フィールド マッピングの CCAI Platform 名。
CRM フィールド ラベル: マッピング先の CRM フィールドの CRM 内のラベル。
カスタムデータ フィールド ラベル(カスタムデータキー): マッピング元の CCAI Platform カスタムデータ ペイロードの最上位キー名(SDK ペイロードの場合は
device、Apps API Chat ペイロードの場合はorderIdなど)。このキーは、CCAI Platform のウェブ SDK またはモバイル SDK、または(チャット インタラクションの場合)Apps API のSend custom data in a chatエンドポイントを使用して送信する必要があります。キーは(大文字と小文字の区別を含めて)完全に一致する必要があります。
[保存] をクリックします。
その他の設定を構成する
[Settings] プルダウン メニューには、CCAI Platform を ServiceNow インスタンスに適切に統合するためのその他の設定があります。各セクションの構成の詳細については、次のリストのリンクをご覧ください。
テスト出力
CCAI プラットフォーム ポータルの画面上部にある関連ボタンをクリックして、通話フローとチャットフローの機能を確認できるようになりました。このテストを実行する際は、ポップアップ ブロッカーが無効になっていることを確認してください。
ServiceNow でインシデントが作成され、インシデントの [アクティビティ] セクションに電話またはチャットの連絡先が表示されます。このバックエンド アクティビティがお客様に表示されないように、インシデント コメントではなく作業メモとして表示される必要があります。
ケースの説明には「CCAI プラットフォームを使用した通話」または「CCAI プラットフォームを使用したチャット」が自動入力されます。エージェントが更新する必要がある場合があります。
通話またはチャットの結果に問題がなければ、解決コードとメモを入力し(ServiceNow の解決コードとメモのフィールドが構成されている場合)、ケースを閉じます。
ケースがクローズされたことを確認するには、ブラウザの back ナビゲーション ボタンをクリックする必要がある場合があります。ServiceNow インスタンスでは、ケースを解決すると自動的にクローズされ、顧客レコードページに進むことが想定されています。