봇 빌더에서 함수 사용하기

고객에게 미리 설정된 응답을 보내기 위해 봇 빌더에서 대화를 설정하는 것은 매우 간단합니다. 또한 대화에서 값을 동적으로 채워 고객에게 상황에 맞는 응답을 제공할 수 있습니다. 봇 빌더는 일상적인 작업에 자주 사용되는 함수, 예를 들어 현재 날짜 가져오기, 구분자로 문자열 분리하기, 날짜 및 시간 조작하기 등을 제공합니다.

이러한 함수는 자리 표시자로 작동하며 이러한 필드에 대한 값을 동적으로 채웁니다. 또한 각 함수의 동작 방식이나 정보를 수집하는 방법을 입력을 선언하여 정의할 수 있습니다. 이러한 입력은 각 함수에 대해 미리 정의되어 있으며 다른 대화, API 또는 사용자 정의/기본 속성에서 자리 표시자를 사용할 수 있습니다. 예를 들어, 고객에게 이름을 물어보고 저장할 때 제목 대문자로 저장되도록 함수를 사용할 수 있습니다. 아래에는 봇 빌더에서 제공하는 함수에 대한 설명이 나와 있습니다. 해당 함수를 대화에서 사용하여 봇에서 값을 동적으로 채울 수 있습니다.

함수는 다음과 같은 방법으로 트리거될 수 있습니다:

• 대화로 이동 > 입력 옵션 > 함수
• 대화로 이동 > 조건 추가 > 입력 옵션 > 함수

참고: "Contains" 함수는 평가 함수로서 대화에 필요한 출력이 아니므로 조건 내에서만 사용할 수 있습니다.

함수 이름 및 설명

어떤 입력을 제공해야 하나요?

예시

• Split: 지정된 구분자에서 텍스트 문자열을 분할하고 지정된 인덱스에 따라 값을 반환합니다.
• 입력 텍스트: 분할해야 하는 텍스트
• 구분자: 텍스트를 분할해야 하는 문자
• 인덱스: 반환해야 하는 텍스트의 위치. 구분자 이전 문자열의 인덱스는 0이고, 구분자 이후 문자열의 인덱스는 1입니다.
• 입력 텍스트: support@freshchat.com
• 구분자: @
• 인덱스: 0
• 출력: support

• Convert to title case: 텍스트 문자열의 형식을 변경하여 각 단어의 첫 글자가 대문자로 저장되도록 변환합니다.
• 입력 텍스트: 제목 대문자로 변환해야 하는 텍스트
• 입력 텍스트: customer service
• 출력: Customer Service

• Get days between: 두 지정된 날짜 사이의 일 수를 반환합니다 (종료일 포함).
• 시작 날짜: 계산을 시작해야 하는 날짜 (포함되지 않음)
• 종료 날짜: 계산을 계속해야 하는 날짜 (계산에 포함됨)
• 형식: 날짜를 지정하는 형식
• 시작 날짜: 01-01-21
• 종료 날짜: 01-01-22
• 형식: dd-MM-yy
• 출력: 365

• Add minutes to date: 지정된 날짜에 지정된 분을 추가합니다.
• 입력 날짜: 분을 추가해야 하는 날짜
• 분: 입력 날짜에 추가해야 하는 분 수
• 형식: 날짜와 시간을 지정하는 형식
• 입력 날짜: 01-01-21 00:15:00
• 분: 51
• 형식: dd-MM-yy HH:mm:ss
• 출력: 01-01-21 01:07:00

• Add hours to date: 지정된 날짜에 지정된 시간을 추가합니다.
• 입력 날짜: 시간을 추가해야 하는 날짜
• 시간: 입력 날짜에 추가해야 하는 시간 수
• 형식: 날짜와 시간을 지정하는 형식
• 입력 날짜: 01-01-21 07:04:00 AM
• 시간: 12
• 형식: dd-MM-yy hh:mm:ss a
• 출력: 01-01-21 19:04:00

• Add days to date: 지정된 날짜에 지정된 일을 추가합니다.
• 입력 날짜: 일을 추가해야 하는 날짜
• 일: 입력 날짜에 추가해야 하는 일 수
• 형식: 날짜를 지정하는 형식
• 입력 날짜: 01-01-21
• 일: 12
• 형식: dd-MM-yy
• 출력: 13-01-21

• Add days to date with timezone: 지정된 날짜에 시간대와 함께 지정된 일을 추가합니다.
• 입력 날짜: 일을 추가해야 하는 날짜
• 일: 입력 날짜에 추가해야 하는 일 수
• 형식: 날짜를 지정하는 형식
• 시간대: 날짜와 함께 표시해야 하는 시간대
• 입력 날짜: 01-01-2021 04:15:00 AM IST
• 일: 7
• 형식: dd-MM-yyyy hh:mm:ss a z
• 시간대: IST
• 출력: 08-01-2021 04:15:00 AM IST

• Add working days to date with timezone: 지정된 날짜에 시간대와 함께 지정된 근무일을 추가합니다. 현재 이 함수는 주당 5일의 근무일만 고려하며, 다른 공휴일이나 주중 일정은 고려하지 않습니다.
• 입력 날짜: 근무일을 추가해야 하는 날짜
• 근무일: 입력 날짜에 추가해야 하는 근무일 수
• 형식: 날짜를 지정하는 형식
• 시간대: 날짜와 함께 표시해야 하는 시간대
• 입력 날짜: 01-01-2021 04:15:00 AM IST
• 일: 7
• 형식: dd-MM-yyyy hh:mm:ss a z
• 시간대: IST
• 출력: 12-01-2021 04:15:00 AM IST

• Add working days to date: 지정된 날짜에 지정된 근무일을 추가합니다. 현재 이 함수는 주당 5일의 근무일만 고려하며, 다른 공휴일이나 주중 일정은 고려하지 않습니다.
• 입력 날짜: 근무일을 추가해야 하는 날짜
• 근무일: 입력 날짜에 추가해야 하는 근무일 수
• 형식: 날짜를 지정하는 형식
• 입력 날짜: 2021-31-01
• 일: 7
• 형식: yyyy-dd-MM
• 출력: 2021-09-02

• Format date: 현재 날짜의 형식을 다른 지정된 형식으로 변경합니다.
• 입력 날짜: 형식을 변경해야 하는 날짜
• 형식: 지정된 날짜의 기존 형식
• 형식: 날짜를 업데이트해야 하는 형식
• 입력 날짜: 2021-31-01
• 형식: yyyy-dd-MM
• 형식: dd-MM-yyyy
• 출력: 31-01-2021

• Extract from list elements: 지정된 목록의 각 요소를 지정된 구분자에 따라 분할하고 지정된 인덱스 값에 따라 각 요소에 대해 하나의 값을 반환합니다.
• 입력 목록: 각 목록 요소에 대해 값을 추출해야 하는 요소 목록
• 구분자: 각 목록 요소에 존재하는 문자 또는 문자열. 함수는 이 문자에서 각 목록 요소를 분할합니다.
• 인덱스: 반환해야 하는 텍스트의 위치. 구분자 이전 문자열의 인덱스는 0이고, 구분자 이후 문자열의 인덱스는 1입니다.
• 입력 목록: Room#101, Room#102, Room#103, Room#104
• 구분자: #
• 인덱스: 1
• 출력: [101, 102, 103, 104]

• Append content: 지정된 추가 콘텐츠를 지정된 주요 콘텐츠에 추가합니다.
• 주요 콘텐츠: 텍스트를 추가해야 하는 콘텐츠
• 추가 콘텐츠: 추가해야 하는 콘텐츠
• 주요 콘텐츠: Hello
• 추가 콘텐츠: World
• 출력: Hello World

• Split into list: 지정된 문자열을 지정된 구분자에 따라 목록으로 분할합니다.
• 주요 콘텐츠: 목록으로 분할해야 하는 콘텐츠.
• 구분자: 주요 콘텐츠를 목록으로 분할하는 데 사용해야 하는 문자/문자열.
• 주요 콘텐츠: Option 1 and Option 2 and Option 3 and Option 4
• 구분자: and
• 출력: [Option 1, Option 2, Option 3, Option 4]

• Extract from list: 지정된 위치(인덱스)에 따라 목록에서 요소를 가져옵니다.
• 입력 목록: 요소를 추출해야 하는 요소 목록
• 인덱스: 반환해야 하는 텍스트의 위치. 첫 번째 요소의 인덱스 값은 0부터 시작합니다.
• 주요 콘텐츠: Option 1, Option 2, Option 3, Option 4
• 인덱스: 2
• 출력: Option 3

• Count working days: 두 지정된 날짜 사이의 근무일 수를 계산합니다. 현재 이 함수는 주당 5일의 근무일만 고려하며, 다른 공휴일이나 주중 일정은 고려하지 않습니다.
• 날짜 1: 계산을 시작해야 하는 날짜
• 날짜 2: 계산을 계속해야 하는 날짜 (계산에 포함됨)
• 형식: 날짜를 지정하는 형식
• 날짜 1: 24-12-2021
• 날짜 2: 06-01-2021
• 형식: dd-MM-yyyy
• 출력: 11

• Add integers: 두 지정된 정수를 더합니다.
• 입력 정수 1: 두 번째 정수를 더해야 하는 첫 번째 정수.
• 입력 정수 2: 첫 번째 정수에 더할 두 번째 정수.
• 입력 정수 1: 123
• 입력 정수 2: 4
• 출력: 127

• Get length: 지정된 문자열의 길이를 반환합니다.
• 엔터티: 길이가 필요한 문자열
• 엔터티: Customer Service
• 출력: 16

• Get current date: 지정된 형식으로 현재 날짜를 반환합니다.
• 형식: 현재 날짜가 필요한 형식을 지정합니다.
• 형식: dd-MMM-yyyy hh:mm:ss a z
• 출력: 12-Feb-2021 02:11:23 PM UTC

• Compare dates: 함수는 기본 날짜와 보조 날짜를 비교한 후 다음을 반환합니다: 기본 날짜가 보조 날짜보다 크면 1, 두 날짜가 같으면 0, 기본 날짜가 보조 날짜보다 작으면 -1.
• 날짜 1: 기본 날짜
• 날짜 2: 보조 날짜
• 형식: 날짜가 입력된 형식
• 날짜 1: 11-02-2021
• 날짜 2: 03-02-2021
• 형식: dd-MM-yyyy
• 출력: 1

• Compute: 함수는 지정된 표현식의 값을 계산하고 최대 소수점 두 자리까지 결과를 반환합니다.
• 입력 표현식: 계산해야 하는 표현식
• 입력 표현식: 8/(2*4) + (8/2)*4
• 출력: 17.00

• Get JWT: 함수는 각각의 입력을 받아 JWT 토큰을 출력합니다.
• 클레임: 인코딩해야 하는 유효한 JSON 표현식. 이러한 클레임에는 발행자, 주제, 청중 등이 포함됩니다.
• JWT 비밀 키: 인코딩되는 헤더 및 페이로드 콘텐츠를 서명하기 위해 문자열을 사용합니다.
• 만료(초): JWT가 유효한 기간(초)을 정의합니다.
• 알고리즘 식별자: 데이터를 처리하는 데 사용할 알고리즘(서명 또는 암호화)으로 RS, HS, ES 중에서 선택합니다.
• 클레임: { "sub": "1234567890", "name": "John Doe", "iat": 1516239022 }
• JWT 비밀 키: your-256-bit-secret
• 만료(초): 120
• 알고리즘 식별자: HS256

• Get JWE: 함수는 각각의 입력을 받아 JWE 토큰을 출력합니다.
• 클레임: 인코딩해야 하는 유효한 JSON 표현식. 이러한 클레임에는 발행자, 주제, 청중 등이 포함됩니다.
• JWT 비밀 키: 인코딩되는 헤더 및 페이로드 콘텐츠를 서명하기 위해 문자열을 사용합니다.
• 만료(초): JWT가 유효한 기간(초)을 정의합니다.
• 알고리즘 식별자: 데이터를 처리하는 데 사용할 알고리즘(서명 또는 암호화)으로 HS256, HS384, HS512 중에서 선택합니다.
• JWE 비밀 키: 인코딩되는 헤더 및 페이로드 콘텐츠를 서명하기 위해 문자열을 사용합니다.
• 소스 헤더: 소스 헤더를 지정하기 위해 문자열을 사용합니다.
• 클레임: { "sub": "1234567890", "name": "John Doe", "iat": 1516239022 }
• JWT 비밀 키: your-256-bit-secret
• 만료(초): 120
• 알고리즘 식별자: HS256
• JWE 비밀 키: your-256-bit-secret-part-two
• 소스 헤더: "alg": "HS256", "typ": "JWT"

• Encode to base64: 함수는 사용자 이름과 비밀번호를 base64 인코딩으로 인코딩합니다.
• 사용자 이름: 인코딩해야 하는 사용자 이름
• 비밀번호: 인코딩해야 하는 비밀번호
• 사용자 이름: John.doe@saulsstore.com
• 비밀번호: AlwaysUseStrongLongPasswords

• Ternary Operator: 이 함수는 삼항 연산자와 동일하게 작동하며, 세 가지 값을 사용합니다. 첫 두 값을 비교하고 참일 경우 하나의 값을, 거짓일 경우 다른 값을 할당합니다.
• LHS & RHS: LHS와 RHS는 어떤 입력이든 될 수 있으며, 이 함수는 이를 비교합니다.
• 연산자: LHS와 RHS 간의 비교가 무엇인지 다음 연산자 중 하나를 사용하여 정의합니다: Equals, Not equal, Greater than, Lesser than, Greater than or equals, Lesser than or equals.
• 참일 경우: 비교가 참일 경우 출력해야 하는 값을 정의합니다.
• 그렇지 않을 경우: 비교가 참이 아닐 경우 출력해야 하는 값을 정의합니다.
• LHS: Order status
• RHS: Delivered
• 연산자: Equals
• 참일 경우: Your order has been delivered
• 그렇지 않을 경우: Your delivery is still pending.

• Contains: 이 함수는 한 텍스트 문자열이 다른 텍스트 문자열을 포함하는지 검색합니다.
• 입력 텍스트: 더 긴 텍스트 문자열을 검색하여 하위 텍스트가 포함되어 있는지 확인합니다.
• 하위 텍스트: 입력 텍스트에 포함되어 있는지 확인해야 하는 더 짧은 텍스트 문자열
• 입력 텍스트: The quick brown fox jumps over the lazy dog.
• 하위 텍스트: quick

예시에서 몇 가지 형식만 사용했습니다. 표준화된 날짜 및 시간 형식을 사용할 수 있습니다. 모든 입력 필드는 대화, API 및 매개변수와 같은 기존 자리 표시자에서 입력을 받을 수 있습니다. 마찬가지로, 다른 곳에서 자리 표시자로 함수의 출력을 사용할 수 있습니다.