メッセージ送信 (File)

トーク Bot を使ってファイルを送信します。

ファイルの送信には URL 方式とリソース ID 方式があります。

URL 方式の場合、HTTPS のみ対応し、resourceUrl パラメータを使用します。
リソース ID 方式の場合、事前にコンテンツアップロード API を使用して取得したリソース ID を指定してメッセージを送信します。

参考(リソース ID 方式)
アップロードしたファイルは、受信者側の共有ストレージを消費します。
以下のファイル形式の場合は、メッセージの送信が既定で制限されています。
 'bat'、'cmd'、'com'、'cpl'、'exe'、'scr'、'js'、'vbs'、'wsf'、'hta' 
ライト/ベーシック/プレミアムプランを利用しているドメインの管理者は、管理者画面のファイルセキュリティで制限対象のファイル形式を解除したり、追加で制限するファイル形式を指定できます。

APIの種類

サーバーAPI

Request URL

https://apis.worksmobile.com/r/{API ID}/message/v1/bot/{botNo}/message/push

HTTP Method

POST(Content-Type: application/json; charset=UTF-8)

Request Content

パラメータ	タイプ	必須	説明
type	string	Y	"file"
resourceUrl	string	N	元ファイルがある URL (ファイル形式の拡張子、HTTPS のみ) 最大1,000文字 resourceUrl、resourceId のいずれか一方が必須
resourceId	string	N	コンテンツアップロード後に取得したリソース ID resourceUrl、resourceId のいずれか一方が必須

Request Example

URL方式


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

ResourceID方式


{
  "accountId": "admin@example.com",
  "content": {
    "type": "file",
    "resourceId": "WAAAQPwBexX2HnseNvvM9Zyhvp2kIRF3Ul7L7/aMVti8="
  }
}

Response

呼び出しに成功すると HTTP 200 コードを返します。

Error Code

呼び出しに失敗するとエラーコードとエラーメッセージを返します。
エラーコードはトーク Bot REST API エラーコードを参照してください。

LINE WORKS Developers