Freddy 셀프 서비스는 기본적으로 제공되지 않는 작업을 수행하려는 경우 Javascript (JS) 함수를 사용할 수 있도록 합니다.간단한 JS 함수의 예를 들어보겠습니다:
print: function (a, b, c) {
console.log("print called: a:" + a + " b: " + b + " c: " +c);
}위젯 스크립트에서의 구성
먼저 JS 코드를 위젯 스크립트에 구성해야 합니다. 봇 위젯 스크립트를 얻으려면
- 관리자 또는 소유자로 Freddy 셀프 서비스 계정에 로그인하고 원하는 봇으로 이동합니다
- 메뉴에서 스크립트 생성을 클릭하여 오른쪽에 코드를 확인합니다
- 이 코드를 스크립트 편집기에 복사-붙여넣기하여 이 코드 안에 스크립트를 포함시킬 수 있습니다
이 스크립트에 논리로서 어떤 함수든 작성할 수 있습니다.
- getClientParams 함수가 정의된 후에 사용자 정의 JS 함수를 포함시킵니다. 이 예에서는 이전에 보여드린 print 함수를 사용하여 위젯 봇 스크립트 내에 정의합니다. 아래에서 생성된 봇 위젯 스크립트를 확인할 수 있으며, print 함수의 JS 코드를 포함(및 강조)했습니다.
이 함수를 봇 스크립트에 정의하면 봇 흐름 어디에서나 호출할 수 있습니다.
관리자 포털 내 구성
- 흐름 > 구성 > API 라이브러리 > 새로 추가 버튼을 클릭합니다
- JS 함수에 대한 (1) 이름을 제공합니다. 이는 참조용입니다.
- (2) URL / JS 함수 이름 필드에 함수의 이름을 입력합니다. 이는 봇 위젯 스크립트에서 정의한 이름과 동일해야 합니다. 예를 들어, "print"입니다. 함수 이름은 대소문자를 구분합니다.
- 메서드 유형을 (3) JS 함수로 설정하고 (4) 페이로드 유형을 JSON으로 설정합니다.
- (4) 페이로드 콘텐츠에 전달해야 하는 인수 값을 JSON 단일 라인 값으로 입력합니다. 이 인수 값은 동적일 수도 있습니다. + 버튼을 사용하여 동적 값을 포함시킵니다.
(6) 필요한 응답 매개변수 추가 필드에서 성공 및 실패 응답 매개변수를 전달할 수 있습니다. 봇은 함수 호출 후 입력을 스크립트로 전달합니다. 함수가 실행되면 응답 매개변수를 기대합니다. 이러한 응답 매개변수를 스크립트에서 봇으로 전달하여 작업의 결과에 따라 처리할 수 있습니다.
여기에서 봇 흐름의 다른 부분에서 응답 값을 호출할 수 있습니다. 예를 들어, 고객 입력을 메시지나 질문으로 설정하는 경우, API에서 콘텐츠를 삽입하거나 이 경우 JS 함수의 결과(성공 또는 실패 응답 매개변수)를 삽입할 수 있습니다.
대화 구성
이제 함수가 정의되었으므로 봇 흐름 어디에서나 함수를 호출할 수 있습니다. 함수를 호출하려면 봇이 함수를 트리거하도록 대화에서 작업을 설정해야 합니다.
- 함수를 실행해야 하는 대화를 열고 > 새 작업 > JS 함수 트리거 > 방금 구성한 API를 선택합니다.
클라이언트 측 작업을 사용하여 JS 함수를 호출하는 경우, 사용자 입력을 텍스트 필드로 받아야 함을 유의하세요. 이는 함수가 응답을 반환한다는 것을 나타내기 위함입니다.
일부 사용 사례
- 고객이 전화해야 하는 전화번호가 있는 경우, 예를 들어 무료 전화번호, "전화하기"라는 버튼을 만들어 고객이 탭하거나 클릭할 수 있습니다. 이는 JS 함수를 트리거하여 기본 전화 다이얼러에 무료 전화번호를 채울 수 있습니다. 이 경우, Android 기기에서는 WebView가 다이얼러에 접근할 수 있는 권한이 있어야 합니다. 전화 다이얼러 권한은 매니페스트 파일 수준에서 허용되어야 합니다.
- 모바일 앱에 봇을 배포하고 고객을 앱의 특정 페이지로 이동시키고자 하는 경우, 앱의 딥 링크를 사용하여 이를 수행할 수 있습니다.
- API가 없지만 봇 흐름이 초기화된 후에도 서버와 연결된 앱과 통신하고자 하는 경우, 사용자 정의 JS 함수를 사용하여 앱과 상호작용하고 정보를 가져올 수 있습니다.
- JS 함수로 작성할 수 있는 표준 함수(예: 수학 함수)
추가 질문이 있는 경우 freshbots-support@freshworks.com으로 문의해 주세요. 기꺼이 도와드리겠습니다.