---
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) 소요 시간: 5분

에이전트 매핑 API는 CCaaS(연락처 센터 서비스형) 시스템의 외부 에이전트 ID를 의 내부 에이전트 IDServiceNow AI Platform로 매핑하는 엔드포인트를 제공합니다.
이 API에는 외부 에이전트 관리 유틸리티 팩(sn_external_agent) 플러그인이 필요합니다. 이 API를 호출하려면 interaction_agent 역할이 있어야 합니다.

CCaaS 시스템과의 통합에 대한 자세한 내용은 다음 문서를 참조하십시오 [Integrating with contact centers](https://www.servicenow.com/docs/access?context=contactcenter-integration&version=australia&pubname=australia-customer-service-management&ft:locale=en-US).

## 에이전트 매핑 - PUT /sn_ct_ctr_it_core/agent_mapping/agent/{agentId}/inboundId/{inboundId} {#ariaid-title2}

CCaaS(연락처 센터 서비스형) 시스템의 외부 에이전트 ID를 의 내부 에이전트 ID에 매핑합니다.ServiceNow AI Platform
에이전트가 CCaaS 시스템에 로그인하거나 로그아웃하여 활성 상태를 업데이트할 때 이 엔드포인트를 호출합니다. 이 엔드포인트는 다음 데이터로 외부 에이전트 매핑 \[external_agent_mapping\] 테이블에 기록을 생성하거나 업데이트합니다.

* 외부 CCaaS 에이전트 ID
* 인바운드 ID와 연결된 제공자 채널 ID
* CCaaS 시스템에서 에이전트의 활성 상태
* 에이전트에 대한 사용자 \[sys_user\] 기록에 대한 참조
{#agent-mapping-PUT-agent-inid__ul_ljy_ytt_32c}

### URL 형식

기본 URL: /api/sn_ct_ctr_it_core/agent_mapping/agent/{agentId}/inboundId/{inboundId}

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

{#agent-mapping-PUT-agent-inid__entry__2}

| 이름 | 설명 |
|-|-|
| agentId | 내부 에이전트의 Sys_id입니다. 데이터 유형: 문자열 테이블: 사용자 \[sys_user\] |
| inboundId | CCaaS 시스템에 대한 제공자 채널 ID 기록의 인바운드 ID입니다. 데이터 유형: 문자열 테이블: 제공자 채널 ID \[sys_cs_provider_application\] 필드: 인바운드 ID |
[표 1. 경로 매개변수]

{#agent-mapping-PUT-agent-inid__entry__8}

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

{#agent-mapping-PUT-agent-inid__entry__12}

| 이름 | 설명 |
|-|-|
| 활성 | 에이전트가 현재 CCaaS 시스템에 로그인되어 있는지 여부를 나타내는 플래그입니다. 유효한 값은 다음과 같습니다. * true: 에이전트가 로그인되어 있습니다. * false: 에이전트가 로그아웃되었습니다. {#agent-mapping-PUT-agent-inid__ul_qhf_vst_32c} 기본값: true 데이터 유형: 부울 |
| external_agent_id | 필수 CCaaS 시스템의 외부 에이전트 ID입니다. 데이터 유형: 문자열 |
[표 3. 요청 본문 매개변수(JSON)]

### 헤더

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

| 머리글 | 설명 |
|-|-|
| 수용 | 응답 본문의 데이터 형식입니다. application/json만 지원합니다. |
| 콘텐츠-형식 | 요청 본문의 데이터 형식입니다. application/json만 지원합니다. |
[표 4. 요청 헤더]

{#agent-mapping-PUT-agent-inid__entry__24}

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

### 상태 코드

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

| 상태 코드 | 설명 |
|-|-|
| 200 | 네. 기존 에이전트 매핑 기록이 업데이트되었습니다. |
| 201 | 만든. 새 에이전트 매핑 기록이 생성되었습니다. |
| 400 | 잘못된 요청. 요청에 제공된 에이전트 ID 또는 인바운드 ID가 잘못되었습니다. |
[표 6. 상태 코드]

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

{#agent-mapping-PUT-agent-inid__entry__36}

| 이름 | 설명 |
|-|-|
| 결과 | 요청에 대한 정보를 포함하는 결과 객체입니다. 데이터 유형: 객체 |
| result.mappingIds | 외부 에이전트 매핑 \[external_agent_mapping\] 테이블에서 작성되거나 업데이트된 기록의 Sys_ids입니다. 데이터 유형: 문자열 배열 |
| 결과.메시지 | 요청의 결과를 설명하는 메시지입니다. 데이터 유형: 문자열 |
| 결과.상태 | 요청의 상태입니다. 가능한 값: * 성공 * 장애 {#agent-mapping-PUT-agent-inid__ul_kqs_m5m_32c} 데이터 유형: 문자열 |
[ ]

### cURL 요청

이 예에서는 `da419c1fc312310015519f2974d3ae15` 가 sys_id 내부 에이전트를 외부 CCaaS 시스템의 해당 ID `12345` 에 매핑합니다.

    curl "https://instance.service-now.com/api/sn_ct_ctr_it_core/agent_mapping/agent/da419c1fc312310015519f2974d3ae15/inboundId/ServiceNowVoice" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{\"external_agent_id\":\"12345\"}" \ 
    --user 'username':'password'

응답 본문:

    {
      "result": { 
        "message": "Agent Id mapping record inserted", 
        "status": "success", 
        "mappingIds": [ 
          "128b74fcc3931a50325a4ad9d00131c3" 
        ] 
      } 
    }

### cURL 요청 {#agent-mapping-PUT-agent-inid__example_izk_k5t_32c}

이 예에서는 에이전트가 CCaaS 시스템에서 로그아웃되었음을 나타내기 위해 매개변수를 `false`로 설정합니다active.

    curl "https://instance.service-now.com/api/sn_ct_ctr_it_core/agent_mapping/agent/da419c1fc312310015519f2974d3ae15/inboundId/ServiceNowVoice" \ 
    --request PUT \ 
    --header "Accept:application/json" \ 
    --header "Content-Type:application/json" \ 
    --data "{"external_agent_id":"12345", "active":"false"}" \ 
    --user 'username':'password'

응답 본문:

    { 
      "result": { 
        "message": "Agent Id mapping record updated", 
        "status": "success", 
        "mappingIds": [ 
          "cea77cebebef9e10a341fc7acad0cdc2" 
        ] 
      } 
    }