Soracom

Slack ファイルアップロードアクションは、指定された URL からファイルを取得し、指定された Slack チャンネルにアップロードします。ソラカメ画像取得アクションで取得した静止画など、ほかのアクションが出力したファイルを Slack で共有できます。

Slack 通知アクション でファイルの URL をメッセージとして送信した場合、有効期限のある URL (例: ソラカメ画像取得アクションが出力する imageUrl) は、有効期限が過ぎると Slack で表示できなくなります。Slack ファイルアップロードアクションでは、ファイルそのものが Slack に保存されるため、元の URL の有効期限が過ぎたあとも Slack で確認できます。

Slack 側の準備

Slack ファイルアップロードアクションは、Slack App の Bot トークンを使用してファイルをアップロードします。あらかじめ、Slack で以下の準備をしてください。

1. Slack App を作成します。

2. 作成した Slack App の Bot Token Scopes に files:write を追加します。

3. Slack App をワークスペースにインストールします。

   インストールすると、Bot トークン (xoxb- で始まる文字列) が発行されます。Bot トークンについて詳しくは、Slack の Token types (英語) を参照してください。

4. ファイルをアップロードするチャンネルに、作成した Slack App を招待します。

5. ファイルをアップロードするチャンネルのチャンネル ID (例: C0123456789) を確認します。

6. 発行された Bot トークンを、認証情報ストアに API トークン認証情報 として登録します。

   [API トークン] に Bot トークンを入力します。認証情報を登録する操作について詳しくは、認証情報を登録する を参照してください。

Slack ファイルアップロードアクションの設定

CONFIG

アップロードするファイルとアップロード先を設定します。

アップロードできるファイル

• 1 回の実行でアップロードできるファイルは 10 件までです。
• 1 ファイルあたりの大きさは 50 MiB まで、1 回の実行でアップロードできるファイルの合計は 100 MiB までです。
• ファイルの取得とアップロードには、それぞれ 1 ファイルあたり 60 秒の制限時間があります。1 回の実行全体の制限時間は約 4 分 40 秒です。
• SORACOM Flux は、認証情報を付けずにファイルの URL にアクセスします。インターネットから認証なしで取得できる URL (公開 URL や署名付き URL) を指定してください。プライベート IP アドレスなどの内部向けの宛先は指定できません。

上限を超えた場合や、ファイルを取得できなかった場合は、エラーになります。

ファイルの指定例

ソラカメ画像取得アクションで取得した静止画をアップロードする

ソラカメ画像取得アクション の出力先のチャネルに Slack ファイルアップロードアクションを追加し、以下のように設定します。

• [ファイル URL]: ${payload.imageUrl}
• [ファイルタイトル]: ${payload.deviceId}
• [メッセージ]: ${payload.deviceId} の静止画を取得しました。

複数のファイルを 1 つの式で指定する

[式を使って複数の値を指定する (高度な機能)] をクリックすると、複数のファイルを 1 つの式で指定できます。式の評価結果は、以下のいずれかの形式である必要があります。

• URL の配列

  [
    "https://example.com/image1.jpg",
    "https://example.com/image2.png"
  ]
  

• url (ファイルの URL) と title (ファイルのタイトル、省略可) を持つオブジェクトの配列

  [
    { "url": "https://example.com/image1.jpg", "title": "入口のカメラ" },
    { "url": "https://example.com/image2.png", "title": "倉庫のカメラ" }
  ]
  

たとえば、上記の形式の配列が payload.files に含まれる場合は、${payload.files} を指定すると、配列内のファイルをまとめてアップロードできます。メッセージ集約アクション の出力を使用する場合は、messages 内の各メッセージからファイルの URL を取り出し、上記の形式の配列に変換してください。

Slack ファイルアップロードアクションの出力データ

Slack ファイルアップロードアクションでファイルがアップロードされると、アップロードされたファイルの情報が出力されます。files には、Slack の files.completeUploadExternal (英語) から返されたファイルの情報が含まれます。

例:

{
  "ok": true,
  "files": [
    {
      "id": "F0123456789",
      "title": "7CDDE9AAAAAA"
    }
  ]
}

アップロードに失敗した場合は、エラーの内容が出力されます。Slack API がエラーを返した場合は、Slack のエラーコード (例: not_in_channel、missing_scope、invalid_auth) がエラーメッセージに含まれます。主なエラーコードと対処方法は以下のとおりです。