---
sourceDocument: 호주 API 참조
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/api-reference

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 API 참조

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# 마무리 API

# 마무리 API {#ariaid-title1}

* 릴리스 버전: Australia
* 
* 업데이트 날짜 2026년 03월 12일
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 소요 시간: 90분

외부 CCaaS(연락처 센터 서비스형) 시스템 또는 ServiceNow AI Platform 작업 공간에 대한 마무리 기능을 관리하기 위한 엔드포인트를 제공합니다.
이 API에는 상호작용 관리(com.glide.interaction.awa) 플러그인이 필요합니다. 이 API를 호출하려면 interaction_integration_user 역할이 있어야 합니다.

에이전트가 상호작용을 종결할 때 마무리 기능을 통해 나중에 참조할 수 있도록 종결 상세 정보와 마무리 코드를 입력할 수 있습니다. 마무리 기능에 대한 자세한 내용은 다음 문서를 참조하십시오 [Wrap up overview](https://www.servicenow.com/docs/access?context=wrap-up-overview&version=australia&pubname=australia-conversational-interfaces&ft:locale=en-US).

외부 시스템에서 세그먼트화된 상호 작용 마무리에 이 API를 사용하려면 InteractionSegment 스크립팅된 확장점을 구현하여 선택한 테이블에 세그먼트 기록을 만들고 검색해야 합니다. [OpenFrame](https://www.servicenow.com/docs/access?context=c_OpenFrameOverview&version=australia&pubname=australia-customer-service-management&ft:locale=en-US)을 사용하는 경우 확장점에는 전화 로그 \[sn_openframe_phone_log\] 테이블에서 세그먼트 기록을 만들고 검색하는 기존 구현이 있습니다.

AI 마무리 권장 사항

:   AI 마무리 권장 사항은 다음 두 가지 소스에서 나올 수 있습니다.{#wrap-up-api__ai-wrap-up-intro}

    * 내부(Now Assist): false인 경우 use_third_party_ai 세그먼트 생성 후 비즈니스 규칙이 자동으로 트리거되어 CSM API를 호출하고 및 를 ai_notes채웁니다ai_wrap_up_code.
    * 외부(외부 공급업체/CCaaS): 예인 경우 use_third_party_ai 외부 시스템은 새 PUT /api/now/wrapup/segment/update/ai 엔드포인트를 통해 AI 데이터를 푸시합니다.
    {#wrap-up-api__ai-sources-list}

사용 케이스
:
    * AI 제안과 함께 마무리 코드 및 메모를 제공하여 에이전트 처리 시간을 단축합니다.
    * CCaaS 플랫폼이 상호작용이 종료된 후 AI 생성 콘텐츠를 푸시할 수 있도록 합니다 ServiceNow AI Platform .
    * 감독자에게 보고 및 분석을 위해 보다 깔끔하고 일관된 마무리 데이터를 제공합니다.
    {#wrap-up-api__ai-use-cases-list}

AI 지원 마무리 플로우를 위한 엔드포인트 호출 순서
:
    1. POST /api/now/wrapup/segment/create --- 세그먼트를 열거나 / ai_notes 및 AI 구성 플래그를 전달 ai_wrap_up_code 합니다.
    2. PUT /api/now/wrapup/segment/update/ai --- (외부 AI만 해당) AI 권장 사항을 오픈 세그먼트에 푸시합니다.
    3. PUT /api/now/wrapup/segment/update --- 에이전트가 세그먼트를 완료하고 닫습니다.
    4. GET /api/now/wrapup/segment/{segment_id} --- 저장된 AI 필드를 포함한 세그먼트를 검색합니다.
    {#wrap-up-api__ai-endpoint-order-list}

## 마무리 - GET /now/wrapup/code/{code_id} {#ariaid-title2}

지정된 마무리 코드에 대한 상세 정보를 검색합니다.

### URL 형식

버전이 지정된 URL: /api/now/{api_version}/wrapup/code/{code_id}

기본 URL: /api/now/wrapup/code/{code_id}

### 지원되는 요청 매개변수

{#wrap-up-GET-code__entry__2}{#wrap-up-GET-code__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| code_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
[표 1. 경로 매개변수]

{#wrap-up-GET-code__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 2. 쿼리 매개변수]

{#wrap-up-GET-code__entry__12}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 3. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-GET-code__entry__16}{#wrap-up-GET-code__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 4. 요청 헤더]

{#wrap-up-GET-code__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 5. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-GET-code__table_ky1_xy2_42c__entry__2}{#wrap-up-GET-code__entry-200-status-code}{#wrap-up-GET-code__entry-400-status-code}{#wrap-up-GET-code__entry-401-status-code}{#wrap-up-GET-code__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 6. 상태 코드]

{#wrap-up-GET-code__table_ky1_xy2_42c}

### 응답 본문 매개변수(JSON 또는 XML)

{#wrap-up-GET-code__entry__34}{#wrap-up-GET-code__message}{#wrap-up-GET-code__codes-code-desc-ph}{#wrap-up-GET-code__success}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청 및 마무리 코드에 대한 정보를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "message": "String", "resultMap": {Object}, "success": Boolean } |
| 결과.메시지 | API 요청의 결과를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| result.result_map | 마무리 코드를 포함하는 객체입니다. 데이터 유형: 객체 "result_map": { "wrap_up_code": {Object} } |
| result.result_map.wrap_up_code | 마무리 코드에 대한 상세 정보가 포함된 객체입니다. 데이터 유형: 객체 "wrap_up_code": { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } |
| result.result_map.wrap_up_code.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-GET-code__ul_gfl_mbf_m2c} 데이터 유형: 부울 기본값: true |
| result.result_map.wrap_up_code.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| result.result_map.wrap_up_code.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| result.result_map.wrap_up_code.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-GET-code__ul_hh5_pwl_3} 데이터 유형: 부울 |
| result.result_map.wrap_up_code.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| result.result_map.wrap_up_code.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| result.result_map.wrap_up_code.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| 결과.성공 | API 요청이 성공적으로 처리되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: API 요청이 성공했습니다. * false: API 요청이 실패했습니다. {#wrap-up-GET-code__ul_mdm_tff_m2c} 데이터 유형: 부울 |
[ ]

### cURL 요청

이 예에서는 지정된 마무리 코드에 대한 상세 정보를 검색합니다.

    curl "https://instance.service-now.com/api/now/v1/wrapup/code/49c27b679f201210c89656effa0a1cd7" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

응답 본문.

    {
      "result": {
        "message": "Wrap up code found.",
        "result_map": {
          "wrap_up_code": {
            "code": "Billing Issue",
            "description": "A code for billing issues",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": "Ein code für Abrechnungsprobleme"
          }
        },
        "success": true
      }
    }

## 마무리 - GET /now/wrapup/segment/{segment_id} {#ariaid-title3}

지정된 마무리 세그먼트에 대한 상세 정보를 검색합니다.

### URL 형식

버전이 지정된 URL: /api/now/{api_version}/wrapup/segment/{segment_id}

기본 URL: /api/now/wrapup/segment/{segment_id}

### 지원되는 요청 매개변수

{#wrap-up-GET-segment__entry__2}{#wrap-up-GET-segment__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| segment_id | 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] 테이블의 마무리 세그먼트 Sys_id 또는 외부 시스템의 상호작용 세그먼트를 나타내는 식별자입니다. 데이터 유형: 문자열 |
[표 7. 경로 매개변수]

{#wrap-up-GET-segment__entry__8}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 8. 쿼리 매개변수]

{#wrap-up-GET-segment__entry__12}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 9. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-GET-segment__entry__16}{#wrap-up-GET-segment__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 10. 요청 헤더]

{#wrap-up-GET-segment__entry__20}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 11. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-GET-segment__table_n5n_sy2_42c__entry__2}{#wrap-up-GET-segment__entry-200-status-code}{#wrap-up-GET-segment__entry-400-status-code}{#wrap-up-GET-segment__entry-401-status-code}{#wrap-up-GET-segment__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 12. 상태 코드]

{#wrap-up-GET-segment__table_n5n_sy2_42c}

### 응답 본문 매개변수(JSON 또는 XML)

{#wrap-up-GET-segment__table_xpr_b42_42c__entry__2}{#wrap-up-GET-segment__segment-agent}{#wrap-up-GET-segment__interaction-id}{#wrap-up-GET-segment__codes-code-desc-ph}{#wrap-up-GET-segment__d3307e202}

| 이름 | 설명 |
|-|-|
| 메시지 | API 요청의 결과를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| 세그먼트 | 상호작용 및 마무리 세그먼트에 대한 데이터를 포함하는 객체입니다. 데이터 유형: 객체 "segment": { "agent": "String", "ai_code_defined_at": "String", "ai_notes": "String", "ai_notes_defined_at": "String", "ai_wrap_up_code": "String", "awaiting_confirmation": Boolean, "confirmed_on": "String", "external": Boolean, "interaction": "String", "opened_on": "String", "segmented": Boolean, "segment_id": "String", "segment_table": "String", "state": "String", "submitted_on": "String", "sys_id": "String", "wrap_up_configuration": {Object} } |
| 세그먼트.에이전트 | 상호작용에 할당된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| segment.ai_code_defined_at | AI 코드가 저장되었을 때의 타임스탬프입니다. 형식: Unix epoch 밀리초(예: "1752252703000") 데이터 유형: 문자열 |
| segment.ai_notes | 세그먼트에 저장된 AI 생성 메모입니다. 데이터 유형: 문자열 |
| segment.ai_notes_defined_at | AI 메모가 저장되었을 때의 타임스탬프입니다. 형식: Unix epoch 밀리초 데이터 유형: 문자열 |
| segment.ai_wrap_up_code | 세그먼트에 저장된 AI 권장 코드입니다. 데이터 유형: 문자열 |
| segment.awaiting_confirmation | 에이전트가 제출한 마무리 세그먼트가 외부 CCaaS 시스템에서 처리되었는지 확인을 기다리고 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 세그먼트가 확인 대기 중입니다. * false: 마무리 세그먼트가 외부 시스템에서 처리되었습니다. {#wrap-up-GET-segment__ul_jvz_fr2_42c} 데이터 유형: 부울 |
| segment.confirmed_on | 제출된 마무리 세그먼트가 외부 CCaaS 시스템에서 처리되는 날짜 및 시간입니다. 데이터 유형: 문자열 |
| 세그먼트.외부 | 상호작용 세그먼트가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 상호작용 세그먼트가 외부 시스템에서 온 것입니다. * false: 상호작용 세그먼트가 내부입니다. {#wrap-up-GET-segment__ul_hh5_pwl_m2c} 데이터 유형: 부울 기본값: false |
| 세그먼트.상호작용 | 상호작용의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
| segment.opened_on | 외부 시스템에 따른 마무리 기간의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 |
| 세그먼트.분할됨 | 마무리가 분할되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리가 여러 부분으로 분할됩니다. * false: 마무리는 하나의 완전한 세그먼트입니다. {#wrap-up-GET-segment__ul_hpy_wxl_m2c} 데이터 유형: 부울 기본값: false |
| segment.segment_id | 상호작용 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 |
| segment.segment_table | 상호작용 세그먼트가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 |
| 세그먼트.상태 | 상호작용 세그먼트의 상태입니다. 데이터 유형: 문자열 |
| segment.submitted_on | 에이전트가 마무리 세그먼트를 제출한 날짜 및 시간입니다. 데이터 유형: 문자열 |
| segment.sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
| segment.wrap_up_configuration | 마무리 세그먼트에 사용되는 마무리 구성에 대한 상세 정보를 포함하는 객체입니다. 데이터 유형: 객체 "wrap_up_configuration": { "allowed_codes": [Array], "default_code": {Object}, "enable_ai_code": Boolean, "enable_ai_notes": Boolean, "enable_codes": Boolean, "use_ai_as_default": Boolean, "use_third_party_ai": Boolean } |
| segment.wrap_up_configuration.allowed_codes | 에이전트가 사용할 수 있는 마무리 코드를 나타내는 객체의 배열입니다. 데이터 유형: 배열 "allowed_codes": [ { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } ] |
| segment.wrap_up_configuration.allowed_codes.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-GET-segment__ul_gfl_mbf_m2c} 데이터 유형: 부울 기본값: true |
| segment.wrap_up_configuration.allowed_codes.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-GET-segment__ul_hh5_pwl_3} 데이터 유형: 부울 |
| segment.wrap_up_configuration.allowed_codes.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.wrap_up_configuration.allowed_codes.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code | 기본값으로 사용할 마무리 코드가 포함된 객체입니다. 데이터 유형: 객체 "default_code": { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } |
| segment.wrap_up_configuration.default_code.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-GET-segment__d3307e182} 데이터 유형: 부울 기본값: true |
| segment.wrap_up_configuration.default_code.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-GET-segment__d3307e394} 데이터 유형: 부울 |
| segment.wrap_up_configuration.default_code.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.wrap_up_configuration.default_code.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.enable_ai_code | 이 구성에 대해 AI 코드 생성이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 이 구성에 대해 AI 코드 생성이 활성화되어 있습니다. * 아니오: 이 구성에서는 AI 코드 생성을 사용할 수 없습니다. {#wrap-up-GET-segment__ul_l14_pxl_v3c} 데이터 유형: 부울 |
| segment.wrap_up_configuration.enable_ai_notes | 이 구성에 대해 AI 메모 생성이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 이 구성에 대해 AI 메모 생성이 활성화되어 있습니다. * 아니오: 이 구성에서는 AI 메모 생성을 사용할 수 없습니다. {#wrap-up-GET-segment__ul_xxf_qxl_v3c} 데이터 유형: 부울 |
| segment.wrap_up_configuration.enable_codes | 에이전트가 마무리 코드를 선택해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 에이전트가 마무리 코드를 선택해야 합니다. * false: 에이전트가 마무리 코드를 선택할 필요가 없습니다. {#wrap-up-GET-segment__ul_s3z_45r_m2c} 데이터 유형: 부울 기본값: false |
| segment.wrap_up_configuration.use_ai_as_default | AI 코드가 이 구성에 대한 기본 마무리 코드로 자동 설정되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: AI 코드가 자동으로 기본 마무리 코드로 설정됩니다. * false: AI 코드가 자동으로 기본 마무리 코드로 설정되지 않습니다. {#wrap-up-GET-segment__ul_qyf_qxl_v3c} 데이터 유형: 부울 |
| segment.wrap_up_configuration.use_third_party_ai | AI 콘텐츠 소스가 외부 공급업체 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: AI 콘텐츠 소스가 외부 공급업체 외부 시스템에서 제공됩니다. * 아니오: Now Assist AI 컨텐츠 소스입니다. {#wrap-up-GET-segment__ul_hzf_qxl_v3c} 데이터 유형: 부울 |
| segment_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
| 성공 | API 요청이 성공적으로 처리되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: API 요청이 성공했습니다. * false: API 요청이 실패했습니다. {#wrap-up-GET-segment__ul_mdm_tff_m2c} 데이터 유형: 부울 |
[ ]

{#wrap-up-GET-segment__table_xpr_b42_42c}  

### cURL 요청

이 예에서는 지정된 마무리 세그먼트에 대한 상세 정보를 검색합니다.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/dgajbcef12345678defdbxef123435678" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

응답 본문.

    {
      "success": true,
      "message": "Wrap up segment retrieved successfully.",
      "segment_id": "dgajbcef12345678defdbxef123435678",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "segment_table": "sn_openframe_phone_log",
        "segment_id": "dgajbcef12345678defdbxef123435678",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "closed",
        "wrap_up_configuration": {
          "enable_codes": true,
          "allowed_codes": [
            {
              "code": "Billing Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": ""
            },
            {
              "code": "Store Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "54327b679f201210c89656effa0a1cd7",
              "translated_code": " Einkaufsproblem",
              "translated_description": ""
            }
          ],
          "default_code": {
            "code": "Billing Issue",
            "description": "",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": ""
          }
        },
        "segmented": true,
        "sys_id": "dgajbcef12345678defdbxef123435678",
        "opened_on": "2024-09-16 17:52:01",
        "submitted_on": "2024-09-16 18:51:59",
        "confirmed_on": "2024-09-16 18:52:01",
        "awaiting_confirmation": false
      }
    }

이 예에서는 AI 권장 사항에 대해 구성된 지정된 마무리 세그먼트에 대한 상세 정보를 검색합니다.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/abcd1234abcd1234abcd1234abcd1234" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

응답 본문.

    {
      "success": true,
      "message": "Segment retrieved.",
      "segment_id": "abcd1234abcd1234abcd1234abcd1234",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "state": "closed",
        "ai_wrap_up_code": "Billing Issue",
        "ai_notes": "Customer called about an incorrect charge.",
        "ai_code_defined_at": "1752252703000",
        "ai_notes_defined_at": "1752252703000",
        "wrap_up_configuration": {
          "enable_ai_code": true,
          "enable_ai_notes": true,
          "use_ai_as_default": true,
          "use_third_party_ai": false
        }
      }
    }

## 마무리 - GET /now/wrapup/segment/agent/{agent_id}/interaction/{interaction_id} {#ariaid-title4}

지정된 에이전트 및 상호작용을 기반으로 마무리 세그먼트에 대한 상세 정보를 검색합니다.

### URL 형식

버전 관리된 URL: /api/now/{api_version}/wrapup/segment/agent/{agent_id}/interaction/{interaction_id}

기본 URL: /api/now/wrapup/segment/agent/{agent_id}/interaction/{interaction_id}

### 지원되는 요청 매개변수

{#wrap-up-GET-segment-agent-int__entry__2}{#wrap-up-GET-segment-agent-int__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
| agent_id | 상호작용에 할당된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| interaction_id | 상호작용의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
[표 13. 경로 매개변수]

{#wrap-up-GET-segment-agent-int__entry__10}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 14. 쿼리 매개변수]

{#wrap-up-GET-segment-agent-int__entry__14}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 15. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-GET-segment-agent-int__entry__18}{#wrap-up-GET-segment-agent-int__accept-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 16. 요청 헤더]

{#wrap-up-GET-segment-agent-int__entry__22}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 17. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-GET-segment-agent-int__entry__26}{#wrap-up-GET-segment-agent-int__entry-200-status-code}{#wrap-up-GET-segment-agent-int__entry-400-status-code}{#wrap-up-GET-segment-agent-int__entry-401-status-code}{#wrap-up-GET-segment-agent-int__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 18. 상태 코드]

### 응답 본문 매개변수(JSON 또는 XML)

{#wrap-up-GET-segment-agent-int__table_xpr_b42_42c__entry__2}{#wrap-up-GET-segment-agent-int__segment-agent}{#wrap-up-GET-segment-agent-int__d3307e468}{#wrap-up-GET-segment-agent-int__interaction-id}{#wrap-up-GET-segment-agent-int__codes-code-desc-ph}{#wrap-up-GET-segment-agent-int__d3307e202}

| 이름 | 설명 |
|-|-|
| 메시지 | API 요청의 결과를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| 세그먼트 | 상호작용 및 마무리 세그먼트에 대한 데이터를 포함하는 객체입니다. 데이터 유형: 객체 "segment": { "agent": "String", "ai_code_defined_at": "String", "ai_notes": "String", "ai_notes_defined_at": "String", "ai_wrap_up_code": "String", "awaiting_confirmation": Boolean, "confirmed_on": "String", "external": Boolean, "interaction": "String", "opened_on": "String", "segmented": Boolean, "segment_id": "String", "segment_table": "String", "state": "String", "submitted_on": "String", "sys_id": "String", "wrap_up_configuration": {Object} } |
| 세그먼트.에이전트 | 상호작용에 할당된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| 세그먼트.에이전트 | 상호작용에 할당된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| segment.ai_code_defined_at | AI 코드가 저장되었을 때의 타임스탬프입니다. 형식: Unix epoch 밀리초(예: "1752252703000") 데이터 유형: 문자열 |
| segment.ai_notes | 세그먼트에 저장된 AI 생성 메모입니다. 데이터 유형: 문자열 |
| segment.ai_notes_defined_at | AI 메모가 저장되었을 때의 타임스탬프입니다. 형식: Unix epoch 밀리초 데이터 유형: 문자열 |
| segment.ai_wrap_up_code | 세그먼트에 저장된 AI 권장 코드입니다. 데이터 유형: 문자열 |
| segment.awaiting_confirmation | 에이전트가 제출한 마무리 세그먼트가 외부 CCaaS 시스템에서 처리되었는지 확인을 기다리고 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 세그먼트가 확인 대기 중입니다. * false: 마무리 세그먼트가 외부 시스템에서 처리되었습니다. {#wrap-up-GET-segment-agent-int__ul_jvz_fr2_42c} 데이터 유형: 부울 |
| segment.confirmed_on | 제출된 마무리 세그먼트가 외부 CCaaS 시스템에서 처리되는 날짜 및 시간입니다. 데이터 유형: 문자열 |
| 세그먼트.외부 | 상호작용 세그먼트가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 상호작용 세그먼트가 외부 시스템에서 온 것입니다. * false: 상호작용 세그먼트가 내부입니다. {#wrap-up-GET-segment-agent-int__ul_hh5_pwl_m2c} 데이터 유형: 부울 기본값: false |
| 세그먼트.상호작용 | 상호작용의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
| segment.opened_on | 외부 시스템에 따른 마무리 기간의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 |
| 세그먼트.분할됨 | 마무리가 분할되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리가 여러 부분으로 분할됩니다. * false: 마무리는 하나의 완전한 세그먼트입니다. {#wrap-up-GET-segment-agent-int__ul_hpy_wxl_m2c} 데이터 유형: 부울 기본값: false |
| segment.segment_id | 상호작용 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 |
| segment.segment_table | 상호작용 세그먼트가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 |
| 세그먼트.상태 | 상호작용 세그먼트의 상태입니다. 데이터 유형: 문자열 |
| segment.submitted_on | 에이전트가 마무리 세그먼트를 제출한 날짜 및 시간입니다. 데이터 유형: 문자열 |
| segment.sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
| segment.wrap_up_configuration | 마무리 세그먼트에 사용되는 마무리 구성에 대한 상세 정보를 포함하는 객체입니다. 데이터 유형: 객체 "wrap_up_configuration": { "allowed_codes": [Array], "default_code": {Object}, "enable_codes": Boolean } |
| segment.wrap_up_configuration.allowed_codes | 에이전트가 사용할 수 있는 마무리 코드를 나타내는 객체의 배열입니다. 데이터 유형: 배열 "allowed_codes": [ { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } ] |
| segment.wrap_up_configuration.allowed_codes.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-GET-segment-agent-int__ul_gfl_mbf_m2c} 데이터 유형: 부울 기본값: true |
| segment.wrap_up_configuration.allowed_codes.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-GET-segment-agent-int__ul_hh5_pwl_3} 데이터 유형: 부울 |
| segment.wrap_up_configuration.allowed_codes.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.wrap_up_configuration.allowed_codes.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code | 기본값으로 사용할 마무리 코드가 포함된 객체입니다. 데이터 유형: 객체 "default_code": { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } |
| segment.wrap_up_configuration.default_code.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-GET-segment-agent-int__d3307e182} 데이터 유형: 부울 기본값: true |
| segment.wrap_up_configuration.default_code.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-GET-segment-agent-int__d3307e394} 데이터 유형: 부울 |
| segment.wrap_up_configuration.default_code.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.wrap_up_configuration.default_code.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.enable_ai_code | 이 구성에 대해 AI 코드 생성이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 이 구성에 대해 AI 코드 생성이 활성화되어 있습니다. * 아니오: 이 구성에서는 AI 코드 생성을 사용할 수 없습니다. {#wrap-up-GET-segment-agent-int__ul_l14_pxl_v3c} 데이터 유형: 부울 |
| segment.wrap_up_configuration.enable_ai_notes | 이 구성에 대해 AI 메모 생성이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 이 구성에 대해 AI 메모 생성이 활성화되어 있습니다. * 아니오: 이 구성에서는 AI 메모 생성을 사용할 수 없습니다. {#wrap-up-GET-segment-agent-int__ul_xxf_qxl_v3c} 데이터 유형: 부울 |
| segment.wrap_up_configuration.enable_codes | 에이전트가 마무리 코드를 선택해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 에이전트가 마무리 코드를 선택해야 합니다. * false: 에이전트가 마무리 코드를 선택할 필요가 없습니다. {#wrap-up-GET-segment-agent-int__ul_s3z_45r_m2c} 데이터 유형: 부울 기본값: false |
| segment.wrap_up_configuration.use_ai_as_default | AI 코드가 이 구성에 대한 기본 마무리 코드로 자동 설정되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: AI 코드가 자동으로 기본 마무리 코드로 설정됩니다. * false: AI 코드가 자동으로 기본 마무리 코드로 설정되지 않습니다. {#wrap-up-GET-segment-agent-int__ul_qyf_qxl_v3c} 데이터 유형: 부울 |
| segment.wrap_up_configuration.use_third_party_ai | AI 콘텐츠 소스가 외부 공급업체 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: AI 콘텐츠 소스가 외부 공급업체 외부 시스템에서 제공됩니다. * 아니오: Now Assist AI 컨텐츠 소스입니다. {#wrap-up-GET-segment-agent-int__ul_hzf_qxl_v3c} 데이터 유형: 부울 |
| segment_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
| 성공 | API 요청이 성공적으로 처리되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: API 요청이 성공했습니다. * false: API 요청이 실패했습니다. {#wrap-up-GET-segment-agent-int__ul_mdm_tff_m2c} 데이터 유형: 부울 |
[ ]

{#wrap-up-GET-segment-agent-int__table_xpr_b42_42c}  

### cURL 요청

이 예에서는 지정된 에이전트 및 상호작용을 기반으로 마무리 세그먼트의 상세 정보를 검색합니다.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/agent/123412345678567890ab90abcdefcdef/interaction/213412345678567890ab90abcdefcdef" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

응답 본문.

    {
      "success": true,
      "message": "Wrap up segment retrieved successfully.",
      "segment_id": "dgajbcef12345678defdbxef123435678",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "segment_table": "sn_openframe_phone_log",
        "segment_id": "dgajbcef12345678defdbxef123435678",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "closed",
        "wrap_up_configuration": {
          "enable_codes": true,
          "allowed_codes": [
            {
              "code": "Billing Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": ""
            },
            {
              "code": "Store Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "54327b679f201210c89656effa0a1cd7",
              "translated_code": " Einkaufsproblem",
              "translated_description": ""
            }
          ],
          "default_code": {
            "code": "Billing Issue",
            "description": "",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": ""
          }
        },
        "segmented": true,
        "sys_id": "dgajbcef12345678defdbxef123435678",
        "opened_on": "2024-09-16 17:52:01",
        "submitted_on": "2024-09-16 18:51:59",
        "confirmed_on": "2024-09-16 18:52:01",
        "awaiting_confirmation": false
      }
    }

### cURL 요청 {#wrap-up-GET-segment-agent-int__example_snz_c5m_v3c}

이 예에서는 AI 권장 사항에 대해 구성된 마무리 세그먼트에 대한 상세 정보를 검색합니다.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/agent/987698761234123456xy12ghijklmnoqrst/interaction/879065432198432109xy34mnopqrstuv" \
    --request GET \
    --header "Accept:application/json" \
    --user 'username':'password'

응답 본문.

    {
      "success": true,
      "segment": {
        "ai_wrap_up_code": "Billing Issue",
        "ai_notes": "Customer called about incorrect charge.",
        "ai_code_defined_at": "1752252703000",
        "ai_notes_defined_at": "1752252703000",
        "wrap_up_configuration": {
          "enable_ai_code": true,
          "enable_ai_notes": true,
          "use_ai_as_default": true,
          "use_third_party_ai": false
        }
      }
    }

## 마무리 - POST /now/wrapup/code {#ariaid-title5}

마무리 코드를 생성하거나 업데이트합니다.
마무리 코드는 상호작용 마무리 코드 \[interaction_wrap_up_code\] 테이블에서 생성됩니다.

### URL 형식

버전이 지정된 URL: /api/now/{api_version}/wrapup/code

기본 URL: /api/now/wrapup/code

### 지원되는 요청 매개변수

{#wrap-up-POST-code__entry__2}{#wrap-up-POST-code__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 19. 경로 매개변수]

{#wrap-up-POST-code__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 20. 쿼리 매개변수]

{#wrap-up-POST-code__entry__10}

| 이름 | 설명 |
|-|-|
| 코드 | 필수 각각 마무리 코드를 나타내는 객체의 배열입니다. 데이터 유형: 배열 "codes": [ { "active": Boolean, "code": "String", "description": "String", "translations": [Array] } ] |
| 코드.활성 | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-POST-code__ul_gfl_mbf_m2c} 데이터 유형: 부울 기본값: true |
| 코드.코드 | 필수 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| 코드.설명 | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| 코드.번역 | 각각 마무리 코드의 번역을 나타내는 객체의 배열입니다. 데이터 유형: 배열 "translations": [ { "code": "Abrechnungsproblem", "description": "Ein code für Abrechnungsprobleme", "language": "de" } ] |
| 코드.번역.코드 | 마무리 코드 레이블()codes.code의 번역입니다. 매개변수를 사용하는 경우 필수입니다 codes.translations . 데이터 유형: 문자열 |
| 코드.번역.설명 | 마무리 코드 설명()codes.description의 번역입니다. 매개변수를 codes.translations 사용하고 값이 제공된 경우 필수입니다.codes.description 데이터 유형: 문자열 |
| 코드.번역.언어 | 번역에 사용된 언어를 나타내는 두 글자 코드입니다. 매개변수를 사용하는 경우 필수입니다 codes.translations . 데이터 유형: 문자열 |
[표 21. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-POST-code__entry__28}{#wrap-up-POST-code__accept-RESTAPI}{#wrap-up-POST-code__content_type-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 22. 요청 헤더]

{#wrap-up-POST-code__entry__34}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 23. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-POST-code__table_szp_xy2_42c__entry__2}{#wrap-up-POST-code__entry-200-status-code}{#wrap-up-POST-code__entry-400-status-code}{#wrap-up-POST-code__entry-401-status-code}{#wrap-up-POST-code__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 207 | 성공입니다. 일부 마무리 코드가 성공적으로 생성되었습니다. 다른 항목을 생성하는 동안 확인 오류가 발생했습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 24. 상태 코드]

{#wrap-up-POST-code__table_szp_xy2_42c}

### 응답 본문 매개변수(JSON 또는 XML)

{#wrap-up-POST-code__entry__50}{#wrap-up-POST-code__message}{#wrap-up-POST-code__codes-code-desc-ph}{#wrap-up-POST-code__success}

| 이름 | 설명 |
|-|-|
| 결과 | API 요청 및 생성된 마무리 코드에 대한 정보를 포함하는 객체입니다. 데이터 유형: 객체 "result": { "message": "String", "resultMap": {Object}, "success": Boolean } |
| 결과.메시지 | API 요청의 결과를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| result.result_map | 생성된 마무리 코드의 배열을 포함하는 객체입니다. 데이터 유형: 객체 "result_map": { "created_wrap_up_codes": [Array] } |
| result.result_map.created_wrap_up_codes | 각각 생성된 마무리 코드를 나타내는 객체의 배열입니다. 데이터 유형: 배열 "created_wrap_up_codes": [ { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } ] |
| result.result_map.created_wrap_up_codes.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-POST-code__d3307e182} 데이터 유형: 부울 기본값: true |
| result.result_map.created_wrap_up_codes.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| result.result_map.created_wrap_up_codes.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| result.result_map.created_wrap_up_codes.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-POST-code__ul_hh5_pwl_3} 데이터 유형: 부울 |
| result.result_map.created_wrap_up_codes.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| result.result_map.created_wrap_up_codes.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| result.result_map.created_wrap_up_codes.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| 결과.성공 | API 요청이 성공적으로 처리되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: API 요청이 성공했습니다. * false: API 요청이 실패했습니다. {#wrap-up-POST-code__ul_mdm_tff_m2c} 데이터 유형: 부울 |
[ ]

### cURL 요청

이 예에서는 독일어 번역을 사용하여 청구 문제에 대한 마무리 코드를 생성합니다.

    curl "https://instance.service-now.com/api/now/v1/wrapup/code" \
    --request POST \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"codes\": [
        {
          \"code\": \"Billing Issue\",
          \"description\": \"A code for billing issues\",
          \"translations\": [
            {
              \"language\": \"de\",
              \"code\": \"Abrechnungsproblem\",
              \"description\": \"Ein code für Abrechnungsprobleme\"
            }
          ]
        }
      ]
    }" \
    --user 'username':'password'

응답 본문.

    {
      "result": {
        "message": "All wrap up codes created successfully.",
        "result_map": {
          "created_wrap_up_codes": [
            {
              "code": "Billing Issue",
              "description": "A code for billing issues",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": "Ein code für Abrechnungsprobleme"
            }
          ]
        },
        "success": true
      }
    }

## 마무리 - POST /now/wrapup/segment/create {#ariaid-title6}

상호작용에 대한 마무리 세그먼트를 엽니다.
마무리는 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] 테이블에 생성됩니다. 마무리 기간이 시작될 때 이 엔드포인트를 호출합니다.

이 엔드포인트는 요청 페이로드에서 직접 AI가 생성한 마무리 코드 및 메모를 지원하며 마무리 구성에 AI 구성 플래그를 저장합니다. 가 아니오로 설정되고 구성에서 AI 코드 또는 메모가 활성화된 경우 external 세그먼트가 생성된 후 동기 비즈니스 규칙이 실행됩니다. 이 엔드포인트는 내부 CSM(NowAssist) API를 호출하고 AI 필드를 자동으로 채웁니다. 호출자의 추가 조치가 필요하지 않습니다.

### URL 형식

버전이 지정된 URL: /api/now/{api_version}/wrapup/segment/create

기본 URL: /api/now/wrapup/segment/create

### 지원되는 요청 매개변수

{#wrap-up-POST-segment-create__entry__2}{#wrap-up-POST-segment-create__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 25. 경로 매개변수]

{#wrap-up-POST-segment-create__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 26. 쿼리 매개변수]

{#wrap-up-POST-segment-create__entry__10}{#wrap-up-POST-segment-create__external-seg}

| 이름 | 설명 |
|-|-|
| agent_sys_id | 필수 상호작용에 할당된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| ai_wrap_up_code | AI가 제안하는 마무리 코드 레이블입니다. 값이 use_third_party_aifalse이거나 구성에 필드가 없는 경우 자동으로 Now Assist 채워집니다. 참조 : * [GET /now/wrapup/segment/{segment_id}](https://servicenow-prod.fluidtopics.net/sXAQaO26rhu9gs8ntAiruQ#wrap-up-GET-segment "지정된 마무리 세그먼트에 대한 상세 정보를 검색합니다.") * [PUT /api/now/wrapup/segment/update/ai](https://servicenow-prod.fluidtopics.net/sXAQaO26rhu9gs8ntAiruQ#wrap-up-PUT-segment-update-ai "AI가 권장하는 마무리 코드 및 메모로 기존 열린 마무리 세그먼트를 업데이트합니다.") {#wrap-up-POST-segment-create__ul_pvm_dmm_v3c} 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] 데이터 유형: 문자열 |
| ai_notes | AI가 생성한 메모. 최대 길이: 4000자 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] 데이터 유형: 문자열 |
| 구성 | 외부 마무리에 대한 코드 및 기간 상세 정보를 포함하는 객체입니다. 예`일 경우`external 필요합니다. 데이터 유형: 객체 "configuration": { "allowed_codes": [Array], "default_code": "String", "duration": "String", "enable_codes": Boolean, "enable_ai_code": Boolean, "enable_ai_notes": Boolean, "show_timer": Boolean, "use_ai_as_default": Boolean } |
| configuration.allowed_codes | 에이전트가 사용할 수 있는 마무리 코드를 나타내는 객체의 배열입니다. 과 둘 configuration.enable_codes 다 `예`일 경우 external 필요합니다. 데이터 유형: 배열 "allowed_codes": [ { "code": "String", "translation": {Object} } ] |
| configuration.allowed_codes.code | 마무리 코드의 레이블입니다.매개변수를 사용하는 경우 필요합니다.configuration.allowed_codes 데이터 유형: 문자열 |
| configuration.allowed_codes.번역 | 마무리 코드의 번역입니다. 데이터 유형: 객체 "translation": { "code": "String", "language": "String" } |
| configuration.allowed_codes.translation.code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| configuration.allowed_codes.번역.언어 | 번역에 사용된 언어를 나타내는 두 글자 코드입니다. 데이터 유형: 문자열 |
| configuration.default_code | 기본값으로 사용할 마무리 코드의 레이블입니다. 과 둘 configuration.enable_codes 다 `예`일 경우 external 필요합니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] 필드: 코드 |
| configuration.duration | 허용되는 최대 마무리 기간입니다. 와 함께 show_timer사용해야 합니다. 데이터 유형: 문자열 단위: 초 기본값: 빈 문자열(시간 제한 없음). |
| configuration.enable_codes | 에이전트가 마무리 코드를 선택해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 에이전트가 마무리 코드를 선택해야 합니다. * false: 에이전트가 마무리 코드를 선택할 필요가 없습니다. {#wrap-up-POST-segment-create__d3307e228} 데이터 유형: 부울 기본값: false |
| configuration.enable_ai_code | 이 구성에 대해 AI 코드 생성이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 이 구성에 대해 AI 코드 생성이 활성화되어 있습니다. * 아니오: 이 구성에서는 AI 코드 생성을 사용할 수 없습니다. {#wrap-up-POST-segment-create__ul_l14_pxl_v3c}테이블: 상호작용 마무리 구성 \[interaction_wrap_up_configuration\] 데이터 유형: 부울 기본값: false |
| configuration.enable_ai_notes | 이 구성에 대해 AI 메모 생성이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 이 구성에 대해 AI 메모 생성이 활성화되어 있습니다. * 아니오: 이 구성에서는 AI 메모 생성을 사용할 수 없습니다. {#wrap-up-POST-segment-create__ul_xxf_qxl_v3c}테이블: 상호작용 마무리 구성 \[interaction_wrap_up_configuration\] 데이터 유형: 부울 기본값: false |
| configuration.use_ai_as_default | AI 코드가 이 구성에 대한 기본 마무리 코드로 자동 설정되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: AI 코드가 자동으로 기본 마무리 코드로 설정됩니다. * false: AI 코드가 자동으로 기본 마무리 코드로 설정되지 않습니다. {#wrap-up-POST-segment-create__ul_qyf_qxl_v3c}테이블: 상호작용 마무리 구성 \[interaction_wrap_up_configuration\] 데이터 유형: 부울 기본값: false |
| configuration.show_timer | duration 속성을 사용할 때 필요합니다. 타이머가 표시되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: UI에 타이머가 표시됩니다. * false: 타이머가 UI에 표시되지 않습니다. {#wrap-up-POST-segment-create__ul_s3z_45r_m2c} 데이터 유형: 부울 기본값: false |
| 외부 | 상호작용 세그먼트가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 상호작용 세그먼트가 외부 시스템에서 온 것입니다. * false: 상호작용 세그먼트가 내부입니다. {#wrap-up-POST-segment-create__ul_hh5_pwl_m2c} 데이터 유형: 부울 기본값: false |
| external_segment_id | 외부 시스템의 상호작용 세그먼트를 나타내는 식별자입니다. 예`일 경우`external 필요합니다. 데이터 유형: 문자열 |
| interaction_sys_id | 필수 상호작용의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
| opened_on | 외부 시스템에 따른 마무리 기간의 시작 날짜 및 시간입니다.매개변수를 사용하는 경우 필요합니다.configuration.duration 데이터 유형: 문자열 |
| 분할됨 | 마무리가 분할되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리가 여러 부분으로 분할됩니다. * false: 마무리는 하나의 완전한 세그먼트입니다. {#wrap-up-POST-segment-create__ul_hpy_wxl_m2c} 데이터 유형: 부울 기본값: false |
| segment_id | 상호작용 세그먼트의 Sys_id입니다. 과 둘 segmented 다 `예`일 경우 external 필요합니다. 주: 선택한 테이블에 세그먼트 기록을 만들고 검색하려면 InteractionSegment 스크립트로 작성된 확장점을 구현하거나 [OpenFrame](https://www.servicenow.com/docs/access?context=c_OpenFrameOverview&version=australia&pubname=australia-customer-service-management&ft:locale=en-US) 구현을 사용하여 전화 로그\[sn_openframe_phone_log\] 테이블에 세그먼트 기록을 만들고 검색해야 합니다. 데이터 유형: 문자열 |
| segment_table | 상호작용 세그먼트가 포함된 테이블의 이름입니다. 과 둘 segmented 다 `예`일 경우 external 필요합니다. 데이터 유형: 문자열 |
| wrap_up_configuration_sys_id | 사용할 마무리 구성의 Sys_id입니다. false`인 경우`external 필요합니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 구성 \[interaction_wrap_up_configuration\] |
[표 27. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-POST-segment-create__table_r5j_h1f_42c__entry__2}{#wrap-up-POST-segment-create__accept-RESTAPI}{#wrap-up-POST-segment-create__content_type-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 28. 요청 헤더]

{#wrap-up-POST-segment-create__table_r5j_h1f_42c} {#wrap-up-POST-segment-create__entry__66}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 29. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-POST-segment-create__table_sft_vy2_42c__entry__2}{#wrap-up-POST-segment-create__entry-200-status-code}{#wrap-up-POST-segment-create__entry-400-status-code}{#wrap-up-POST-segment-create__entry-401-status-code}{#wrap-up-POST-segment-create__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 30. 상태 코드]

{#wrap-up-POST-segment-create__table_sft_vy2_42c}

### 응답 본문 매개변수(JSON 또는 XML)

{#wrap-up-POST-segment-create__entry__80}{#wrap-up-POST-segment-create__codes-code-desc-ph}{#wrap-up-POST-segment-create__d3307e202}

| 이름 | 설명 |
|-|-|
| 메시지 | API 요청의 결과를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| 세그먼트 | 상호작용 및 마무리 세그먼트에 대한 데이터를 포함하는 객체입니다. 데이터 유형: 객체 "segment": { "agent": "String", "external": Boolean, "interaction": "String", "opened_on": "String", "segmented": Boolean, "segment_id": "String", "segment_table": "String", "state": "String", "sys_id": "String", "wrap_up_configuration": {Object} } |
| 세그먼트.에이전트 | 상호작용 세그먼트에 할당된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| 세그먼트.외부 | 상호작용 세그먼트가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 상호작용 세그먼트가 외부 시스템에서 온 것입니다. * false: 상호작용 세그먼트가 내부입니다. {#wrap-up-POST-segment-create__d3307e251} 데이터 유형: 부울 기본값: false |
| 세그먼트.상호작용 | 상호작용의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
| segment.opened_on | 외부 시스템에 따른 마무리 기간의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 |
| 세그먼트.분할됨 | 마무리가 분할되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리가 여러 부분으로 분할됩니다. * false: 마무리는 하나의 완전한 세그먼트입니다. {#wrap-up-POST-segment-create__d3307e296} 데이터 유형: 부울 기본값: false |
| segment.segment_id | 상호작용 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 |
| segment.segment_table | 상호작용 세그먼트가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 |
| 세그먼트.상태 | 상호작용 세그먼트의 상태입니다. 마무리 API가 성공적으로 생성한 상호작용 세그먼트는 열림 상태입니다. 데이터 유형: 문자열 |
| segment.sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
| segment.wrap_up_configuration | 마무리 세그먼트에 사용되는 마무리 구성에 대한 상세 정보를 포함하는 객체입니다. 데이터 유형: 객체 "wrap_up_configuration": { "allowed_codes": [Array], "default_code": {Object}, "enable_ai_code": Boolean, "enable_ai_notes": Boolean, "enable_codes": Boolean, "use_ai_as_default": Boolean, "use_third_party_ai": Boolean } |
| segment.wrap_up_configuration.allowed_codes | 에이전트가 사용할 수 있는 마무리 코드를 나타내는 객체의 배열입니다. 데이터 유형: 배열 "allowed_codes": [ { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } ] |
| segment.wrap_up_configuration.allowed_codes.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-POST-segment-create__ul_gfl_mbf_m2c} 데이터 유형: 부울 기본값: true |
| segment.wrap_up_configuration.allowed_codes.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-POST-segment-create__ul_hh5_pwl_3} 데이터 유형: 부울 |
| segment.wrap_up_configuration.allowed_codes.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.wrap_up_configuration.allowed_codes.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code | 기본값으로 사용할 마무리 코드가 포함된 객체입니다. 데이터 유형: 객체 "default_code": { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } |
| segment.wrap_up_configuration.default_code.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-POST-segment-create__d3307e182} 데이터 유형: 부울 기본값: true |
| segment.wrap_up_configuration.default_code.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-POST-segment-create__d3307e394} 데이터 유형: 부울 |
| segment.wrap_up_configuration.default_code.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.wrap_up_configuration.default_code.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.enable_ai_code | 이 구성에 대해 AI 코드 생성이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 이 구성에 대해 AI 코드 생성이 활성화되어 있습니다. * 아니오: 이 구성에서는 AI 코드 생성을 사용할 수 없습니다. {#wrap-up-POST-segment-create__d3307e593} 데이터 유형: 부울 |
| segment.wrap_up_configuration.enable_ai_notes | 이 구성에 대해 AI 메모 생성이 활성화되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * 예: 이 구성에 대해 AI 메모 생성이 활성화되어 있습니다. * 아니오: 이 구성에서는 AI 메모 생성을 사용할 수 없습니다. {#wrap-up-POST-segment-create__d3307e614} 데이터 유형: 부울 |
| segment.wrap_up_configuration.enable_codes | 에이전트가 마무리 코드를 선택해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 에이전트가 마무리 코드를 선택해야 합니다. * false: 에이전트가 마무리 코드를 선택할 필요가 없습니다. {#wrap-up-POST-segment-create__d3307e228} 데이터 유형: 부울 기본값: false |
| segment.wrap_up_configuration.use_ai_as_default | AI 코드가 이 구성에 대한 기본 마무리 코드로 자동 설정되는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: AI 코드가 자동으로 기본 마무리 코드로 설정됩니다. * false: AI 코드가 자동으로 기본 마무리 코드로 설정되지 않습니다. {#wrap-up-POST-segment-create__d3307e635} 데이터 유형: 부울 |
| segment.wrap_up_configuration.use_third_party_ai | AI 콘텐츠 소스가 외부 공급업체 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: AI 콘텐츠 소스가 외부 공급업체 외부 시스템에서 제공됩니다. * 아니오: Now Assist AI 컨텐츠 소스입니다. {#wrap-up-POST-segment-create__ul_hzf_qxl_v3c} 데이터 유형: 부울 |
| 성공 | API 요청이 성공적으로 처리되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: API 요청이 성공했습니다. * false: API 요청이 실패했습니다. {#wrap-up-POST-segment-create__ul_mdm_tff_m2c} 데이터 유형: 부울 |
| sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
[ ]

### cURL 요청

이 예에서는 상호작용에 대한 마무리 세그먼트를 엽니다.

    curl --request POST \
      --url 'https://instance.servicenow.com/api/now/wrapup/segment/create' \
      --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --user 'username:password' \
      --data '{
        "agent_sys_id": "123412345678567890ab90abcdefcdef",
        "interaction_sys_id": "213412345678567890ab90abcdefcdef",
        "external": true,
        "external_segment_id": "EXT-SEG-001",
        "ai_wrap_up_code": "Billing Issue",
        "ai_notes": "Customer called about an incorrect charge on their invoice.",
        "configuration": {
          "enable_codes": true,
          "enable_ai_code": true,
          "enable_ai_notes": true,
          "use_ai_as_default": true,
          "allowed_codes": [{"code": "Billing Issue"}, {"code": "Store Issue"}],
          "default_code": "Billing Issue"
        }
      }'

    --user 'username':'password'

응답 본문.

    {
      "success": true,
      "message": "Wrap-up segment created successfully.",
      "sys_id": "abcd1234abcd1234abcd1234abcd1234",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "open",
        "sys_id": "abcd1234abcd1234abcd1234abcd1234",
        "wrap_up_configuration": {
          "enable_codes": true,
          "enable_ai_code": true,
          "enable_ai_notes": true,
          "use_ai_as_default": true,
          "allowed_codes": [...],
          "default_code": {...}
        }
      }
    }

### cURL 요청 {#wrap-up-POST-segment-create__example_hbt_lvm_v3c}

이 예에서는 AI 권장 사항에 대해 구성된 마무리 세그먼트를 엽니다.

    curl --request POST \
      --url 'https://instance.servicenow.com/api/now/wrapup/segment/create' \
      --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --user 'username:password' \
      --data '{
        "agent_sys_id": "123412345678567890ab90abcdefcdef",
        "interaction_sys_id": "213412345678567890ab90abcdefcdef",
        "external": true,
        "external_segment_id": "EXT-SEG-001",
        "ai_wrap_up_code": "Billing Issue",
        "ai_notes": "Customer called about an incorrect charge on their invoice.",
        "configuration": {
          "enable_codes": true,
          "enable_ai_code": true,
          "enable_ai_notes": true,
          "use_ai_as_default": true,
          "allowed_codes": [{"code": "Billing Issue"}, {"code": "Store Issue"}],
          "default_code": "Billing Issue"
        }
      }'

응답 본문.

    {
      "success": true,
      "message": "Wrap-up segment created successfully.",
      "sys_id": "abcd1234abcd1234abcd1234abcd1234",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "open",
        "sys_id": "abcd1234abcd1234abcd1234abcd1234",
        "wrap_up_configuration": {
          "enable_codes": true,
          "enable_ai_code": true,
          "enable_ai_notes": true,
          "use_ai_as_default": true,
          "allowed_codes": [...],
          "default_code": {...}
        }
      }
    }

## 마무리 - PUT /now/wrapup/segment/update {#ariaid-title7}

상호작용에 대한 마무리 세그먼트를 업데이트하고 닫습니다.

### URL 형식

버전이 지정된 URL: /api/now/{api_version}/wrapup/segment/update

기본 URL: /api/now/wrapup/segment/update

### 지원되는 요청 매개변수

{#wrap-up-PUT-segment-update__entry__2}{#wrap-up-PUT-segment-update__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 31. 경로 매개변수]

{#wrap-up-PUT-segment-update__entry__6}

| 이름 | 설명 |
|-|-|
| agent_sys_id | 상호작용에 할당된 에이전트의 Sys_id입니다. 또한 둘 다 segment_sys_idexternal_segment_id 제공되지 않는 경우 및 interaction_sys_id 함께 필요합니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| external_segment_id | 외부 시스템의 상호작용 세그먼트를 나타내는 식별자입니다. 제공되지 않은 경우 segment_sys_id 업데이트할 마무리 세그먼트를 식별하는 데 사용됩니다. |
| interaction_sys_id | 상호작용의 Sys_id입니다. 또한 둘 다 segment_sys_idexternal_segment_id 제공되지 않는 경우 및 agent_sys_id 함께 필요합니다. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
| segment_sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
[표 32. 쿼리 매개변수]

{#wrap-up-PUT-segment-update__entry__16}

| 이름 | 설명 |
|-|-|
| confirmed_on | 외부 시스템에 따른 마무리 기간의 종료 날짜 및 시간입니다. 데이터 유형: 문자열 |
| 메모 | 에이전트가 마무리에 추가한 추가 메모입니다. 데이터 유형: 문자열 |
| wrap_up_code | 에이전트가 선택한 마무리 코드의 레이블입니다. 에이전트가 코드를 선택하지 않으면 구성된 기본 코드가 사용됩니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] 필드: 코드 |
[표 33. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-PUT-segment-update__table_ubl_j1f_42c__entry__2}{#wrap-up-PUT-segment-update__accept-RESTAPI}{#wrap-up-PUT-segment-update__content_type-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 34. 요청 헤더]

{#wrap-up-PUT-segment-update__table_ubl_j1f_42c} {#wrap-up-PUT-segment-update__entry__30}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 35. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-PUT-segment-update__table_ktx_5y2_42c__entry__2}{#wrap-up-PUT-segment-update__entry-200-status-code}{#wrap-up-PUT-segment-update__entry-400-status-code}{#wrap-up-PUT-segment-update__entry-401-status-code}{#wrap-up-PUT-segment-update__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 36. 상태 코드]

{#wrap-up-PUT-segment-update__table_ktx_5y2_42c}

### 응답 본문 매개변수(JSON 또는 XML)

{#wrap-up-PUT-segment-update__table_xpr_b42_42c__entry__2}{#wrap-up-PUT-segment-update__segment-agent}{#wrap-up-PUT-segment-update__codes-code-desc-ph}{#wrap-up-PUT-segment-update__interaction-id}{#wrap-up-PUT-segment-update__d3307e202}{#wrap-up-PUT-segment-update__d3307e202}

| 이름 | 설명 |
|-|-|
| 메시지 | API 요청의 결과를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| 세그먼트 | 상호작용 및 마무리 세그먼트에 대한 데이터를 포함하는 객체입니다. 데이터 유형: 객체 "segment": { "agent": "String", "awaiting_confirmation": Boolean, "code": {Object}, "confirmed_on": "String", "external": Boolean, "interaction": "String", "notes": "String", "opened_on": "String", "segmented": Boolean, "segment_id": "String", "segment_table": "String", "state": "String", "submitted_on": "String", "sys_id": "String", "wrap_up_configuration": {Object} } |
| 세그먼트.에이전트 | 상호작용에 할당된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| segment.awaiting_confirmation | 에이전트가 제출한 마무리 세그먼트가 외부 CCaaS 시스템에서 처리되었는지 확인을 기다리고 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 세그먼트가 확인 대기 중입니다. * false: 마무리 세그먼트가 외부 시스템에서 처리되었습니다. {#wrap-up-PUT-segment-update__ul_jvz_fr2_42c} 데이터 유형: 부울 |
| 세그먼트.코드 | 에이전트가 선택한 마무리 코드를 포함하는 객체입니다. 데이터 유형: 객체 "code": { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } |
| segment.code.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-PUT-segment-update__ul_gfl_mbf_m2c} 데이터 유형: 부울 기본값: true |
| 세그먼트.코드.코드 | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| 세그먼트.코드.설명 | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| 세그먼트.코드.외부 | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-PUT-segment-update__ul_hh5_pwl_3} 데이터 유형: 부울 |
| segment.code.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.code.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.code.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.confirmed_on | 제출된 마무리 세그먼트가 외부 CCaaS 시스템에서 처리되는 날짜 및 시간입니다. 데이터 유형: 문자열 |
| 세그먼트.외부 | 상호작용 세그먼트가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 상호작용 세그먼트가 외부 시스템에서 온 것입니다. * false: 상호작용 세그먼트가 내부입니다. {#wrap-up-PUT-segment-update__ul_hh5_pwl_m2c} 데이터 유형: 부울 기본값: false |
| 세그먼트.상호작용 | 상호작용의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
| 세그먼트.메모 | 에이전트가 마무리에 추가한 추가 메모입니다. 데이터 유형: 문자열 |
| segment.opened_on | 외부 시스템에 따른 마무리 기간의 시작 날짜 및 시간입니다. 데이터 유형: 문자열 |
| 세그먼트.분할됨 | 마무리가 분할되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리가 여러 부분으로 분할됩니다. * false: 마무리는 하나의 완전한 세그먼트입니다. {#wrap-up-PUT-segment-update__ul_hpy_wxl_m2c} 데이터 유형: 부울 기본값: false |
| segment.segment_id | 상호작용 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 |
| segment.segment_table | 상호작용 세그먼트가 포함된 테이블의 이름입니다. 데이터 유형: 문자열 |
| 세그먼트.상태 | 상호작용 세그먼트의 상태입니다. 이 엔드포인트가 성공적으로 업데이트한 상호작용 세그먼트가 종결 상태입니다. 데이터 유형: 문자열 |
| segment.submitted_on | 에이전트가 마무리 세그먼트를 제출한 날짜 및 시간입니다. 데이터 유형: 문자열 |
| segment.sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
| segment.wrap_up_configuration | 마무리 세그먼트에 사용되는 마무리 구성에 대한 상세 정보를 포함하는 객체입니다. 데이터 유형: 객체 "wrap_up_configuration": { "allowed_codes": [Array], "default_code": {Object}, "enable_codes": Boolean } |
| segment.wrap_up_configuration.allowed_codes | 에이전트가 사용할 수 있는 마무리 코드를 나타내는 객체의 배열입니다. 데이터 유형: 배열 "allowed_codes": [ { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } ] |
| segment.wrap_up_configuration.allowed_codes.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-PUT-segment-update__d3307e182} 데이터 유형: 부울 기본값: true |
| segment.wrap_up_configuration.allowed_codes.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-PUT-segment-update__d3307e394} 데이터 유형: 부울 |
| segment.wrap_up_configuration.allowed_codes.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.wrap_up_configuration.allowed_codes.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.allowed_codes.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code | 기본값으로 사용할 마무리 코드가 포함된 객체입니다. 데이터 유형: 객체 "default_code": { "active": Boolean, "code": "String", "description": "String", "external": Boolean, "sys_id": "String", "translated_code": "String", "translated_description": "String" } |
| segment.wrap_up_configuration.default_code.active | 마무리 코드가 활성 상태인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 활성 상태입니다. * false: 마무리 코드가 활성 상태가 아닙니다. {#wrap-up-PUT-segment-update__d3307e182} 데이터 유형: 부울 기본값: true |
| segment.wrap_up_configuration.default_code.code | 마무리 코드의 레이블입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.description | 마무리 코드에 대한 설명입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.external | 마무리 코드가 외부 시스템에서 온 것인지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 마무리 코드가 외부 시스템에서 온 것입니다. * false: 마무리 코드가 내부입니다. {#wrap-up-PUT-segment-update__d3307e394} 데이터 유형: 부울 |
| segment.wrap_up_configuration.default_code.sys_id | 마무리 코드의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 코드 \[interaction_wrap_up_code\] |
| segment.wrap_up_configuration.default_code.translated_code | 마무리 코드 레이블의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.default_code.translated_description | 마무리 코드 설명의 번역입니다. 데이터 유형: 문자열 |
| segment.wrap_up_configuration.enable_codes | 에이전트가 마무리 코드를 선택해야 하는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 에이전트가 마무리 코드를 선택해야 합니다. * false: 에이전트가 마무리 코드를 선택할 필요가 없습니다. {#wrap-up-PUT-segment-update__ul_s3z_45r_m2c} 데이터 유형: 부울 기본값: false |
| 성공 | API 요청이 성공적으로 처리되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: API 요청이 성공했습니다. * false: API 요청이 실패했습니다. {#wrap-up-PUT-segment-update__ul_mdm_tff_m2c} 데이터 유형: 부울 |
| sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
[ ]

{#wrap-up-PUT-segment-update__table_xpr_b42_42c}  

### cURL 요청

이 예에서는 상호작용에 대한 마무리 세그먼트를 업데이트하고 닫습니다.

    curl "https://instance.service-now.com/api/now/v1/wrapup/segment/update?segment_sys_id=98769876543254321fed1fedcba0cba0&agent_sys_id=123412345678567890ab90abcdefcdef&interaction_sys_id=213412345678567890ab90abcdefcde" \
    --request PUT \
    --header "Accept:application/json" \
    --header "Content-Type:application/json" \
    --data "{
      \"wrap_up_code\": \"Billing Issue\",
      \"notes\": \"Customer's credit card expired. Had to switch to another one.\",
      \"confirmed_on\": \"2024-09-16 18:52:01\"
    }" \
    --user 'username':'password'

응답 본문.

    {
      "success": true,
      "message": "Wrap-up segment updated successfully.",
      "sys_id": "98769876543254321fed1fedcba0cba0",
      "segment": {
        "agent": "123412345678567890ab90abcdefcdef",
        "segment_table": "sn_openframe_phone_log",
        "segment_id": "dgajbcef12345678defdbxef123435678",
        "external": true,
        "interaction": "213412345678567890ab90abcdefcdef",
        "state": "closed",
        "wrap_up_configuration": {
          "enable_codes": true,
          "allowed_codes": [
            {
              "code": "Billing Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "49c27b679f201210c89656effa0a1cd7",
              "translated_code": "Abrechnungsproblem",
              "translated_description": ""
            },
            {
              "code": "Store Issue",
              "description": "",
              "active": true,
              "external": true,
              "sys_id": "54327b679f201210c89656effa0a1cd7",
              "translated_code": " Einkaufsproblem",
              "translated_description": ""
            }
          ],
          "default_code": {
            "code": "Billing Issue",
            "description": "",
            "active": true,
            "external": true,
            "sys_id": "49c27b679f201210c89656effa0a1cd7",
            "translated_code": "Abrechnungsproblem",
            "translated_description": ""
          }
        },
        "code": {
          "code": "Billing Issue",
          "description": "",
          "active": true,
          "external": true,
          "sys_id": "49c27b679f201210c89656effa0a1cd7",
          "translated_code": "Abrechnungsproblem",
          "translated_description": ""
        },
        "notes": "Customer's credit card expired. Had to switch to another one.",
        "segmented": true,
        "sys_id": "dgajbcef12345678defdbxef123435678",
        "opened_on": "2024-09-16 17:52:01",
        "submitted_on": "2024-09-16 18:51:59",
        "confirmed_on": "2024-09-16 18:52:01",
        "awaiting_confirmation": false
      }
    }

## 마무리 - PUT /now/wrapup/segment/update/ai {#ariaid-title8}

AI가 권장하는 마무리 코드 및 메모로 기존 열린 마무리 세그먼트를 업데이트합니다.
이 엔드포인트는 AI 콘텐츠를 독립적으로 생성하고 세그먼트 생성 후 플랫폼으로 ServiceNow 푸시하는 외부 CCaaS 시스템을 위한 것입니다. 이 속성은 use_third_party_ai 마무리 구성에서 true 여야 합니다.

enable_ai_code 구성에서 or enable_ai_notes 가 아니오면 해당 AI 필드가 요청 페이로드에 포함된 경우에도 저장됩니다. ai_code_defined_at 및 ai_notes_defined_at 타임스탬프는 저장 시 자동으로 설정됩니다.

AI 마무리 권장 사항

:   AI 마무리 권장 사항은 다음 두 가지 소스에서 나올 수 있습니다.{#wrap-up-PUT-segment-update-ai__ai-wrap-up-intro}

    * 내부(Now Assist): false인 경우 use_third_party_ai 세그먼트 생성 후 비즈니스 규칙이 자동으로 트리거되어 CSM API를 호출하고 및 를 ai_notes채웁니다ai_wrap_up_code.
    * 외부(외부 공급업체/CCaaS): 예인 경우 use_third_party_ai 외부 시스템은 새 PUT /api/now/wrapup/segment/update/ai 엔드포인트를 통해 AI 데이터를 푸시합니다.
    {#wrap-up-PUT-segment-update-ai__ai-sources-list}

사용 케이스
:
    * AI 제안과 함께 마무리 코드 및 메모를 제공하여 에이전트 처리 시간을 단축합니다.
    * CCaaS 플랫폼이 상호작용이 종료된 후 AI 생성 콘텐츠를 푸시할 수 있도록 합니다 ServiceNow AI Platform .
    * 감독자에게 보고 및 분석을 위해 보다 깔끔하고 일관된 마무리 데이터를 제공합니다.
    {#wrap-up-PUT-segment-update-ai__ai-use-cases-list}

AI 지원 마무리 플로우를 위한 엔드포인트 호출 순서
:
    1. POST /api/now/wrapup/segment/create --- 세그먼트를 열거나 / ai_notes 및 AI 구성 플래그를 전달 ai_wrap_up_code 합니다.
    2. PUT /api/now/wrapup/segment/update/ai --- (외부 AI만 해당) AI 권장 사항을 오픈 세그먼트에 푸시합니다.
    3. PUT /api/now/wrapup/segment/update --- 에이전트가 세그먼트를 완료하고 닫습니다.
    4. GET /api/now/wrapup/segment/{segment_id} --- 저장된 AI 필드를 포함한 세그먼트를 검색합니다.
    {#wrap-up-PUT-segment-update-ai__ai-endpoint-order-list}

### URL 형식 {#wrap-up-PUT-segment-update-ai__section_uvv_qqx_53c}

버전이 지정된 URL: /api/now/{api_version}/wrapup/segment/update/ai

기본 URL: /api/now/wrapup/segment/update/ai

### 지원되는 요청 매개변수

{#wrap-up-PUT-segment-update-ai__entry__2}{#wrap-up-PUT-segment-update-ai__version-not_optional-RESTAPI}

| 이름 | 설명 |
|-|-|
| api_version | 옵션입니다. 액세스할 엔드포인트의 버전입니다. 예를 들어 <kbd class="ph userinput">v1</kbd> 또는 <kbd class="ph userinput">v2</kbd>입니다. 최신 버전이 아닌 엔드포인트 버전을 사용하도록 이 값만 지정하십시오. 데이터 유형: 문자열 |
[표 37. 경로 매개변수]

{#wrap-up-PUT-segment-update-ai__entry__6}

| 이름 | 설명 |
|-|-|
| 안 함 |   |
[표 38. 쿼리 매개변수]

{#wrap-up-PUT-segment-update-ai__entry__10}

| 이름 | 설명 |
|-|-|
| agent_sys_id | 상호작용에 할당된 에이전트의 Sys_id입니다. 또는 external_segment_id 둘 다 segment_sys_id 제공되지 않는 경우 필요합니다interaction_sys_id. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| ai_wrap_up_code | AI가 권장하는 마무리 코드 레이블입니다. 구성에서 속성이 enable_ai_codetrue 인 경우에만 저장됩니다.[마무리 - POST /now/wrapup/segment/create](https://servicenow-prod.fluidtopics.net/sXAQaO26rhu9gs8ntAiruQ#wrap-up-POST-segment-create "상호작용에 대한 마무리 세그먼트를 엽니다.") 데이터 유형: 문자열 |
| ai_notes | AI가 생성한 메모. . 구성에서 enable_ai_notes이 true인 경우에만 저장됩니다.[마무리 - POST /now/wrapup/segment/create](https://servicenow-prod.fluidtopics.net/sXAQaO26rhu9gs8ntAiruQ#wrap-up-POST-segment-create "상호작용에 대한 마무리 세그먼트를 엽니다.") 최대 길이: 4000자 데이터 유형: 문자열 |
| interaction_sys_id | 상호작용의 Sys_id입니다. 또는 external_segment_id 둘 다 segment_sys_id 제공되지 않는 경우 필요합니다agent_sys_id. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
| segment_sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
[표 39. 요청 본문 매개변수(XML 또는 JSON)]

### 헤더

다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 고유한 방식으로 이 작업에 적용됩니다. REST API에 사용되는 일반 헤더 목록은 [지원되는 REST API 헤더를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-PUT-segment-update-ai__table_ubl_j1f_42c__entry__2}{#wrap-up-PUT-segment-update-ai__accept-RESTAPI}{#wrap-up-PUT-segment-update-ai__content_type-RESTAPI}

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. 지원되는 유형은 application/json 또는 application/xml입니다. 기본값: application/json |
[표 40. 요청 헤더]

{#wrap-up-PUT-segment-update-ai__table_ubl_j1f_42c} {#wrap-up-PUT-segment-update-ai__entry__28}

| 머리글 | 설명 |
|-|-|
| 안 함 |   |
[표 41. 응답 헤더]

### 상태 코드

이 HTTP 작업에 적용되는 상태 코드는 다음과 같습니다. REST API에 사용되는 가능한 상태 코드 목록은 [REST API HTTP 응답 코드를 참조하십시오.](https://servicenow-prod.fluidtopics.net/1RuriJ1h~LGis5QmeVrYXQ "REST(REpresentational State Transfer)는 웹의 컴퓨터 시스템 간에 표준을 제공하여 서로 더 쉽게 통신할 수 있도록 하는 간단한 상태 비저장 아키텍처입니다.")
{#wrap-up-PUT-segment-update-ai__table_ktx_5y2_42c__entry__2}{#wrap-up-PUT-segment-update-ai__entry-200-status-code}{#wrap-up-PUT-segment-update-ai__entry-400-status-code}{#wrap-up-PUT-segment-update-ai__entry-401-status-code}{#wrap-up-PUT-segment-update-ai__entry-500-status-code}

| 상태 코드 | 설명 |
|-|-|
| 200 | 성공입니다. 요청이 성공적으로 처리되었습니다. |
| 400 | 잘못된 요청입니다. 잘못된 요청 유형 또는 잘못된 형식의 요청이 탐지되었습니다. |
| 401 | 권한이 해제되었습니다. 사용자 자격 증명이 잘못되었거나 전달되지 않았습니다. |
| 500 | 내부 서버 오류입니다. 요청을 처리하는 동안 예기치 않은 오류가 발생했습니다. 응답에는 오류에 대한 추가 정보가 포함되어 있습니다. |
[표 42. 상태 코드]

{#wrap-up-PUT-segment-update-ai__table_ktx_5y2_42c}

### 응답 본문 매개변수(JSON 또는 XML)

{#wrap-up-PUT-segment-update-ai__table_xpr_b42_42c__entry__2}{#wrap-up-PUT-segment-update-ai__segment-agent}{#wrap-up-PUT-segment-update-ai__interaction-id}

| 이름 | 설명 |
|-|-|
| 메시지 | API 요청의 결과를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| 세그먼트 | 상호작용 및 마무리 세그먼트에 대한 데이터를 포함하는 객체입니다. 데이터 유형: 객체 "segment": { "agent": "String", "ai_code_defined_at": "String", "ai_notes": "String", "ai_notes_defined_at": "String", "ai_wrap_up_code": "String", "interaction": "String", "sys_id": "String" } |
| 세그먼트.에이전트 | 상호작용에 할당된 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| segment.ai_code_defined_at | AI 코드가 저장되었을 때의 타임스탬프입니다. 형식: Unix epoch 밀리초(예: "1752252703000") 데이터 유형: 문자열 |
| segment.ai_notes | 세그먼트에 저장된 AI 생성 메모입니다. 데이터 유형: 문자열 |
| segment.ai_notes_defined_at | AI 메모가 저장되었을 때의 타임스탬프입니다. 형식: Unix epoch 밀리초 데이터 유형: 문자열 |
| segment.ai_wrap_up_code | 세그먼트에 저장된 AI 권장 코드입니다. 데이터 유형: 문자열 |
| 세그먼트.상호작용 | 상호작용의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 \[interaction\] |
| segment.sys_id | 마무리 세그먼트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 상호작용 마무리 세그먼트 \[interaction_wrap_up_segment\] |
| 성공 | API 요청이 성공적으로 처리되었는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: API 요청이 성공했습니다. * false: API 요청이 실패했습니다. {#wrap-up-PUT-segment-update-ai__ul_mdm_tff_m2c} 데이터 유형: 부울 |
[ ]

{#wrap-up-PUT-segment-update-ai__table_xpr_b42_42c}  

### cURL 요청

이 예에서는 상호작용에 대한 마무리 세그먼트를 업데이트하고 닫습니다.

    curl --request PUT \
      --url 'https://instance.servicenow.com/api/now/wrapup/segment/update/ai' \
      --header 'Accept: application/json' \
      --header 'Content-Type: application/json' \
      --user 'username:password' \
      --data '{
        "segment_sys_id": "abcd1234abcd1234abcd1234abcd1234",
        "agent_sys_id": "123412345678567890ab90abcdefcdef",
        "interaction_sys_id": "213412345678567890ab90abcdefcdef",
        "ai_wrap_up_code": "Plan Update",
        "ai_notes": "Customer requested an upgrade to the Premium plan."
      }' \
    --user 'username':'password'

응답 본문.

    {
      "success": true,
      "message": "AI wrap-up data updated successfully.",
      "segment": {
        "sys_id": "abcd1234abcd1234abcd1234abcd1234",
        "agent": "123412345678567890ab90abcdefcdef",
        "interaction": "213412345678567890ab90abcdefcdef",
        "ai_wrap_up_code": "Plan Update",
        "ai_notes": "Customer requested an upgrade to the Premium plan.",
        "ai_code_defined_at": "1752252703000",
        "ai_notes_defined_at": "1752252703000"
      }
    }