Assist 봇의 빌더는 외부/내부 시스템에 대한 광범위한 API 호출을 통해 데이터를 가져오거나 푸시하고 이를 봇 대화의 일부로 표시할 수 있도록 합니다. 또한, 관리자들은 대화에서 API 호출을 트리거할 때마다 매개변수를 전달할 필요가 없으며, 이전 또는 다른 대화에서 이를 재사용하고 API 라이브러리에서 모두 구성하여 쉽게 수정할 수 있습니다.
대화에서 수행해야 하는 모든 API 호출은 API 라이브러리에서 구성할 수 있으며, 필요한 대화에 대해 API 트리거 옵션을 작업 탭에서 선택하여 호출할 수 있습니다.
새로운 API 생성에 대한 빠른 가이드:
- 관리자로서 Freshdesk 계정에 로그인합니다
- Freddy 구성 아래에서 관리자 > 상담원 생산성 > Assist 봇 으로 이동합니다
봇 목록 페이지에서 편집할 봇을 선택합니다
오른쪽 탐색 바에서 'API 라이브러리' 아이콘을 클릭합니다
- '+ 새 API' 버튼을 통해 새로운 API 호출을 구성할 수 있습니다
API 구성:
- 이름: API 호출에 적합한 이름을 지정합니다.
- URL/JS 함수 이름: 여기에서 콜백 URL을 제공합니다. 이 필드의 콘텐츠 선택기 옵션 [+]를 사용하여 대화에서 값을 콜백 URL에 추가할 수 있습니다.
- 메서드: 수행하려는 API 호출의 유형을 구성합니다 - GET, PUT, POST, DELETE 또는 JS 함수, 그리고 이에 따라 페이로드를 전달합니다. 또한 확장 가능한 텍스트 편집기에서 더 큰 페이로드 콘텐츠를 구성할 수 있으며, JSON을 자동으로 포맷합니다. 예를 들어, Freshdesk 계정에서 티켓을 생성하려면 이메일, 우선순위, 상태, 제목 및 설명을 JSON으로 전달합니다. 오른쪽 하단의 + 아이콘을 사용하여 플레이스홀더를 사용할 수도 있습니다.
- 헤더 추가: 이 필드에서 API를 인증할 수 있으며 이 섹션에서 추가 매개변수를 헤더로 전달할 수 있습니다.
- 테스트: API 호출이 올바르게 구성되었는지 확인하기 위해 샘플 테스트 실행을 수행하고, 페이로드에 구성한 동적 필드에 대한 테스트 값을 전달하고 응답 헤더를 확인할 수 있습니다.
- 필요한 응답 매개변수 추가: 응답 헤더의 속성은 챗봇 대화의 모든 대화에서 참조할 수 있습니다.
예를 들어, 주문의 상태 ID를 표시하려면 헤더의 ID 필드를 이 필드에 추가하고 후속 대화에서 사용할 수 있습니다.
요소 배열이 필요한 경우, 해당 필드에 대괄호를 추가해야 하며, 아래 예시와 같이 사용합니다: data[].id, data[].name
배열의 특정 요소에 대해 인덱스 번호를 사용하면 해당 필드의 해당 값을 표시합니다: data[1].id는 위 예시에서 두 번째 값을 표시합니다: 60002
API 목록 페이지:
API 라이브러리 목록 페이지에서 구성한 API를 이름으로 검색할 수 있습니다. 나열된 API는 API가 수행하도록 설정된 작업 유형(GET 또는 POST 등), API가 생성된 시기 및 마지막으로 수정된 시기를 알려줍니다. API 옆의 '더보기' 아이콘을 클릭하면 API를 편집하거나 삭제할 수 있습니다.
API 사용에 대한 빠른 가이드:
- 관리자로서 Freshdesk 계정에 로그인합니다
- Freddy 구성 아래에서 관리자 > 상담원 생산성 > Assist 봇 으로 이동합니다
봇 목록 페이지에서 편집할 봇을 선택합니다
해당 봇의 원하는 흐름을 클릭합니다
- 사용 사례에 따라 '메시지 또는 질문' 또는 '작업' 또는 '조건' 탭 아래에 API의 응답을 추가할 수 있습니다
- 메시지 또는 질문 아래: 상담원에게 표시할 메시지 또는 질문을 텍스트 상자에 입력하고 콘텐츠 선택기 아이콘 [+]를 클릭한 후 'API'를 선택합니다. 해당 봇의 API 라이브러리에 구성된 모든 API 목록이 표시됩니다. 필요한 API를 선택하여 텍스트 상자에 추가합니다.
예를 들어: 주문 상태를 가져오는 경우, 주문 관리 시스템에 연결하고 응답 매개변수에서 주문 상태를 참조하는 API 호출을 설정할 수 있습니다. - 작업 아래: '작업 유형'을 'API 트리거'로 설정한 후 해당 봇의 API 라이브러리에 구성된 모든 API 목록에서 필요한 API를 선택합니다.
예를 들어: 페이지의 URL을 얻기 위한 API 응답을 구성하는 경우, 상담원이 봇에서 URL에 액세스할 수 있도록 해당 API를 작업 아래에 참조할 수 있습니다. - 조건 아래: 봇 흐름의 필요한 대화에 대해 '조건' 탭으로 이동하여 콘텐츠 선택기 [+] 아이콘을 클릭하고 드롭다운에서 'API'를 선택합니다. 해당 봇의 API 라이브러리에 구성된 모든 API 목록을 볼 수 있습니다. 필요한 API 호출을 선택한 후 응답 값을 선택합니다. API의 응답은 조건의 본문과 조건의 값 섹션 모두에서 사용할 수 있습니다.
예를 들어: 간단한 구독 흐름의 경우, API 응답에서 결제의 '상태'를 가져와 상태가 미납인 경우 상담원을 다른 대화/흐름으로 리디렉션하거나 상태가 납부된 경우 상담원에게 간단한 메시지를 표시하여 고객에게 동일한 내용을 전달할 수 있도록 대화를 설정할 수 있습니다.
- 메시지 또는 질문 아래: 상담원에게 표시할 메시지 또는 질문을 텍스트 상자에 입력하고 콘텐츠 선택기 아이콘 [+]를 클릭한 후 'API'를 선택합니다. 해당 봇의 API 라이브러리에 구성된 모든 API 목록이 표시됩니다. 필요한 API를 선택하여 텍스트 상자에 추가합니다.