멀티파트 API란 무엇이며, 봇에서 첨부 파일을 보내기 위해 멀티파트 API를 어떻게 사용하나요?

멀티파트 API를 사용하여 봇 대화에서 첨부 파일과 같은 여러 데이터 세트를 결합하여 선호하는 타사 시스템으로 보낼 수 있습니다. REST API의 멀티파트 폼 데이터 형식은 하나 이상의 데이터 세트를 경계로 구분하여 단일 본문으로 결합합니다. 일반적으로 이러한 요청은 파일 업로드 및 여러 유형의 데이터를 단일 요청으로 전송하는 데 사용됩니다 (예: 파일과 JSON 객체 함께). 

우리의 API 라이브러리에서 멀티파트 폼 데이터 지원을 통해 봇 대화 중 수집된 파일 첨부 파일 및 기타 정보를 REST API를 지원하는 타사 애플리케이션에 전달할 수 있습니다. 

예를 들어, 고객이 봇과 상호작용할 때, REST API의 멀티파트 폼 데이터 형식을 사용하여 파일 첨부 파일과 추가 컨텍스트를 수집하고 이를 Freshdesk에 전달하여 티켓을 생성할 수 있습니다. 

멀티파트 API 설정

• 봇으로 이동하여 새 봇을 만들거나 기존 봇을 선택합니다.
• 흐름 > 구성 > API 라이브러리 > 새 API 버튼으로 이동합니다.
• POST 또는 PUT과 같은 메서드를 선택할 때, 다음 옵션 중에서 페이로드 유형을 정의할 수 있습니다: JSON, 멀티파트 폼 데이터, URL 인코딩된 폼.

페이로드 유형 드롭다운에서 멀티파트 폼 데이터를 선택합니다. 이제 구성할 수 있는 구조화된 페이로드 콘텐츠 필드 세트를 볼 수 있습니다. 이 페이로드에서 키 이름과 해당 콘텐츠 유형을 입력할 수 있습니다. 키와 연결된 콘텐츠 유형은 텍스트 또는 파일 유형일 수 있습니다.

멀티파트 API를 위한 데이터 수집에 봇 흐름 사용하기

콘텐츠 유형: 텍스트

콘텐츠 유형이 텍스트인 키의 경우, 값은 하드코딩되거나 텍스트 필드 입력을 수집하는 대화 상자에서 콘텐츠 선택기를 사용하여 구성할 수 있습니다. 이 예에서는 대화 상자 1.2가 고객으로부터 텍스트 입력을 수집합니다:

멀티파트 폼 데이터 API는 대화 상자 1.2에서 값을 가져오도록 구성할 수 있으며, 이는 API를 통해 전달될 수 있습니다. 

필요한 경우, 동적 값을 정적 텍스트 값으로 대체할 수 있습니다. 이는 모든 고객에게 하나의 값만 공유해야 할 때 유용합니다. 예를 들어, 서비스가 하나의 언어로만 제공되는 경우 언어를 공유하는 경우입니다.

콘텐츠 유형: 첨부 파일

콘텐츠 유형이 파일인 키의 경우, 파일 및 이미지 입력을 수집하는 대화 상자에서 콘텐츠 선택기를 사용하여 값을 구성합니다. 이 예에서는 대화 상자 3.1이 고객으로부터 파일 또는 이미지를 수집합니다.

멀티파트 폼 데이터 API는 대화 상자 3.1에서 값을 가져오도록 구성할 수 있으며, 이는 API를 통해 전달될 수 있습니다.

봇 흐름에서 멀티파트 API 트리거하기

멀티파트 폼 데이터 API를 구성한 후, 봇 흐름에서 API를 트리거할 수 있습니다.

API 호출이 성공하면 관련 텍스트 또는 첨부 파일이 타사 애플리케이션으로 전달됩니다. API 호출이 실패하면 관련 API 상태 및 로그가 대화 > API 호출에서 디버그 및 구성 수정에 사용할 수 있습니다.