---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# AWA エージェントコンサルト API

# AWA エージェントコンサルト API {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

エージェントコンサルト作業アイテムを処理します。
この API には、 高度な作業アサイン プラグイン (com.glide.awa) と awa_integration_user ロールが必要です。

AWAの詳細については、「[高度なワークアサインメント」](https://www.servicenow.com/docs/access?context=awa-overview&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)を参照してください。

[AWA オファー作業 API](https://servicenow-prod.fluidtopics.net/r9srZHmZGcKMXJdOrFyLPQ#awa-offer-work-api "AWA オファー作業 API は、作業アイテムをエージェントにアサインまたは転送するためのエンドポイントを提供します。")を使用して、エージェントまたはキューへのコンサルト転送を開始します。

## AWA エージェントコンサルト:PUT /now/awa/consult/end {#ariaid-title2}

コンサルト作業アイテムを終了します。
ドキュメントがコンサルトがエージェントに転送される場合は、それぞれの作業アイテムを適切なコンサルトステータス ( <kbd class="ph userinput">[転送済み]</kbd> または <kbd class="ph userinput">[終了済み</kbd>\] ) でクローズする必要があります。

作業アイテムは、AWA エージェントによって最初から最後まで処理される 1 つの作業です。作業アイテムは、インタラクションやタスクなどのドキュメントに基づいて作成されます。

### URL 形式 {#awa-consult-PUT-end__section_qgh_xt3_2mb}

バージョニングされた URL: /api/now/{api_version}/awa/consult/end

デフォルト URL: /api/now/awa/consult/end  
注:  
使用可能なバージョン [は、REST API エクスプローラー](https://servicenow-prod.fluidtopics.net/5V9lEGssZWUBc2ao1C_~Fg "このチュートリアルでは、REST API エクスプローラーを使用して、 ServiceNow REST API をテストします。")で指定されます。スクリプト済み REST API の場合、\[ [スクリプト済み REST サービス\] フォーム](I8AGM_146DeZDBTS~H_J8g "スクリプト化された REST API 機能を使用すると、アプリケーション開発者はカスタム Web サービス API をビルドできます。")に追加のバージョン情報があります。

### サポートされている要求パラメーター

{#awa-consult-PUT-end__entry__2}{#awa-consult-PUT-end__version-not_optional-RESTAPI}

| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 <kbd class="ph userinput">v1</kbd> や <kbd class="ph userinput">v2</kbd> などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
[表 : 1. パスパラメーター]

{#awa-consult-PUT-end__entry__6}

| 名前 | 説明 |
|-|-|
| なし |   |
[表 : 2. クエリパラメーター]

{#awa-consult-PUT-end__entry__10}

| 名前 | 説明 |
|-|-|
| document_sys_id | コンサルト作業アイテムに関連付けられたドキュメントのSys_id。 ドキュメントとは、インタラクション、ケース、インシデントなど、テーブル内の任意のレコードのことです。 データタイプ：文字列 |
| hand_over | コンサルト転送を終了または転送する必要があるかどうかを示すフラグ。 有効な値： * true:ドキュメントをコンサルトエージェントに転送し、コンサルト作業アイテムのコンサルトステータスを <kbd class="ph userinput">[転送済み]</kbd> に設定します。 * false:コンサルトの転送を終了し、コンサルト作業アイテムのコンサルト状況を<kbd class="ph userinput">[終了]</kbd> に設定します。 {#awa-consult-PUT-end__ul_adt_mp5_13c} 注: コンサルト作業アイテムのコンサルトステータスが \[要求済み\] の場合、ステータスは \[キャンセル\] に変わります。 データタイプ：ブーリアン |
[表 : 3. 要求本文パラメーター (JSON または XML)]

### ヘッダー

次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#awa-consult-PUT-end__entry__16}{#awa-consult-PUT-end__accept-RESTAPI}{#awa-consult-PUT-end__content_type-RESTAPI}

| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]

{#awa-consult-PUT-end__entry__22}

| ヘッダー | 説明 |
|-|-|
| なし |   |
[表 : 5. 応答ヘッダー]

### ステータスコード

この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#awa-consult-PUT-end__entry__26}{#awa-consult-PUT-end__entry-200-status-code}{#awa-consult-PUT-end__entry-400-status-code}{#awa-consult-PUT-end__entry-401-status-code}{#awa-consult-PUT-end__entry-403-status-code-awa}{#awa-consult-PUT-end__entry-404-status-code}{#awa-consult-PUT-end__entry-500-status-code}

| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 400 | 要求が正しくありません。不適切な要求タイプまたは誤った要求が検出されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 403 | 禁止されました。 考えられる理由: * ユーザーにawa_integration_userロールがありません。{#awa-consult-PUT-end__li-403-role} * glide.awa.enabled プロパティの値が true ではありません。高度なワークアサインメント (com.glide.awa) プラグインがインストールされている場合、このプロパティはシステムのプロパティ \[sys_property\] テーブルにリストされます。詳細については、「 [高度なワークアサインメントとともにインストールされるコンポーネント](https://www.servicenow.com/docs/access?context=installed-with-awa&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)」を参照してください。{#awa-consult-PUT-end__li-403-awa-disabled} {#awa-consult-PUT-end__ul_gch_n34_tsb} |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]

### 応答本文のパラメーター (JSON または XML)

{#awa-consult-PUT-end__entry__40}

| 名前 | 説明 |
|-|-|
| 成功 | 終了したコンサルトが成功したかどうかを示すフラグ。 有効な値： * true:終了コンサルトは成功しています。 * false:終了相談に失敗しました。 {#awa-consult-PUT-end__ul_zcj_1r5_13c} データタイプ：ブーリアン |
| メッセージ | 終了コンサルトの成功または失敗の情報。 可能な値： * 相談が正常に終了しました。 -- 成功。 * 次のドキュメント ID の作業アイテムが見つかりません:\<api_caller_sys_id\> :ドキュメントのアクティブなコンサルト作業アイテムが存在することを確認します。 {#awa-consult-PUT-end__ul_j5h_vq5_13c} データタイプ：文字列 |
[ ]

### cURL 要求のサンプル

    curl "https://instance.servicenow.com/api/now/awa/consult/end" \
    --request PUT \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data '{
        "document_sys_id": "59616aba87bd5210be070d48dabb35e6",
        "hand_over": "true"
    }' \
    --user 'username':'password'

    {
      "result": {
        "success": true,
        "message": "Consult is successfully ended."
      }
    }