Slack 連携（先行提供中の Slack アプリ）
Re:port Flow の Slack アプリ「Report Flow」を使うと、Slack の /reportflow コマンドからテンプレートを選び、表示されるフォームに入力するだけで PDF を作れます。できた PDF は、コマンドを実行したチャンネル（投稿できないときは本人の DM）に届きます。
Slack アプリは一般公開・Slack Marketplace 掲載の前の先行提供です。Slack Marketplace（App Directory）では見つからないため、このページのインストール用のリンクから直接インストールしてください。Slack による審査・認定を受けたアプリではありません。先行提供中は、画面の表記や手順・提供する操作が変わることがあります。
できること
| 操作 | 内容 | 状態 |
|---|---|---|
/reportflow コマンド | 接続した Re:port Flow のワークスペースのテンプレートを選び、Slack のフォーム（モーダル）に入力して PDF を作成します | 提供中 |
| PDF の受け取り | コマンドを実行したチャンネルに、依頼した人へのメンションと受付番号を添えて PDF を投稿します。DM から実行したとき、またはチャンネルに投稿できないときは、本人の DM に送ります | 提供中 |
| Slackbot からの利用 | Slackbot から Re:port Flow の MCP サーバーに接続し、自然言語でテンプレートの確認や PDF の生成を頼めます。生成した PDF は Slack に添付せず、ログインが必要な出力履歴へのリンクで確認します | 提供中（Slackbot を使えるかは Slack 側のプランによります） |
次の操作は提供していません。
- Slack のメッセージやショートカットからの起動（起動は
/reportflowコマンドだけです） - 決まった時刻やイベントをきっかけにした自動作成
- スレッドへの返信としての投稿、指定した別のチャンネルや人への送付
- CSV・Excel など PDF 以外の出力、1 回の依頼で複数の PDF をまとめて作ること
事前に用意するもの
- Slack ワークスペースの管理者またはオーナーの Slack アカウント。インストールと Re:port Flow への接続は管理者・オーナーだけが行えます（メンバー・ゲストが試しても接続されません）
- Re:port Flow のワークスペースと、そのワークスペースで PDF を生成できる Re:port Flow アカウント（re-port-flow.com で作成）
- PDF のもとになるテンプレート。まだ無い場合は、Re:port Flow の画面で作成するか、テンプレートギャラリーから複製してください
インストールと Re:port Flow への接続
Slack ワークスペース 1 つにつき、接続は 1 回です。接続すると、そのワークスペースのメンバー全員が /reportflow を使えるようになります。
-
Slack ワークスペースの管理者またはオーナーが、下の Add to Slack ボタン（インストール用のリンク https://slack.re-port-flow.com/slack/install）を開く
-
Slack の画面で、インストール先のワークスペースと、アプリが求める権限を確認して 許可する を選ぶ
-
続けて Re:port Flow のログイン画面が開くので、ログインし、使う Re:port Flow のワークスペースを選んで同意する
-
「Report Flow に接続しました」と表示されたら完了です。ページを閉じて Slack に戻ってください
接続には OAuth 2.0（Authorization Code + PKCE）を使い、アプリが要求する Re:port Flow のスコープは openid・profile・pdf:generate です（OAuth 2.0 > スコープ）。API キーを Slack に貼り付ける必要はありません。
PDF の生成は、接続の手続きで同意した Re:port Flow アカウントの権限で行います。Slack 上で誰がコマンドを実行しても、使えるテンプレートとプランの上限は、このアカウントと選んだワークスペースのものです。
アプリが Slack に要求する権限
| スコープ | 使いみち |
|---|---|
commands | /reportflow コマンドを受け取る |
chat:write | 受付や失敗の案内を送る |
files:write | 作成した PDF をチャンネル・DM にアップロードする |
im:write | 本人への DM を開く |
users:read | 接続する人が管理者・オーナーか、コマンドを実行した人がワークスペースのメンバーかを確かめる |
channels:read / groups:read | PDF をチャンネルに投稿してよいか（アプリが参加しているか・外部の組織と共有していないか・アーカイブされていないか）を確かめる |
mcp:connect | Slackbot から Re:port Flow の MCP サーバーに接続する |
Slack のメッセージ履歴を読む権限は要求しません。
使い方（/reportflow）
- PDF を共有したいチャンネル（または Report Flow アプリとの DM）で
/reportflowと入力して送信する - 開いた画面でテンプレートを選ぶ（選択肢に出るのは最大 100 件です）
- テンプレートの項目がフォームとして表示されるので、値を入力する。明細（表）の項目は 行を追加 / 行を削除 で行数を変えられます
- 送信 を選ぶと「受け付けました」と表示されます
- PDF ができると、コマンドを実行したチャンネルに投稿されます（DM から実行したときは本人の DM に届きます）
チャンネルに投稿するには、Report Flow アプリがそのチャンネルに参加している必要があります。参加していないチャンネルで実行した場合は、本人の DM に PDF と理由が届きます。チャンネル名を選 び、インテグレーション からアプリを追加してください。外部の組織と共有しているチャンネル（Slack Connect）とアーカイブされたチャンネルには投稿せず、本人の DM に送ります。
フォームで入力できる項目
| テンプレートの項目 | Slack のフォーム |
|---|---|
| テキスト・URL | 文字の入力欄 |
| 数値 | 数値の入力欄 |
| 日付 | 日付の選択欄 |
| 真偽値 | 「はい」「いいえ」「未指定」の選択 |
| オブジェクト（グループ） | 中の項目を 1 つずつ入力欄として並べます |
| 明細（配列） | 行ごとに列の入力欄を並べます。行の追加・削除ができます |
次のテンプレートは Slack から作成できません。「Slack から入力できる形ではありません」「項目が多いため、Slack の画面に入りきりません」と表示された場合は、Re:port Flow の画面から作成してください。
- 明細の行の中にさらに明細がある（入れ子の配列）
- 明細の列や、グループの中の項目が定義されていない
- 項目や明細の行が多く、Slack のフォームの表示上限を超える
Re:port Flow が返す項目の定義には必須・選択肢・既定値が含まれないため、Slack のフォームにも必須の印・選択肢・既定値は表示しません。空欄のまま送った項目は値を渡さずに PDF を作るので、その項目はテンプレートのデザインで決めた表示（多くは空欄）になります。項目の考え方は変数の基本を参照してください。
Slackbot から使う
アプリをインストールすると、Slackbot から Re:port Flow の MCP サーバー（https://mcp.re-port-flow.com/mcp）に接続できるようになります。
- Slackbot の画面で、Report Flow の接続を選ぶ
- 開いた画面で Re:port Flow にログインし、ワークスペースを選んで同意する。この接続は利用者ごとで、
/reportflow用にワークスペース単位で行った接続とは別です - Slackbot に「Re:port Flow のテンプレート一覧を見せて」「請求書のテンプレートで PDF を作って」などと頼む
- 使えるツールと認証の詳細は MCP サーバー連携を参照してください
- 生成した PDF は Slack に添付しません。生成ツールの応答に入っている 出力履歴のリンク（Re:port Flow へのログインが必要）から確認してください。非同期で生成したときも、リンクは requestId と一緒に生成ツールの応答で返ります。生成状況の確認（
get_generation_status。権限とツールの対応）は完了したかを返すだけで、リンクは入りません - Slackbot を使えるかどうか・利 用の上限は、Slack 側のプランや管理者の設定によります
- 接続をやめるときは、Slackbot の接続設定から切断します
接続の解除・付け替え
- 解除する: Slack のアプリの管理画面から Report Flow アプリをアンインストールします。削除すると、その Slack ワークスペースの接続情報と入力途中のフォームの記録を消します
- 別の Re:port Flow ワークスペースに付け替える／接続し直す: 管理者またはオーナーが、もう一度インストール用のリンクから手続きします。前の接続は新しい接続に置き換わります
セキュリティとデータの扱い
- 接続情報は暗号化して保存します。 Slack の bot token と Re:port Flow のトークンは、Re:port Flow のサーバー側に暗号化して保存し、Slack の画面やメッセージには載せません
- 入力途中のフォームの記録は最長 24 時間で消します。 入力した値を Slack のフォームの裏側（
private_metadata）に入れることはしません - 使える人を限っています。
/reportflowを使えるのはその Slack ワークスペースのメンバーだけで、ゲストと Slack Connect の外部の利用者は使えません - アンインストールとトークンの失効を Slack から受け取ると、その Slack ワークスペースの接続情報を消します
作成した PDF と入力したデータは Re:port Flow 側でも扱われます。保存場所・保存期間・暗号化についてはセキュリティとデータの取り扱いを参照してください。Slack にアップロードした PDF は Slack のファイルとして残り、Re:port Flow からは回収できません。
制限事項
- 先行提供中のため、一般公開までに画面・手順・提供する操作が変わることがあります
- アプリの画面と案内は日本語です
/reportflowの接続は Slack ワークスペースごとに 1 つ（1 つの Re:port Flow ワークスペース）です。チャンネルごとや利用者ごとに別の Re:port Flow ワークスペースを使い分けることはできません（Slackbot からの接続は利用者ごとです）- Enterprise Grid の組織全体へのインストールには対応していません（ワークスペースごとにインストールしてください）
- 1 回の依頼で作れる PDF は 1 つです
- テンプレートの選択肢に出るのは 100 件までです
- PDF の生成は Re:port Flow API を通して行うため、ワークスペースのプランの出力上限やリクエストの制限が適用されます（制限事項）
トラブルシューティング
「管理者による接続が必要です」と表示される
Re:port Flow への接続は、Slack ワークスペースの管理者またはオーナーだけが行えます。管理者・オーナーにインストール用のリンクを送り、手続きを依頼してください。
「インストールできませんでした」「接続できませんでした」と表示される
手続きの途中で時間がたった、別のブラウザで続きを開いた、または Slack や Re:port Flow の画面で許可しなかった場合に表示されます。インストール用のリンクから最初からやり直してください。「PDF の作成に必要な権限が許可されませんでした」と表示された場合は、Re:port Flow の同意画面ですべての権限を許可してください。
/reportflow を実行すると「まだ Re:port Flow に接続されていません」と表示される
その Slack ワークスペースはまだ接続されていません。表示された案内に従い、管理者・オーナーが接続してください。
「Re:port Flow との接続が切れています」「接続し直してから」と表示される
接続に使った Re:port Flow アカウントのトークンが無効になったか、そのアカウントがワークスペースの権限を失いました。管理者・オーナーがインストール用 のリンクから接続し直してください。PDF が作成済みで受け取れなかった場合は、もう一度依頼せず、Re:port Flow の出力履歴から取得してください。
「このワークスペースのメンバーだけが使えます」と表示される
ゲストと、Slack Connect で参加している外部の組織の利用者は /reportflow を使えません。
テンプレートが選択肢に出ない／「まだテンプレートがありません」と表示される
表示された案内によって原因が違います。
- 「まだテンプレートがありません」: 接続した Re:port Flow のワークスペースにテンプレートがありません。Re:port Flow の画面でテンプレートを作成するか、ギャラリーから複製してから、もう一度コマンドを実行してください
- 選択肢の下に「ほか ○ 件のテンプレートは、ここには表示できません」: 選択肢に出るのは 100 件までです。目的のテンプレートが選択肢に無いときは、Re:port Flow の画面から PDF を作成してください
- 「テンプレートは、Slack から選べる形ではありません」: Slack から選べるテンプレートがありません。Re:port Flow の画面から PDF を作成してください
「このフォームの期限が切れました」「テンプレートが変わりました」と表示される
フォームを開いてから時間がたったか、開いた後にテンプレートが編集されました。もう一度 /reportflow を実行して開き直してください。
PDF がチャンネルではなく DM に届いた
DM に、チャンネルに投稿しなか った理由が書かれています。アプリがチャンネルに参加していない場合は、チャンネルの インテグレーション からアプリを追加してください。Slack Connect のチャンネルとアーカイブされたチャンネルには投稿しません。
「プランの上限に達しています」と表示される
接続している Re:port Flow のワークスペースが、プランの出力上限に達しています。プランと利用状況を確認してください。
「作成できたか確かめられませんでした」「届けられたか確かめられませんでした」と表示される
二重に作成・送信しないよう、自動ではやり直していません。チャンネルや DM に PDF が無いことを確かめてから、Re:port Flow の出力履歴を確認してください。DM に表示 される受付番号は、問い合わせのときに伝えてください。
関連ページ
- インテグレーション概要 — ほかの連携との比較
- MCP サーバー連携 — Slackbot から使うツールと認証
- OAuth 2.0 — 認可フローとスコープ
- 変数の基本 — テンプレートの項目の作り方