---
sourceDocument: 호주 대화형 인터페이스
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ko-KR/conversational-interfaces

 Release :

    - australia

ft:locale :

    - ko-KR

ft:publication_title :

    - 호주 대화형 인터페이스

ft:clusterId :

    - convint

bundleId :

    - convint

workflow :

    - Platform


---

# 스크립트 기반 REST API 생성 및 구성

# 사용자 지정 채팅 통합을 위해 스크립팅된 REST API를 작성하고 구성합니다 {#ariaid-title1}

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

스크립팅된 REST API를 만들고, 스크립팅된 REST 자원을 추가하고, 보안 및 컨텐츠 협상을 설정하고, REST API 요율 제한을 설정합니다.

## 시작하기 전에

[사용자 지정 채팅 통합의 채널에 서식 있는 통제 매핑](https://servicenow-prod.fluidtopics.net/9eFFY92X4PFHh12t9OnNgw "사용자 지정 어댑터 구성 [sys_cs_custom_adapter_config] 테이블에서 리치 컨트롤에 대한 기록을 생성합니다. 리치 컨트롤에 아웃바운드 변환기 구현이 없는 경우 최종 사용자에게 응답이 제공되지 않으며 해당 사용자는 불만족스러운 채팅 환경을 얻을 수 있습니다.").

필요한 역할: 관리자

## 프로시저

1. REST API를 생성합니다.
   1. 다음으로 이동 모두시스템 웹 서비스스크립트 기반 웹 서비스스크립트 기반 REST API.
   2. 새로 만들기를 클릭합니다.
   3. 양식에서 필드를 채웁니다.  
      {#configure-rest-api-va-cccif__table_syk_xhl_1mb__entry__2}

      | 필드 | 설명 |
      |-|-|
      | 이름 | API의 이름입니다. 예: <kbd class="ph userinput">ACME 모바일 앱 채팅 어댑터</kbd>. |
      | API ID | API 식별자입니다. 예를 들면 <kbd class="ph userinput">acme_chat</kbd>입니다. |
      | 보호 정책 | 스크립트에 대한 보호 정책입니다. * 읽기 전용: 스크립트만 볼 수 있습니다. * 보호됨: 암호 권한이 있는 사용자는 스크립트를 편집할 수 있습니다. {#configure-rest-api-va-cccif__ul_jmv_hgx_ktb} |
      | 애플리케이션 | 스크립트 기록을 포함하는 애플리케이션입니다. 기본적으로 전역 이 선택됩니다. |
      | API 네임스페이스 | API가 속한 네임스페이스입니다. 이 값은 현재 애플리케이션 범위에 따라 달라집니다. |
      [ ]

      {#configure-rest-api-va-cccif__table_syk_xhl_1mb}
   4. 제출을 클릭합니다.
   5. **옵션:** 새 기록을 열고, 관련 링크로 이동하고, 버전 관리 사용을 클릭한 다음, 확인을 클릭합니다.  
      변경 사항을 저장하려면 업데이트를 클릭합니다.
   {#configure-rest-api-va-cccif__substeps_bfp_gc5_wlb}
2. 새 REST API에 스크립팅된 REST 자원을 추가합니다.  
   스크립팅된 REST 자원은 사용자가 생성한 스크립팅된 REST API 정의를 정의합니다.
   1. 생성한 REST API 기록을 연 다음 관련 링크 아래의자원 탭으로 이동합니다.
   2. 새로 만들기를 클릭합니다.  
      요청에서 페이로드를 검색한 다음 하이브리드 큐에 씁니다.
   3. 양식에서 필드를 채웁니다.  
      {#configure-rest-api-va-cccif__table_dyh_d3l_1mb__entry__2}

      | 필드 | 설명 |
      |-|-|
      | API 정의 | 상위 API의 이름입니다. |
      | 애플리케이션 | 스크립트 기록을 포함하는 애플리케이션입니다. |
      | 이름 | API REST 자원의 이름입니다. 예: ACME 채팅. |
      | API 버전 | API 버전입니다. 예: v1. 이 필드는 REST API에 대한 버전 관리를 활성화한 경우에만 표시됩니다. |
      | 활성 | REST 자원을 활성화하는 옵션입니다. |
      | HTTP 메서드 | POST, GET 등의 HTTP 메서드입니다. |
      | 상대 경로 | 자원의 상대 경로입니다. |
      | 스크립트 | REST 자원에 대한 스크립트입니다. |
      | 보호 정책 | 스크립트에 대한 보호 정책입니다. * 읽기 전용: 스크립트만 볼 수 있습니다. * 보호됨: 암호 권한이 있는 사용자는 스크립트를 편집할 수 있습니다. {#configure-rest-api-va-cccif__ul_kh4_13x_ktb} |
      [ ]

      {#configure-rest-api-va-cccif__table_dyh_d3l_1mb}  
      스크립팅된 REST 자원의 예:

          (function process(/*RESTAPIRequest*/ request, /*RESTAPIResponse*/ response) {
              var body = request.body;
              var queryParams = request.queryParams; // incoming content is application/x-www-form-urlencoded in this example    
              // get the provider application sys id. this can be done via a glide query using incoming data such as where the original message is being sent to. or it can be hard-coded such as this example.
              var providerAppId = "a5f8b75b7377001042281188caf6a73a";    
              // the time of receipt is recorded for analytics purposes
              var d = new Date();
              var logTime = d.getTime();    
              // add this message to the VA Server queue for processing
              var queued = sn_cs.VASystemObject.enqueueCustomAdapterMessage(providerAppId, JSON.stringify(queryParams), JSON.stringify(request.headers), logTime);
              if (queued == false) {
          	response.setError(new sn_ws_err.BadRequestError('Failed to process the request.'));
              }
          })(request, response);
          ​

   {#configure-rest-api-va-cccif__substeps_mp5_xkp_xlb}
3. 스크립팅된 REST 자원에 대한 보안 및 컨텐츠 협상을 설정합니다.  
   인증 및 요청 형식을 설정하려면 선택합니다. 사용자 지정 통합이 인증에 의존하지 않는 경우 다음과 같이 제거할 수 있습니다.
   1. 스크립팅된 REST 자원에 대한 새 기록에서 보안 탭으로 이동합니다.
   2. 인증 필요 선택 취소
   3. 콘텐츠 협상 탭을 클릭한 다음, 지원되는 요청 형식 재정의를 선택합니다.
   4. 제출을 클릭합니다.
   {#configure-rest-api-va-cccif__substeps_es1_v2h_zlb}
4. REST API 요율 제한을 설정하여 들어오는 요청의 속도를 정의합니다.
   1. 다음으로 이동 모두시스템 웹 서비스REST요율 제한 규칙.
   2. 새로 만들기를 클릭합니다.
   3. 양식에서 필드를 채웁니다.  
      {#configure-rest-api-va-cccif__table_jk5_vdy_ktb__entry__2}

      | 필드 | 설명 |
      |-|-|
      | 이름 | 요율 제한 규칙의 고유한 이름입니다. |
      | REST API | 이전 단계에서 생성한 REST API입니다. |
      | 버전 | REST API의 버전입니다. 나열된 값은 선택한 REST API에 따라 다릅니다. |
      | 자원 | 지정된 버전의 자원입니다. 나열된 값은 선택한 버전에 따라 다릅니다. |
      | 활성 | 요율 제한 규칙이 활성 상태임을 나타내는 확인란입니다. 요율 제한 규칙은 만드는 즉시 기본적으로 활성화됩니다. 요율 제한 규칙을 비활성화하여 요율 제한 적용을 중지하거나 요율 제한 규칙을 활성화하여 요율 제한 적용을 재개할 수 있습니다. |
      | 시간당 요청 제한 | 시간당 허용되는 최대 요청 수입니다. 주: 이 필드의 값을 업데이트할 때마다 요청 ServiceNow AI Platform 수가 0으로 재설정되고 현재 시간의 모든 위반이 삭제됩니다. |
      | 적용 대상 | 이 규칙에 의해 제한되는 사용자입니다. 모든 사용자를 선택합니다. |
      [ ]

      {#configure-rest-api-va-cccif__table_jk5_vdy_ktb}
   4. 제출을 클릭합니다.
   {#configure-rest-api-va-cccif__substeps_q3r_cyx_ktb}

## 다음에 수행할 작업

[사용자 지정 채팅 통합을 위한 작업 스크립트 생성](https://servicenow-prod.fluidtopics.net/ipavltDukIC~H80GkaOztg "사용자 지정 채팅 통합이 채팅 프로세스를 통해 통신하는 데 필요한 변환을 설정합니다.")