스폰 스크립트

스크립트 생성을 사용하면 스크립트를 수동으로 실행할 수 있습니다. 다른 스크립트나 외부 프로세스에서 스크립트를 시작하는 데도 사용됩니다. 또한 스크립트를 테스트할 때도 사용할 수 있습니다. 테스트할 때 스크립트 추적과 함께 사용할 수 있습니다.

스크립트를 테스트하려면 Studio에서 trace option을 사용하여 스크립트를 생성할 수 있습니다.

다른 스크립트 또는 프로세스에서 스크립트를 시작하는 방법:

  • 호출하는 스크립트에서 SPAWN action을 사용합니다.
  • POST /scripts/start 중앙에서 오른쪽 상단 모서리 방향으로 가리키는 화살표가 있는 사각형 아이콘입니다. API를 사용합니다. 외부 프로세스에서 스크립트를 생성하는 데 권장되는 솔루션입니다.

달리 구성하지 않는 한 비즈니스 유닛은 최대 15,000개의 스크립트를 실행할 수 있습니다. 해당 제한에 도달하면 하나 이상의 스크립트가 실행을 중지할 때까지 이 페이지에 설명된 방법을 사용하여 추가 스크립트를 시작하거나 생성할 수 없습니다.

스크립트 매개변수

스크립트 매개 변수를 사용하면 데이터를 스크립트로 전달할 수 있습니다. 데이터는 시스템 스크립트 등의 다른 스크립트나 CRM닫힘 컨택, 영업 정보, 지원 세부 정보 및 케이스 내역 등을 관리하는 타사 시스템입니다. 또는 API와 같은 외부 소스에서 가져올 수 있습니다. 이는 pN을(를) 통해 pXp1 변수로 스크립트에 전달되는데, 여기서 N은 생성 메서드에서 지원하는 매개 변수의 최대 수입니다. 이전 섹션에 나열된 옵션 중 하나를 사용하여 스크립트를 생성할 때 스크립트에 전달할 데이터를 지정할 수 있습니다.

매개 변수 변수의 이름을 변경하려면 생성된 스크립트의 Begin 작업을 새 이름으로 구성할 수 있습니다. 스크립트가 BEGIN 작업을 처리하면 pX 변수가 새 이름으로 변환됩니다. 새 이름을 지정하지 않으면 변수는 pX 이름을 유지합니다.

데이터가 스크립트로 전달되면 trace에서 확인할 수 있습니다. BEGIN 작업을 선택하면 추적 출력 변수 목록에서 매개 변수의 변수를 확인할 수 있습니다. 새 변수 이름으로 BEGIN 작업을 구성한 경우, 스크립트 추적에서 BEGIN 뒤의 작업을 선택하면 해당 변수 이름을 확인할 수 있습니다. 매개변수 변수는 값을 가지고 있을 때만 존재합니다.

사용자 정의 매개 변수:

  • 최대 지원:
    • SPAWN 작업을 사용하여 생성된 경우 값당 32KB.
    • API로 생성되었을 때 파이프 구분자를 포함한 모든 매개 변수 최대 32KB.
  • 변수 대체를 지원합니다. 변수 이름을 중괄호 안에 입력합니다( { } ).
  • SPAWN액션 또는 API를 통해 생성할 때 1~20개의 매개변수를 지원합니다.
  • 동적 데이터 개체를 지원하지 않습니다. 개체는 일단 JSON 문자열로 변환되어야 합니다.

Studio 작업 비교

현재 스크립트에서 새 스크립트를 시작하는 Studio 작업은 3가지가 있습니다. 하지만 이 작업들 간에는 다음과 같은 몇 가지 차이점이 있습니다.

  • Runscript: 이(가) 다른 스크립트를 트리거할 때 두 번째 스크립트에서 첫 번째 스크립트로 돌아가지 않습니다.
  • Runsub: 이(가) 하위 스크립트를 트리거하면, 해당 하위 스크립트에 작업이 있는 한 스크립트는 첫 번째 스크립트로 돌아갈 수 있습니다.  작업은 하위 스크립트가 완료되면 작업에 값을 반환합니다.
  • SPAWN: 첫 번째 스크립트와 병렬로 실행되는 두 번째 스크립트를 시작합니다. 생성된 스크립트는 생성된 스크립트에 action을 포함하지 않는 한 첫 번째 스크립트로 데이터를 다시 전달할 수 없습니다.

SPAWN 작업을 사용하여 다른 스크립트에서 생성하기

하위 스크립트에 매개 변수 값을 전달할 필요가 없는 경우에는 상위 스크립트에 SPAWN 작업을 추가하고 구성하면 됩니다. 매개 변수를 전달해야 하는 경우 다음과 같이 구성해야 합니다:

  • 상위 스크립트에서 다음과 같이 변경합니다.
    • 하위 스크립트를 생성하려는 지점에 SPAWN 작업을 배치합니다. SPAWN 작업의 매개 변수 속성을 하위 스크립트에 전달해야 하는 값으로 구성합니다. 값은 p1~p9의 변수로 전달됩니다.
    • SPAWN 작업의other properties를 구성합니다.

  • 하위 스크립트에서 다음과 같이 변경합니다.

    • 작업에서 매개 변수 속성을 구성하여 사용자 정의 매개 변수의 변수 이름을 변경합니다. 아무 작업도 하지 않으면 사용자 정의 매개 변수 값이 변수에 남습니다.
    • 상위 스크립트 또는 호출 애플리케이션에 값을 다시 전달해야 하는 경우 action을 추가 및 구성합니다.

API별 스크립트 생성

POST /scripts/start 중앙에서 오른쪽 상단 모서리 방향으로 가리키는 화살표가 있는 사각형 아이콘입니다. API를 사용하여 스크립트를 생성합니다.

이 API를 사용할 때는 다음과 같은 사항을 숙지하는 것이 중요합니다.

  • 다음 매개 변수는 필수입니다. 
    • skillId: JSON으로 전송하는 경우 값은 정수여야 하지만 쿼리 매개 변수로 전송하는 경우에는 정수가 아니어도 됩니다. 스킬은 다음과 같아야 합니다.
        • 활성화합니다.
        • 스크립트 미디어 유형을 일치시킵니다. 예를 들어 전화 스크립트는 전화 통화 스킬과 상관 관계가 있어야 합니다. 스킬의 세부 정보 탭에서 스킬 유형을 확인할 수 있습니다. Generic 유형의 스크립트는 모든 활성 스킬과 함께 작동합니다.

    • scriptId 또는 scriptPath: scriptPath을(를) 사용하는 것이 좋습니다. 스크립트 ID는 스크립트 변경 사항이 저장될 때마다 변경되므로 매개 변수에서 업데이트해야 합니다.

  • 최대 20개의 매개 변수를 포함할 수 있습니다.
  • 매개 변수는 파이프로 구분된 목록으로 전송해야 합니다.
  • API는 모든 매개 변수에 대해 파이프 구분 기호를 포하여 최대 32KB를 지원합니다.
  • 매개 변수에 포함되는 파이프 문자는 무조건 구분 기호여야 하며, 아닌 경우 허용되지 않습니다.
  • 요청을 JSON으로 전송하는 경우, 예약 문자를 올바르게 이스케이프 처리해야 합니다.
  • URL 쿼리 매개 변수로 요청을 전송하는 경우 매개 변수는 URL 인코딩되어야 합니다.