목록 및 파일 형식 변수

Alli 에 두가지 새로운 변수 형식이 추가되었습니다. 목록 변수를 이용하면 외부로부터 목록 형태의 데이터를 가져와 고객의 응답 옵션으로 사용할 수 있으며, 파일 변수를 이용하면 고객으로부터 파일을 쉽게 업로드받을 수 있습니다. 어떻게 사용하는지 알아볼까요?

변수를 생성/관리하는 일반적인 방법에 대해서는 해당 가이드를 참고하세요.

목록 변수

목록 형식 변수에는 문자열 목록, JSON, JSON 목록의 세가지가 있습니다. 모든 목록 변수를 활용하기 위해서는 JSON 에 대한 기초적인 지식에 필요합니다.

Step 1. 목록 변수 생성

Alli 대시보드로 로그인하여 목록 타입 변수를 만들기 시작합니다. 변수를 만드는 데는 두가지 방법이 있습니다.
옵션 1 – 설정> 변수 > 사용자 메뉴로 이동하여 ‘+추가’ 버튼을 클릭합니다.
옵션 2 – 스킬을 만드는 중, 지원되는 노드에서 새 변수를 만들 수 있습니다. 고객 응답을 저장할 변수를 선택할 때 ‘새 변수 생성’ 을 클릭하면 됩니다.
옵션 3 – 스킬을 만드는 중, 우측 상단에 위치한 ‘변수’ 를 클릭해 변수 목록을 열고 ‘+추가’ 버튼을 클릭합니다.
문자열 목록, JSON, JSON 목록 중 하나를 골라 변수를 생성합니다.

Step 2. JSON 형식의 데이터 포인트 준비

어떤 변수를 사용하느냐에 따라 적절한 JSON 포맷의 데이터를 준비합니다. 예를 들면 아래와 같습니다.

{
  "STR_LIST_VAR": [
    "TypeA",
    "TypeB",
    "TypeNew"
  ],
  "JSON_VAR": {
    "empno": 1,
    "name": "Chris",
    "email": "Chris@allganize.ai"
  },
  "JSON_LIST_VAR": [
    {
      "empno": 1,
      "name": "James",
      "email": "James@allganize.ai"
    },
    {
      "empno": 2,
      "name": "Peter",
      "email": "Peter@allganize.ai"
    }
  ]
}

각각의 키값은 변수명과 일치해야 합니다. 위 예시의 경우, STR_LIST_VAR, JSON_VAR, JSON_LIST_VAR 이 각각 문자열 목록, JSON, JSON List 변수명과 일치해야 합니다. 단, 아래의 연동하기 노드에서 Advanced 옵션을 사용하는 경우 JSON 경로를 직접 입력하게 되므로 키값이 변수명과 일치할 필요가 없습니다.

Step 3. 스킬 생성

연동하기 노드를 이용해 준비한 데이터 포인트에서 데이터를 가져옵니다. 목록 형식 변수를 사용하는 노드 이전에 반드시 해당 노드를 위치시켜야 합니다.

메시지 보내기 노드에서 ‘답변 추가’를 체크하고 ‘답변 옵션 추가’를 클릭합니다. 이후 ‘동적 옵션’을 선택하면 사용하기를 원하는 목록 변수를 선택할 수 있습니다. JSON 이나 JSON 목록 형식을 사용하는 경우, Display 경로와 Value 경로를 JSON 경로 형식으로 적절히 입력해 주어야 합니다. Display 경로는 스킬에서 고객에게 보여줄 텍스트를 결정하며, Value 경로는 고객이 해당 옵션을 선택했을때 저장할 값을 결정합니다.

Step 4. 목록이 제대로 나타나는지 확인

미리보기를 이용해 목록이 의도한 대로 나타나는지 확인합니다.

파일 변수

파일 변수를 사용하는 방법은 매우 간단합니다. 아래 가이드를 참고하세요.

파일 변수 파일 변수를 사용하는 방법은 매우 간단합니다. 아래 가이드를 참고하세요.

변수 종류를 ‘파일’로 선택하는 것 이외에는 일반적인 변수 생성 방식과 다르지 않으며, 위 목록 변수에서의 Step 1 과 동일합니다.

Step 2. 스킬 생성

파일 형식 변수는 ‘메시지 보내기’ 혹은 ‘입력 폼 보내기’ 노드에서 사용 가능합니다. 메시지 보내기 노드에서는 ‘답변 추가’를 체크하고 ‘파일’을 선택한 다음, 사용할 파일 변수를 ‘답변을 아래 변수로 저장’에서 선택하면 됩니다. 입력 폼 보내기 노드에서는 단순히 필드 중 원하는 곳에 사용할 파일 변수를 지정하면 됩니다.