에이전트 매핑 API

  • 릴리스 버전: Yokohama
  • 업데이트 날짜 2025년 02월 10일
  • 읽기5분

    • 에이전트 매핑 API는 CCaaS(Contact Center as a Service) 시스템의 외부 에이전트 ID를 의 내부 에이전트 IDNow Platform에 매핑하는 엔드포인트를 제공합니다.

    이 API에는 외부 에이전트 관리 유틸리티 팩(sn_external_agent) 플러그인이 필요합니다. 이 API를 호출하려면 interaction_agent 역할이 있어야 합니다.

    CCaaS 시스템과의 통합에 대한 자세한 내용은 문서를 참조하십시오 Integrating with contact centers.

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

    CCaaS(Contact Center as a Service) 시스템의 외부 에이전트 ID를 의 Now Platform내부 에이전트 ID에 매핑합니다.

    에이전트가 CCaaS 시스템에 로그인하거나 로그아웃하여 활성 상태를 업데이트할 때 이 엔드포인트를 호출합니다. 이 엔드포인트는 다음 데이터로 외부 에이전트 매핑 [external_agent_mapping] 테이블에 기록을 생성하거나 업데이트합니다.
    • 외부 CCaaS 에이전트 ID
    • 인바운드 ID와 연결된 제공자 채널 ID
    • CCaaS 시스템에서 에이전트의 활성 상태
    • 에이전트의 사용자 [sys_user] 기록에 대한 참조

    URL 형식

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

    지원되는 요청 매개변수

    표 1. 경로 매개변수
    이름 설명
    agentId 내부 에이전트의 Sys_id입니다.

    데이터 유형: 문자열

    테이블: 사용자 [sys_user]
    inboundId CCaaS 시스템에 대한 제공자 채널 ID 기록의 인바운드 ID입니다.

    데이터 유형: 문자열

    테이블: 제공자 채널 ID [sys_cs_provider_application]

    필드: 인바운드 ID
    표 2. 쿼리 매개변수
    이름 설명
    안 함
    표 3. 요청 본문 매개변수(JSON)
    이름 설명
    활성 에이전트가 현재 CCaaS 시스템에 로그인되어 있는지 여부를 나타내는 플래그입니다.
    유효한 값은 다음과 같습니다.
    • true: 에이전트가 로그인되었습니다.
    • false: 에이전트가 로그아웃되었습니다.

    기본값: true

    데이터 유형: 부울
    external_agent_id 필수 CCaaS 시스템의 외부 에이전트 ID입니다.

    데이터 유형: 문자열

    머리글

    다음 요청 및 응답 헤더는 이 HTTP 작업에만 적용되거나 이 작업에 고유한 방식으로 적용됩니다. REST API에 사용되는 일반 헤더 목록은 지원되는 REST API 헤더를 참조하세요.

    표 4. 요청 헤더
    헤더 설명
    수용 응답 본문의 데이터 형식입니다. application/json만 지원합니다.
    컨텐츠-형식 요청 본문의 데이터 형식입니다. application/json만 지원합니다.
    표 5. 응답 헤더
    헤더 설명
    없음

    상태 코드

    다음 상태 코드는 이 HTTP 작업에 적용됩니다. REST API에서 사용되는 가능한 상태 코드 목록은 REST API HTTP 응답 코드를 참조하세요.

    표 6. 상태 코드
    상태 코드 설명
    200 네

    기존 에이전트 매핑 기록이 업데이트되었습니다.
    201 만든.

    새 에이전트 매핑 기록이 생성되었습니다.
    400 잘못된 요청.

    요청에 제공된 에이전트 ID 또는 인바운드 ID가 잘못되었습니다.

    응답 본문 매개변수(JSON)

    이름 설명
    결과 요청에 대한 정보를 포함하는 결과 객체입니다.

    데이터 유형: 객체
    result.mappingIds 외부 에이전트 매핑 [external_agent_mapping] 테이블에서 생성되거나 업데이트된 기록의 Sys_ids입니다.

    데이터 유형: 문자열 배열
    결과.메시지 요청의 결과를 설명하는 메시지입니다.

    데이터 유형: 문자열
    결과.상태 요청의 상태입니다.
    가능한 값:
    • 성공
    • 실패

    데이터 유형: 문자열

    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 요청

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

    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" 
    ] 
  } 
}