어시스트 봇에서 API 라이브러리 설정하기

수정일 일요일, 9 3월 시간: 2:28 PM

어시스트 봇의 빌더를 사용하면 모든 외부/내부 시스템에 대한 광범위한 API 호출을 통해 데이터를 가져오거나 푸시하여 봇 대화의 일부로 표시할 수 있습니다. 또한 관리자는 대화 상자에서 API 호출을 트리거할 때마다 매개변수를 전달할 필요 없이 이전 또는 다른 대화 상자에서 매개변수를 재사용할 수 있으며, API 라이브러리에서 모든 매개변수를 구성하여 매우 쉽게 수정할 수도 있습니다.

대화 상자에서 호출해야 하는 모든 단일 API 호출은 API 라이브러리에서 구성할 수 있으며, 필요한 대화 상자의 Trigger API 탭에서 'Actions' 옵션을 선택해 호출할 수 있습니다.

새 API 생성을 위한 빠른 가이드:

로 Freshdesk 계정에 로그인합니다: border-box; font-weight: 700;"> 관리자
관리 &;상담원 생산성 &; 지원 봇 아래 프레디 구성
봇 목록 페이지에서 편집하려는 봇을 선택합니다
'API 라이브러리' 아이콘을 오른쪽 탐색 표시줄에서 클릭합니다

'+ 새 API' 버튼을 사용하면 새 API 호출

API 구성하기:

이름: API 호출에 적합한 이름을 지정하세요.
URL/JS 함수 이름: 여기에 콜백 URL을 입력합니다. 이 필드의 콘텐츠 선택기 옵션[+]을 사용하면 대화의 값을 콜백 URL에 추가할 수 있습니다.
방법: GET, PUT, POST, DELETE 또는 JS 함수 등 원하는 API 호출 유형을 구성한 다음 그에 따라 페이로드를 전달합니다. 확장 가능한 텍스트 편집기에서 더 큰 페이로드 콘텐츠를 구성하여 붙여넣을 때 자동으로 JSON 형식을 지정할 수도 있습니다. 예를 들어 Freshdesk 계정에서 티켓을 만들려면 이메일, 우선 순위, 상태, 제목 및 설명을 JSON으로 전달합니다. 오른쪽 하단의 + 아이콘을 사용하여 자리 표시자를 사용할 수도 있습니다.

, Roboto, &"Helvetica Neue&">, Arial, sans-serif; font-size: 13px; text-align: justify; text-indent: 0px;">헤더 추가:, Roboto, &"Helvetica Neue&;>, Arial, sans-serif; font-size: 13px; font-weight: 400; text-align: justify; text-indent; text-indent: 0px; display: inline !important;"> 이 필드에서 API를 인증하고 이 섹션의 헤더로 추가 매개변수를 전달할 수도 있습니다.

, Roboto, &"Helvetica Neue&">, Arial, sans-serif; font-size: 13px; text-align: justify; text-indent: 0px;">Test:, Roboto, &"Helvetica Neue&;>, Arial, sans-serif; font-size: 13px; font-weight: 400; text-align: justify; text-indent; text-indent: 0px; display: inline !important;"> API 호출이 올바르게 구성되었는지 확인하려면 샘플 테스트 실행을 수행하고 페이로드에 구성한 동적 필드에 대한 테스트 값을 전달하고(PUT, POST 및 JSON 메서드의 경우) 응답 헤더를 확인할 수 있습니다.

, Roboto, &"Helvetica Neue &">, Arial, sans-serif; font-size: 13px; font-weight: 400; text-align: justify; text-indent: 0px; 디스플레이: 인라인 !중요;">

필수 응답 파라미터 추가: 응답 헤더의 속성은 챗봇 대화에서 어떤 대화창에서도 참조할 수 있습니다.<예를 들어 주문의 상태 ID를 표시하려는 경우 헤더의 ID 필드를 이 필드에 추가하여 후속 대화창에서 사용할 수 있습니다.

요소 배열이 필요한 경우 아래 예시와 같이 해당 필드에 대괄호를 추가해야 합니다: data[].id, data[].name

배열의 특정 요소에 대해 색인 번호를 사용하면 해당 필드에 해당 값이 표시됩니다: data[1].id는 위 예제에서 필드에 두 번째 값을 표시합니다: 60002

API 목록 페이지:

API 라이브러리 목록 페이지에서 이름을 사용하여 구성한 API를 검색할 수 있습니다. 나열된 API는 API가 수행하도록 설정된 작업 유형(GET 또는 POST 등)을 알려주고 API가 생성된 시기와 마지막으로 수정된 시기를 표시합니다. API에 대한 '더보기' 아이콘을 클릭하면 해당 API를 수정하거나 삭제할 수 있습니다.

API 사용에 대한 빠른 가이드:

프레시데스크에 로그인 계정으로 관리자
로 이동합니다: 700;">관리자 상담사 생산성 프레디 구성에서 봇 지원
봇 목록 페이지에서 편집하려는 봇을 선택합니다
원하는 봇의 흐름을 클릭합니다
사용 사례에 따라 '메시지 또는 질문' 또는 '작업' 또는 '조건' 탭에서 API의 응답을 추가할 수 있습니다
언더 메시지 또는 질문: 상담원에게 표시할 메시지나 질문을 텍스트 상자에 입력하고 콘텐츠 선택 아이콘 [+]를 클릭한 다음 'API'를 선택합니다. 해당 봇의 API 라이브러리 아래에 구성된 모든 API 목록이 표시됩니다. 필요한 API를 선택하여 텍스트 상자에 추가합니다.
예: 주문 상태를 가져오는 경우 주문 관리 시스템에 연결하고 응답 파라미터에서 주문 상태를 참조하도록 API 호출을 설정할 수 있습니다.

작업 아래: '작업 유형'을 '트리거 API'로 설정한 다음 해당 봇의 API 라이브러리 아래에 구성된 모든 API 목록에서 필요한 API를 선택합니다.
예: 페이지의 URL을 가져오도록 API 응답을 구성하는 경우 작업에서 해당 API를 참조하여 상담원이 봇에서 해당 URL에 액세스할 수 있도록 할 수 있습니다.

조건에 따라: '조건' 탭에서 봇 플로우의 필수 대화 상자로 이동하여 콘텐츠 선택기 [+] 아이콘을 클릭하고 드롭다운에서 'APIs'를 선택합니다. 해당 봇의 API 라이브러리 아래에 구성된 모든 API 목록을 볼 수 있습니다. 필요한 API 호출을 선택한 다음 응답 값을 선택합니다. API의 응답은 조건 본문과 조건의 값 섹션 모두에서 사용할 수 있습니다.
예시를 들어보겠습니다: 간단한 가입 플로우의 경우, API 응답에서 결제 '상태'를 가져와서 미결제 상태인 경우 상담원을 다른 대화 상자/플로어로 리디렉션하거나 결제 상태인 경우 상담원에게 간단한 메시지를 표시하는 대화 상자를 설정하여 고객에게 동일하게 전달할 수 있도록 할 수 있습니다.