Multipart form API란 무엇인가요?
REST API의 Multipart form 데이터 형식은 하나 이상의 데이터 세트를 경계로 구분하여 단일 본문으로 결합합니다. 일반적으로 이러한 요청은 파일 업로드 및 여러 유형의 데이터를 단일 요청으로 전송하는 데 사용됩니다 (예: 파일과 JSON 객체를 함께 전송).
우리의 API 라이브러리에서 Multipart form 데이터 지원을 통해 고객은 봇 대화 중 수집된 파일 첨부 및 기타 정보를 타사 애플리케이션에 전달할 수 있습니다.
예를 들어, 최종 사용자가 봇과 상호 작용할 때 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에서 이 첨부 파일을 타사 시스템에 전달할 수 있습니다.
- Multipart form 데이터 API를 구성한 후에는 봇 흐름에서 API를 트리거할 수 있습니다.
- 성공 시, 관련 텍스트 또는 첨부 파일과 함께 관련된 타사 앱에 레코드가 생성됩니다.
- API가 실패할 경우, 관련 API 상태 및 로그가 디버그 및 API 구성 수정에 사용 가능합니다.