---
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日
*
*  所要時間：15分
AWA オファー作業 API は、作業アイテムをエージェントにアサインまたは転送するためのエンドポイントを提供します。
この API は、ルーティングとアサインの決定が外部 CCAAS システムで行われるサービスとしての連絡先センター (CCAAS) 統合での使用を目的としています。この API を使用すると、作業アイテムを承認するための通知として、 [受信ボックスカード](https://www.servicenow.com/docs/access?context=awa-inbox-layout&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US) を ServiceNow エージェントワークスペース 内のエージェントに表示できます。
この API には 高度な作業アサイン (com.glide.awa) プラグインが必要です。この API を呼び出すには、awa_manager ロールまたは 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/pTs3XvLGQtBDIviC1EO_oA#awa-agent-consult-api "エージェントコンサルト作業アイテムを処理します。")を使用して、エージェントコンサルト作業アイテムを処理します。
## AWA オファー作業:POST /now/awa/documents/{document_table}/{document_sys_id}/offer {#ariaid-title2}
作業アイテムをエージェントにアサインまたは転送します。
作業アイテムは、 AWA エージェントによって最初から最後まで処理される 1 つの作業です。作業アイテムは、インタラクションやタスクなどのドキュメントに基づいて作成されます。
この API を使用して作業アイテムを受信または転送するすべてのエージェントには、awa_agentロールとawa_external_userロールが必要です。
### URL 形式
バージョニングされた URL: /api/now/{api_version}/awa/documents/{document_table}/{document_sys_id}/offer
デフォルト URL: /api/now/awa/documents/{document_table}/{document_sys_id}/offer
### サポートされている要求パラメーター
{#awa-offer-work-POST-docs-offer__entry__2}{#awa-offer-work-POST-docs-offer__version-not_optional-RESTAPI}
| 名前 | 説明 |
|-|-|
| api_version | オプション。アクセスするエンドポイントのバージョン。たとえば、 v1 や v2 などです。最新以外のエンドポイントバージョンを使用する場合にのみ、この値を指定してください。 データタイプ：文字列 |
| document_table | インタラクション \[interaction\] テーブルやタスク \[task\] テーブルなど、ドキュメントに関連付けられたテーブルの名前。 データタイプ：文字列 |
| document_sys_id | エージェントまたはキューにルーティングするドキュメントのSys_id。 データタイプ：文字列 |
[表 : 1. パスパラメーター]
{#awa-offer-work-POST-docs-offer__entry__10}
| 名前 | 説明 |
|-|-|
| なし | |
[表 : 2. クエリパラメーター]
{#awa-offer-work-POST-docs-offer__entry__14}
| 名前 | 説明 |
|-|-|
| アサイン | 新しいアサインに必要です。アサインに関する情報を含むオブジェクト。 データタイプ: オブジェクト { "after_timeout_presence": "String", "agent_sys_id": "String", "allowed_to_decline": Boolean, "display_option": "String", "enable_auto_assign": Boolean, "offered_on": "String", "timeout": Number } |
| assignment.after_timeout_presence | timeoutパラメーターの有効期限が切れた場合にエージェントが切り替える在席状況のSys_id。 timeout パラメーターが渡されない場合、このパラメーターは無視されます。 在席状況の詳細については、「 [Configure agent presence states](https://www.servicenow.com/docs/access?context=awa-configure-agent-presence&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)」を参照してください。 データタイプ：文字列 デフォルト:空の文字列 (エージェントの在席状況は変更されません)。 テーブル:AWA 在席状況 \[awa_presence_state\] |
| assignment.agent_sys_id | 新しいアサインに必要です。作業アイテムを受信できるエージェントのSys_id。エージェントには、awa_agentロールとawa_external_userロールが必要です。 エージェントが対応可能かどうかを判断する方法については、「 [エージェントの受信ボックスの制御](https://www.servicenow.com/docs/access?context=agent-experience&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)」を参照してください。 データタイプ：文字列 テーブル： ユーザー \[sys_user\] |
| assignment.allowed_to_decline | エージェントに作業アイテムの却下が許可されているかどうかを示すフラグ。このパラメーターが `true` の場合、受信ボックスカードの受信ボックスカードには \[承認 \] ボタンと \[ 却下 \] ボタンの両方が表示されます。 有効な値： * true/yes/1:エージェントは作業アイテムを却下できます。 * false/no/0:エージェントは作業アイテムを却下できません。 {#awa-offer-work-POST-docs-offer__ul_f35_d5n_5dc} データタイプ：ブーリアン デフォルト：true |
| assignment.display_option | 作業アイテムが自動的にアサインされるときのカードとタブの表示オプション。 このパラメーターは、 enable_auto_assign が true の場合にのみ有効です。 有効な値： * card_and_tab:カードとタブの両方を表示します。 * card_only:カードのみを表示します。 {#awa-offer-work-POST-docs-offer__ul_m35_d5n_5dc} データタイプ：文字列 デフォルト値:card_only |
| assignment.enable_auto_assign | 作業アイテムを自動的に受け入れるかどうか、またはエージェントが作業アイテムを手動で受け入れまたは却下できるようにするかどうかを示すフラグ。 有効な値： * true/yes/1:自動的に承認します。 * false/no/0:エージェントが手動で承認または拒否できるようにします。 {#awa-offer-work-POST-docs-offer__ul_o35_d5n_5dc} データタイプ：ブーリアン デフォルト値：false |
| assignment.offered_on | 作業アイテムの提供時間。オファー時間は、エージェントが受信ボックスの作業アイテムを受け入れるために残っている時間を計算するために使用されます。これは、API 要求が処理された時間と、サードパーティルーティングシステムが API 要求を呼び出す時間の間の不一致を考慮するのに役立ちます。このパラメーターを使用すると、このエンドポイントを呼び出す外部システムは、作業アイテムの外部システムの内部追跡との同期を維持するように作業アイテムのオファー時間を構成できます。 たとえば、作業アイテムが 11:30:30 に提供され、タイムアウトが 30 秒で、現在の時刻が 11:30:45 の場合、カウントダウンタイマーには (残り 15 秒と同様) 00:15 と表示されます。 この値は、作業アイテムの \[offered_on\] フィールドに格納されます。 timeoutパラメーターが渡されない場合、このパラメーターは無視されます。 データタイプ：文字列 形式:UTC タイムスタンプ (yyyy-MM-dd'T'HH:mm:ss.SSS) |
| assignment.timeout | エージェントがワークアサインメントを受け入れるのを待機して、作業アイテムをエージェントの受信ボックスに保持する時間。 データタイプ：数値 単位：秒 デフォルト:空の文字列 (時間制限なし)。 |
| external_segment_id | エージェントに提供されるコールセグメントの CCAAS システムからの外部識別子。 データタイプ：文字列 |
| queue_id | 新しいアサインに必要です。外部システム内のキューレコードまたはキュー識別子のSys_id。 外部システムからのqueue_idを使用する場合は、awa_queueレコードのプロバイダーキュー ID (external_id) フィールドにマッピングする必要があります。 データタイプ：文字列 テーブル:キュー \[awa_queue\] |
| 転送 | 転送の割り当てには必要です。転送に関する情報を含むオブジェクト。 このパラメーターに値が指定されている場合、割り当ては転送割り当てと見なされます。 データタイプ: オブジェクト { "source_queue_id": "String", "target_id": "String", "target_type": "String", "transfer_type": "String" } |
| transfer.source_queue_id | 転送の割り当てには必要です。 転送が開始されるソースキュー。外部システム内のキューレコードまたはキュー識別子のSys_id。 外部システムからのqueue_idを使用する場合は、awa_queueレコードのプロバイダーキュー ID (external_id) フィールドにマッピングする必要があります。 このパラメーターは、アクティブな作業アイテムが見つからない場合に転送を開始する前に作業アイテムを作成するために使用されます。元のインタラクションがルーティングなしで作成された場合 (発信コールなど) に転送を実行できます。 データタイプ：文字列 テーブル:キュー \[awa_queue\] |
| transfer.target_id | 転送の割り当てには必要です。アサインの転送先のエージェントまたはキューレコードのSys_id。 * target_typeが`エージェント`の場合、ユーザー \[sys_user\] テーブル内のエージェントユーザーレコードのsys_idがtarget_idです。 * target_typeが`キュー`の場合、target_idキュー \[awa_queue\] テーブル内のキューレコードのsys_idまたは外部システムのキュー識別子です。 {#awa-offer-work-POST-docs-offer__ul_arh_1zw_c2c} データタイプ：文字列 |
| transfer.target_type | 転送の割り当てには必要です。アサインの転送先のレコードのタイプ。 有効な値： * エージェント * キュー {#awa-offer-work-POST-docs-offer__ul_irj_lwv_sdc} データタイプ：文字列 |
| transfer.transfer_type | 転送の割り当てには必要です。転送のタイプ。 有効な値： * 視覚障害者 * 相談 {#awa-offer-work-POST-docs-offer__ul_nds_zbw_sdc} データタイプ：文字列 |
[表 : 3. 要求本文パラメーター (XML または JSON)]
### ヘッダー
次の要求ヘッダーと応答ヘッダーは、この HTTP アクションにのみ適用されるか、別の方法でこのアクションに適用されます。REST API で使用される一般的なヘッダーのリストについては、「 [サポートされている REST API ヘッダー」](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")を参照してください。
{#awa-offer-work-POST-docs-offer__entry__46}{#awa-offer-work-POST-docs-offer__accept-RESTAPI}{#awa-offer-work-POST-docs-offer__content_type-RESTAPI}
| ヘッダー | 説明 |
|-|-|
| 承認 | 応答本文のデータフォーマット。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
| Content-Type | 要求本文のデータ形式。サポートされるタイプ：application/json または application/xml。 デフォルト： application/json |
[表 : 4. 要求ヘッダー]
{#awa-offer-work-POST-docs-offer__entry__52}
| ヘッダー | 説明 |
|-|-|
| なし | |
[表 : 5. 応答ヘッダー]
### ステータスコード
この HTTP アクションには、次のステータスコードが適用されます。REST API で使用される可能性のあるステータスコードのリストについては、「 [REST API HTTP 応答コード](https://servicenow-prod.fluidtopics.net/lLW_uT5I5_l1aD8yR4Jt9A "REST (REpresentational State Transfer) は、Web 上のコンピューター システム間の標準を提供するシンプルなステートレス アーキテクチャであり、コンピューター システム間の通信を容易にします。")」を参照してください。
{#awa-offer-work-POST-docs-offer__entry__56}{#awa-offer-work-POST-docs-offer__entry-200-status-code}{#awa-offer-work-POST-docs-offer__entry-401-status-code}{#awa-offer-work-POST-docs-offer__entry-404-status-code}{#awa-offer-work-POST-docs-offer__entry-500-status-code}
| ステータスコード | 説明 |
|-|-|
| 200 | 成功。要求が正常に処理されました。 |
| 401 | 権限がありません。ユーザー認証情報が正しくないか、渡されていません。 |
| 404 | 見つかりません。要求されたアイテムが見つかりませんでした。 |
| 409 | 競合。指定されたドキュメントの作業アイテムまたはエージェントsys_idのエラーのため、要求を処理できませんでした。 |
| 500 | 内部サーバーエラー要求の処理中に予期しないエラーが発生しました。応答には、エラーに関する追加情報が含まれています。 |
[表 : 6. ステータスコード]
### 応答本文のパラメーター (JSON または XML)
{#awa-offer-work-POST-docs-offer__entry__68}
| 名前 | 説明 |
|-|-|
| メッセージ | アサインの成功または失敗に関する情報を含む応答メッセージ。 可能な値： * `手動割り当てが正常に要求されました` :成功。 * `発信者 に awa_manager ロールまたは awa_integration_user ロールがない` -- API 要求を行う認証済みユーザーには、awa_manager ロールまたは awa_integration_user ロールのいずれかが必要です。 * `承認された作業アイテムをアサインできません` :作業アイテムはエージェントによって既に承認されているため、アサインできません。詳細については、「[Check work items and AWA events](https://www.servicenow.com/docs/access?context=awa-work-items-all&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)」を参照してください。 * `は有効なエージェントではありません` :エージェントにawa_agentロールがありません。 * `転送に失敗しました:エージェントへのブラインド転送はできませんでした` :エージェントが AWA で \[利用可能\] ステータスではないため、アサインが転送されませんでした。 * `作業アイテムは既ににアサイン` されています -- 指定された作業アイテムは別のエージェントにアサインされています。 * `エージェントが利用不可` :エージェントは AWA で \[利用可能\] ステータスではありません。詳細については、「[エージェントの受信ボックスの制御](https://www.servicenow.com/docs/access?context=agent-experience&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US)」を参照してください。 * `タイムアウト値を負の値にすることはできません` :指定されたタイムアウト値を負の値にすることはできません。 * `は有効な在席状況ではありません` :指定された在席状況sys_idが AWA 在席状況 \[awa_presence_state\] テーブルに存在しません。 * `提示時間 () は、yyyy-MM-dd'T'HH:mm:ss の形式にする必要があります。SSS:` 指定されたoffered_onタイムスタンプは、指定された形式を使用する必要があります。 * `提示された時間 () は現在の時間よりも前である必要があります。それ以外の場合は、エージェントが作業アイテムを承認する時間が増えます` - 指定offered_onタイムスタンプを要求が行われた時間より前にすることはできません。 * `タイムアウト後のタイムスタンプ () は現在の時間よりも後である必要があります。それ以外の場合、エージェントは作業アイテムを承認する時間がありません` :指定されたoffered_onタイムスタンプにタイムアウト値を追加した後のタイムスタンプは、要求が行われた時間より後である必要があります。 * `は有効な表示オプションではありません` :指定されたdisplay_optionは、 `card_only` または `card_and_tab` のいずれかの値である必要があります。 * `%s は有効なブール値ではありません` :指定されたブール値は、 `yes/no`、 `true/false`、 `1/0` のいずれかの形式を使用する必要があります。 * `ユーザーに「awa_external_user」ロールがありません` 。アサインを受けるエージェントにはawa_external_userロールが必要です。 * `ドキュメントがアクティブではありません` :指定されたドキュメントはアクティブであり、クローズ済みステータスでない必要があります。 {#awa-offer-work-POST-docs-offer__ul_lrr_2nw_sdc} |
| 成功 | 割り当てが成功したかどうかを示すフラグ。 可能な値： * true:アサインに成功しました。 * false:アサインに失敗しました。 {#awa-offer-work-POST-docs-offer__ul_pz5_tmw_sdc} データタイプ：ブーリアン |
| work_item | 作成または更新された作業アイテムに関する詳細。 データタイプ: オブジェクト { "display_name": "String", "document_id": "String", "document_table": "String", "queue": "String", "sys_id": "String" } |
| work_item.display_name | ドキュメントレコードの表示名。 データタイプ：文字列 |
| work_item.document_id | ドキュメントレコードのSys_id。 データタイプ：文字列 |
| work_item.document_table | ドキュメントに関連付けられたテーブルの名前。 データタイプ：文字列 |
| work_item.queue | 外部システム内のキューレコードまたはキュー識別子のSys_id。 データタイプ：文字列 テーブル:キュー \[awa_queue\] |
| work_item.sys_id | 作業アイテムのSys_id。 データタイプ：文字列 テーブル:作業アイテム \[awa_work_item\] |
[ ]
### cURL 要求
この例では、作業アイテムをエージェントにアサインする方法を示します。
curl "https://instance.servicenow.com/api/now/awa/documents/interaction/59616aba87bd5210be070d48dabb35e6/offer" \
--request POST \
--header "Accept:application/json" \
--header "Content-Type:application/json" \
--data '{
"external_segment_id": "segment_59616aba87bd5210be070d48dabb35e6",
"queue_id": "92f8942787851210be070d48dabb35fb",
"assignment": {
"agent_sys_id": "0d584509c323120095ccd02422d3ae5b",
"allowed_to_decline": "true",
"enable_auto_assign": "false",
"timeout": 30,
"offered_on":"2024-04-03T23:09:31.000"
}
}'
--user 'username':'password'
応答は、作業アイテムがエージェントに正常にアサインされたことを示しています。作業アイテム \[awa_work_item\] レコードの \[アサイン先\] フィールドで結果を確認できます。
{
"result": {
"work_item": {
"display_name": "Interaction: IMS0000221",
"sys_id": "bfa3a27e87bd5210be070d48dabb3588",
"document_id": "59616aba87bd5210be070d48dabb35e6",
"document_table": "interaction",
"queue": "92f8942787851210be070d48dabb35fb"
},
"success": true,
"message": "Manual assignment successfully requested."
}
}