File

봇이 파일 메시지를 전송할 수 있다.

파일은 URL 방식과 파일 ID 방식으로 전송할 수 있다.

  • URL 방식은 HTTPS만 허용하며 originalContentUrl 파라미터를 사용한다.
  • 파일 ID 방식은 콘텐츠 업로드 API로 획득한 파일 ID를 사용하여 메시지를 발송한다.

참고(파일 ID 방식)

  • 메시지를 전송할 때마다 파일의 크기만큼 수신인의 도메인 공용 용량이 차감된다.
  • 파일의 확장자가 다음과 같은 경우 메시지 전송이 기본으로 차단된다.
 'bat', 'cmd', 'com', 'cpl', 'exe', 'scr', 'js', 'vbs', 'wsf', 'hta' 
  • Admin > 파일 보안 에서 기본 차단 확장자를 해제하거나 추가 차단 확장자를 지정할 수 있다.

Request Content {#file-request}

파라미터타입필수 여부설명
typestringY"file"로 고정
originalContentUrlstringN원본 파일이 위치한 URL(파일 확장자 형식, HTTPS만 허용).
최대 글자수: 1000자.
originalContentUrl, fileId 중 하나만 지정해야 하며, 필수다.
fileIdstringN콘텐츠 업로드 시 획득한 파일 ID.
originalContentUrl, fileId 중 하나만 지정해야 하며, 필수다.

Request Example {#file-request-example}

URL 방식 {#file-request-example-url}

{  "content": {    "type": "file",    "originalContentUrl": "https://line.worksmobile.com/kr/wp-content/uploads/2020/05/user-start-guide-v2.0.pdf"  }}

파일 ID 방식 {#file-request-example-fileid}

{  "content": {    "type": "file",    "fileId": "jp1.1628695315008671000.1628781715.0.1000001.0.0.0"  }}