봇 빌더에서 API 라이브러리 설정하기

모든 외부 시스템에 대한 광범위한 API 호출을 통해 데이터를 가져오거나 푸시하고 이를 봇 대화의 일부로 표시할 수 있습니다. 대화창에서 API 호출을 트리거할 때마다 매개변수를 전달할 필요가 없습니다. 대신 API 라이브러리에서 한 번 구성한 후 모든 대화창에서 재사용할 수 있습니다.

내용 표

• 새 API 만들기에 대한 빠른 가이드:
• API 구성에 대해 설명합니다:
• API 목록 페이지:

새 API 만들기에 대한 빠른 가이드입니다:

• 좌측 창에서 Bots로 이동하세요.
• 새 봇을 만들거나 편집하려는 봇을 선택합니다.
• 흐름 및 구성
  

로 이동합니다: justify;">

• +새롭게 추가 버튼을 사용하면 새 API 호출을 구성할 수 있습니다
  

"Configuring-the-API:" style="text-align: justify;">

• 이름: API 호출에 적절한 이름을 지정하세요.
• URL/JS 함수 이름: 엔드포인트 URL을 여기에 입력합니다. 이 필드의 콘텐츠 선택기 옵션 [+]를 사용하면 고객 입력, 기타 API 응답, 기본 매개변수 등과 같은 플레이스홀더 값을 추가할 수 있습니다.

• 방법: GET, PUT, POST, DELETE 또는 JS 함수 등 수행하려는 API 호출 유형을 구성한 다음 페이로드를 적절히 전달합니다. 확장 가능한 텍스트 편집기에서 더 큰 페이로드 콘텐츠를 구성하여 붙여넣을 때 자동으로 JSON 형식을 지정할 수도 있습니다. 예를 들어 Freshdesk 계정에서 티켓을 만들려면 이메일, 우선 순위, 상태, 제목 및 설명을 JSON으로 전달합니다. 오른쪽 하단의 +  아이콘을 사용하여 플레이스홀더를 사용할 수도 있습니다.
  

• 헤더 추가: 이 필드에서 API를 승인하고 이 섹션에서 헤더로 추가 파라미터를 전달할 수도 있습니다.

• Test: API 호출을 올바르게 구성했는지 확인하려면 테스트 실행 확인란을 선택하여 샘플 테스트를 실행하고 페이로드에 구성한 동적 필드에 대한 테스트 값을 전달하고(PUT, POST 및 JSON 메서드의 경우) 응답 헤더를 확인할 수 있습니다.
  

• 필수 응답 매개변수 추가 또는 제거: 챗봇 대화에 있는 모든 대화창의 응답 헤더에서 모든 속성을 참조할 수 있습니다. 테스트 변수 응답을 실행하기 전에 버튼 클릭 한 번으로 필수 응답 매개변수를 추가하거나 제거할 수 있습니다.
  

API 목록 페이지:

Flows > 구성 > API 라이브러리에서 API 라이브러리에 액세스할 수 있습니다. 이 페이지에서 구성한 API 목록을 볼 수 있습니다. 이 외에도 다음을 수행할 수 있습니다.

• 이미 구성한 API를 검색
• API가 수행하도록 설정된 작업 유형(GET, POST 등)을 확인합니다.
• API 생성 시기 및 마지막으로 수정된 시기를 표시합니다.
• 각 API를 편집 또는 삭제하거나 새 API를 생성할 수 있습니다.

API 사용에 대한 빠른 가이드

메시지, 액션 또는 조건을 통해 API의 응답을 추가할 수 있습니다.

메시지를 사용하여 API 응답을 추가합니다:

• 고객에게 표시할 메시지 또는 질문을 입력합니다.
• + 아이콘를 클릭하여 플레이스 홀더 > API에 액세스합니다.
• 봇 빌더는 API 라이브러리에 구성된 모든 API의 목록을 표시할 것입니다.
• 필요한 API를 선택하여 텍스트 상자에 추가합니다.
  
  예를 들어 보세요: 봇 대화에 대한 티켓을 만드는 경우에는 티켓 만들기 API 호출을 설정할 수 있습니다. 그런 다음 응답 매개 변수에서 티켓 ID를 참조할 수 있습니다.

아래 작업:

• 대화 상자에서 새 작업 만들기
• 작업 유형을 트리거 API
• 해당 봇의 API 라이브러리 아래에 구성된 모든 API 목록에서 필요한 API를 선택합니다.
  
  
• 흐름의 어느 곳에나 Trigger API  액션을 삽입할 수 있습니다.
• 메시지 전에 API를 트리거해야 하는 경우 메시지 앞에 트리거 API 작업을 작성하세요.
• 유사하게, 메시지 이후에 API를 트리거해야 하는 경우 트리거 API 액션 이후.
  

조건부:

• 필수 대화 상자의 조건 탭을 열고 + 아이콘을 클릭하여 자리 표시자에 액세스하고, 드롭다운에서 API를 선택합니다.
• API 라이브러리에 구성된 모든 API 목록을 볼 수 있습니다.
• 필요한 API 호출을 선택한 다음 응답 값을 선택합니다.
• 조건 본문과 조건 값 섹션 모두에서 API의 응답을 사용할 수 있습니다.
  
  
  예를 들어: 간단한 구독 플로우의 경우, API r에서 결제 상태를 가져와 미결제 상태인 경우 고객을 다른 대화 상자/플로로 리디렉션하거나 결제 상태와 동일한 경우 고객에게 간단한 메시지를 표시하는 대화 상자를 설정할 수 있습니다.

주: JSON 응답이 있는 REST API만 지원됩니다.

주: 응답이 수신되지 않으면 10초 후에 API 요청이 시간 초과됩니다.

더 궁금한 점이 있으면 [email protected] 으로 문의하시면 기꺼이 도와드리겠습니다.