Multipart form API란 무엇인가요?
REST API의 Multipart form 데이터 형식은 하나 이상의 데이터 세트를 경계로 구분하여 단일 본문으로 결합합니다. 일반적으로 이러한 요청은 파일 업로드 및 여러 유형의 데이터를 단일 요청으로 전송할 때 사용합니다 (예: 파일과 JSON 객체를 함께 전송).
우리의 API 라이브러리에서 Multipart form 데이터 지원을 통해 고객은 봇 대화 중에 수집된 파일 첨부 및 기타 정보를 제3자 애플리케이션에 전달할 수 있습니다.
예를 들어, 최종 사용자가 봇과 상호작용할 때, REST API의 Multipart form-data 형식은 봇이 파일 첨부와 함께 추가적인 컨텍스트를 수집하고 이를 Freshdesk에 전달하여 티켓을 생성할 수 있게 합니다.
Freshchat의 Bot builder에서 Multipart API 설정하기
- 왼쪽 패널에서 봇으로 이동합니다.
- 새 봇을 생성하거나 편집할 봇을 선택합니다.
- Flows > Configure > API 라이브러리로 이동합니다.
- 새 API 버튼을 클릭하면 새로운 API 호출을 구성할 수 있습니다.
- POST 또는 PUT과 같은 메서드를 선택하면 JSON 또는 Multipart form 데이터 페이로드 유형을 선택할 수 있는 옵션이 제공됩니다.
- Multipart form 데이터 페이로드 유형을 선택하면 구성할 수 있는 구조화된 페이로드 콘텐츠 필드 세트가 제공됩니다.
- 이 페이로드에서는 키 이름과 그에 따른 콘텐츠 유형을 입력할 수 있습니다. 키와 연관된 콘텐츠 유형은 텍스트 또는 파일 유형일 수 있습니다.
- 텍스트로 된 콘텐츠 유형의 키의 경우, 해당 값은 하드코딩되거나 콘텐츠 선택기를 사용하여 구성할 수 있습니다.
- 파일로 된 콘텐츠 유형의 키의 경우, 값은 파일/첨부 입력이 구성된 대화형 콘텐츠 선택기가 될 수 있습니다. 위 이미지 예시에서: 대화 흐름에서 3.1 대화는 고객으로부터 첨부파일이나 파일을 수집하도록 구성되어 있으며, 이 대화와 연관된 콘텐츠 선택기는 해당 Multipart form 데이터 API에서 이 첨부파일을 제3자 시스템에 전달하는 데 사용할 수 있습니다.
- Multipart form 데이터 API를 구성한 후, 봇 흐름에서 API를 트리거할 수 있습니다.
- 성공 시, 관련된 텍스트나 첨부파일로 제3자 앱에 기록이 생성됩니다.
- API가 실패하면, 관련 API 상태 및 로그가 제공되어 API 구성을 디버그하고 수정할 수 있습니다.