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 호출이 올바르게 구성되었는지 확인하기 위해 샘플 테스트 실행을 수행하고, 페이로드(예: PUT, POST 및 JSON 메서드)에서 구성한 동적 필드에 대한 테스트 값을 전달하고 응답 헤더를 확인할 수 있습니다.
- 필요한 응답 매개변수 추가: 응답 헤더의 속성은 챗봇 대화의 어느 대화에서도 참조할 수 있습니다. 예를 들어, 주문의 상태 ID를 표시하려면 헤더의 ID 필드를 이 필드에 추가하여 후속 대화에서 사용할 수 있습니다.
필드에 요소 배열이 필요한 경우, 아래 예제와 같이 해당 필드에 대괄호를 추가해야 합니다: data[].id, data[].name
배열의 특정 요소에 대해 인덱스 번호를 사용하면 해당 필드의 값을 표시합니다: data[1].id는 위의 예제에서 두 번째 값을 표시합니다: 60002
API 목록 페이지:
API 라이브러리 목록 페이지에서 구성한 API를 이름으로 검색할 수 있습니다. 나열된 API는 API가 수행하도록 설정된 작업 유형(GET 또는 POST 등), 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 응답에서 결제의 '상태'를 가져와 상태가 미지불인 경우 에이전트를 다른 대화/흐름으로 리디렉션하거나 상태가 지불된 경우 에이전트에게 간단한 메시지를 표시하도록 대화를 설정하여 고객에게 동일한 내용을 전달할 수 있습니다.