입력 워크플로우 활동

  • 릴리스 버전: Xanadu
  • 업데이트 날짜 2024년 08월 01일
  • 읽기3분

    • 입력 활동은 알림 통화에 옵션 목록을 표시하여 전화 메뉴를 만듭니다.

    입력 변수

    입력 변수는 활동의 초기 동작을 결정합니다.

    표 1. 입력 변수
    변수 설명
    자릿수 호출자가 입력할 수 있는 최대 자릿수를 지정합니다. 발신자는 최대값보다 적은 자릿수를 입력하고 마침 키를 눌러 입력을 완료할 수 있습니다.
    마침 키 발신자가 메뉴 옵션 선택을 마쳤을 때 전화기에서 누를 수 있는 키를 지정합니다.
    시간 제한(초) 호출자가 메뉴 옵션을 선택하지 않은 경우 자동으로 메뉴를 닫기 전에 대기할 시간을 지정합니다.
    고급 활동 조건을 사용하는 대신 스크립트를 사용하여 전화 메뉴를 작성하려면 이 확인란을 선택합니다.
    스크립트 전화기 메뉴를 빌드할 스크립트를 정의합니다. 스크립트는 변수를 다음 형식의 JavaScript 객체로 지정 answer 해야 합니다.
     answer = {
  “1": {
      “play”: “https://some_url.com/options/one.mp3“,
      “myCustomData”: “some data here”
  },
  “2”: {
      “play”: “https://some_url.com/options/two.mp3”,
      “myCustomData”: “some other data here”
  },
“3”: {
      “speak”: “type 3 to speak to a representative”,
      “language”: “en-US”,
      “myCustomData”: “some more data here”
  }
};

    스크립트는 특성을 사용하여 speak 텍스트 음성 변환 문자열 및 언어 코드를 지정하거나 특성을 사용하여 play 재생할 음악의 URL을 지정할 수 있습니다. 위의 예와 같이 myCustomData 선택적 속성을 추가하여 관련 정보를 저장할 수도 있습니다.

    주:
    스크립트 개체는 이전 버전과의 호환성을 위해 특성을 계속 지원합니다 say .

    조건

    조건에 따라 이 활동 이후의 전환이 결정됩니다.

    입력 활동은 기본적으로 조건을 지정하지 않습니다. 전화 메뉴를 빌드하려면 조건을 정의해야 합니다. 각 조건은 전화기 메뉴의 한 옵션입니다. 알림은 각 조건의 텍스트를 호출자에게 읽어 줍니다(조건당 최대 100자).

    메시지에 xx-XX:<Message> 형식으로 언어 코드를 접두사로 추가하여 각 조건에 대한 언어를 지정할 수 있습니다. 예를 들어 캐나다 프랑스어의 경우 fr-CA: 를 추가합니다. 사용 가능한 언어는 알림 언어[notify_language] 테이블에 저장됩니다.

    활동이 전환되는 조건은 호출자가 입력한 숫자에 따라 달라집니다. 조건 값을parseInt(workflow.scratchpad.digits) == <expected digits>로 설정합니다. 예를 들어 호출자가 숫자 3을 누를 때 조건을 전환하려면 조건을parseInt(workflow.scratchpad.digits) == 3으로 설정합니다.

    이 활동에 오류 조건을 추가할 수 있습니다. 고급 스크립트가 잘못된 값을 반환하거나 조건에 대해 말할 텍스트가 비어 있는 경우 활동은 오류 조건을 통해 전환됩니다.

    스크래치패드 항목

    이 활동은 워크플로우 스크래치패드를 사용하여 지속성 값을 씁니다.

    표 2. 스크래치패드에 기록된 값
    항목 설명
    workflow.scratchpad.digits 호출자가 문자열로 입력한 숫자입니다.
    workflow.scratchpad.menu<activity name> 고급 스크립트 옵션을 사용하는 경우 전체 answer 변수입니다. 이 활동이 성공적으로 실행된 후 다른 활동에서 이 메뉴에 액세스할 수 있습니다.
    예를 들어 활동 이름이 선택 사항인 경우 다음을 사용하여 메뉴에서 값에 액세스할 수 있습니다.
    var previousActivity = "choices";
var choicesMenu = workflow.scratchpad.menu[previousActivity];
var menuItem = choicesMenu[workflow.scratchpad.digits];  // Selects the menu item based on the caller's input.
var selectedValue = menuItem.myCustomData; //get the custom data for the selected menu item.