멀티파트 API를 사용하여 봇 대화에서 첨부파일과 같은 여러 데이터 세트를 결합하여 선호하는 타사 시스템으로 보낼 수 있습니다.
REST API의 멀티파트 폼 데이터 형식은 하나 이상의 데이터 세트를 경계로 구분하여 단일 본문으로 결합합니다. 이러한 요청은 일반적으로 파일 업로드 및 여러 유형의 데이터를 단일 요청으로 전송하는 데 사용됩니다 (예: 파일과 JSON 객체 함께).
우리의 API 라이브러리에서 멀티파트 폼 데이터 지원을 통해 봇 대화 중 수집된 파일 첨부 및 기타 정보를 REST API를 지원하는 타사 애플리케이션에 전달할 수 있습니다.
- 예를 들어, 고객이 봇과 상호작용할 때 REST API의 멀티파트 폼 데이터 형식을 사용하여 파일 첨부와 함께 추가 컨텍스트를 수집하고 이를 Freshdesk에 전달하여 티켓을 생성할 수 있습니다.
멀티파트 API 설정
- 봇으로 이동하여 새 봇을 생성하거나 기존 봇을 선택합니다
- 플로우 > 구성 > API 라이브러리로 이동합니다.
- 새 API 버튼을 사용하여 새 API 호출을 구성할 수 있습니다.
- POST 또는 PUT과 같은 메서드를 선택하면 JSON 또는 멀티파트 폼 데이터 페이로드 유형 중에서 선택할 수 있는 옵션이 제공됩니다.
- 페이로드 유형 드롭다운에서 멀티파트 폼 데이터를 선택합니다. 이제 구성할 수 있는 구조화된 페이로드 콘텐츠 필드 세트를 볼 수 있습니다.
- 이 페이로드에서 키 이름과 해당 콘텐츠 유형을 입력할 수 있습니다. 키와 연결된 콘텐츠 유형은 텍스트 또는 파일 유형일 수 있습니다.
콘텐츠 유형: 텍스트 | 콘텐츠 유형: 첨부파일 |
|---|---|
텍스트로 된 콘텐츠 유형의 키의 경우 값은 하드코딩되거나 텍스트 필드 입력을 수집하는 대화 상자에서 콘텐츠 선택기를 사용하여 구성할 수 있습니다. 이 예에서 Dialog 1.2는 고객으로부터 텍스트 입력을 수집합니다.  | 파일로 된 콘텐츠 유형의 키의 경우 파일 및 이미지 입력을 수집하는 대화 상자에서 콘텐츠 선택기를 사용하여 값을 구성합니다. 이 예에서 Dialog 3.1은 고객으로부터 파일 또는 이미지를 수집합니다.  |
멀티파트 폼 데이터 API는 Dialog 1.2에서 값을 가져오도록 구성할 수 있으며, 이는 API를 통해 전달될 수 있습니다.
텍스트 값은 API 라이브러리에서 하드코딩할 수도 있습니다. | 멀티파트 폼 데이터 API는 Dialog 3.1에서 값을 가져오도록 구성할 수 있으며, 이는 API를 통해 전달될 수 있습니다.
|
봇 플로우에서 멀티파트 API 트리거
- 멀티파트 폼 데이터 API를 구성한 후 봇 플로우에서 API를 트리거할 수 있습니다.
- API 호출이 성공하면 관련 텍스트 또는 첨부파일이 타사 애플리케이션으로 전달됩니다.
- API 호출이 실패하면 관련 API 상태 및 로그가 대화 > API 호출에서 확인 가능하며, 이를 통해 구성 오류를 디버그하고 수정할 수 있습니다.