Make 連携（Re:port Flow アプリ）
Make（旧 Integromat）のシナリオから、公式の Re:port Flow アプリを使って PDF を自動生成できます。Make の Apps 審査を通過済みで、シナリオエディタのモジュール検索から「Re:port Flow」を選ぶだけで利用できます。
本ページは審査通過済みの公式アプリ（トリガー 1 件・アクション 8 件）を前提に説明します。
Make から PDF を生成するには何が必要ですか？
Re:port Flow のワークスペース、1 つ以上のテンプレート、Make のアカウントが必要です 。テンプレートはデザインの選択と PDF 生成で使うため、接続後に追加しても構いません。接続は OAuth 2.0 で認可するため、アプリケーションキーは不要です。
- Re:port Flow のワークスペース（re-port-flow.com で作成）
- PDF のもとになるテンプレートを 1 つ以上作成しておくこと。まだ無い場合は テンプレートギャラリー から複製できます
- Make のアカウント
Re:port Flow を Make に接続するには？
Make のシナリオエディタでモジュールを追加し、アプリ検索で Re:port Flow を選びます。接続の作成では Add connection を選び、表示される認可画面で Re:port Flow にログインし、利用するワークスペースを選んで認可してください。
Re:port Flow アプリの接続方式は OAuth 2.0（Authorization Code + PKCE）のみです。アプリケーションキーを直接貼り付ける入力欄はありません。認可時には次のスコープが要求されます。
| スコープ | 用途 |
|---|---|
openid / profile | 接続ユーザーの識別 |
designs:read | テンプレート一覧・パラメータ構造 の取得（Design ID の選択、Get design parameters） |
templates:read | テンプレート関連情報の取得 |
pdf:generate | PDF 生成・ダウンロード |
単一ワークスペースの自動化になぜ OAuth を使うのかは OAuth 2.0 認証 を参照してください（Make.com のような外部サービス連携は OAuth 2.0 Authorization Code + PKCE が推奨方式です）。
Watch file completed トリガーをシナリオに追加すると、Make がエンドポイント管理API（POST /workspace/:workspaceId/webhook-endpoints ほか）経由で、そのシナリオ専用の Webhook エンドポイントを自動的に作成・削除します（トリガーの Design ID / Version 設定がそのままエンドポイントの対象デザインフィルタになります）。この登録・削除にはワークスペースの管理者（ADMIN）権限が必要なため、接続に使う Re:port Flow アカウントが管理者である必要があります（Webhook通知ガイド）。
管理者以外のアカウントで接続すると、トリガーを有効化した時点で 403（この操作には管理者権限が必要です）になります。PDF を生成するだけのアクション（Generate ... PDF (sync/async) 等）には管理者権限は不要です。
Make で使える Re:port Flow のモジュールは？
公式アプリはトリガー 1 件とアクション 8 件を提供します。トリガーは PDF の生成完了時にシナリオを起動し、アクションは同期・非同期の PDF 生成、ファイルのダウンロード、テンプレートのパラメータ取得、任意の API 呼び出しをカバーします。
| 種類 | モジュール名（Make上の表示） | 用途 |
|---|---|---|
| Trigger（Instant） | Watch file completed | PDF 生成完了時にシナリオを起動。ダウンロード ID・ファイル名・共有 URL・生成時のパラメータを受け取る |
| Action | Generate single PDF (sync) | 単一 PDF を同期生成。ファイル URL とリクエスト ID を即座に返す |
| Action | Generate multiple PDFs (sync) | 複数 PDF を同期生成し、ZIP の URL を即座に返す |
| Action | Generate single PDF (async) | 単一 PDF の非同期生成を開始。requestId を即座に返す |
| Action | Generate multiple PDFs (async) | 複数 PDF の非同期生成を開始し、ループより効率的に一括処理する |
| Action | Download file | requestId を指定して PDF をダウンロード。File ID を空にすると全件 ZIP |
| Action | Get design parameters | テンプレートが要求するパラメータ構造を取得 |
| Action | Build content item | 複数 PDF 生成 1 件ぶんの入力項目（ファイル名・共有設定・パラメータ）を組み立てるヘルパー |
| Action | Make an API call | Re:port Flow API への任意の認証済みリクエストを実行する汎用モジュール |
各生成系モジュールで選ぶ Design ID は接続済みワークスペースのテンプレート一覧から、Template parameters は選んだテンプレートとバージョンに応じて Make が動的に入力欄を組み立てます。パラメータを固定値で書かず、都度取得される項目に沿って入力してください。
Make のシナリオで PDF を生成する方法
任意のトリガーの後に Generate single PDF (sync) アクションを置き、テンプレートを選んで、トリガーの値をテンプレートのパラメータへマッピングします。モジュールは結果（PDF のデータと共有 URL）を即座に返すため、そのまま後続モジュールへ渡せます。
- 任意の トリガー（Google Forms の回答、Google Sheets の行追加など）を配置
- Re:port Flow モジュールを追加し、Generate single PDF (sync) を選択
- 以下を設定:
- Design ID: 対象テンプレートを一覧から選択
- Version: バージョン番号
- File name: 出力ファイル名（例:
invoice.pdf） - Share type:
Workspace（既定）/Invited/Public - Passcode protection: 必要に応じて有効化
- Template parameters: トリガーの値をテンプレートのパラメータへマッピング
- モジュールの出力（
dataのバイナリ、またはfiles[].share.url）を Google Drive・Gmail などの後続モジュールへ渡す
同期生成と非同期生成はどちらを使うべきですか？
PDF が軽量で結果をすぐに受け取りたい場合は同期を使います（同期は 60 秒でタイムアウトします）。生成に時間がかかる PDF や大量生成には非同期を使い、完了は Watch file completed トリガーか Download file のポーリングで検知します。
| 同期（sync） | 非同期（async） | |
|---|---|---|
| タイムアウト | 60 秒 | なし |
| レスポンス | 即座に PDF / ZIP | requestId を即座に返す（生成は非同期） |
| 向いている用途 | 画面操作に対するその場でのダウンロード、軽量な PDF | 生成に時間がかかる PDF、月次一括生成などの大量処理 |
| 完了の検知 | 不要（レスポンスが完了そのもの） | Watch file completed トリガー、または Download file で requestId を指定してポーリング |
複数件をまとめて処理する場合は、Build content item で 1 件ずつの入力（ファイル名・パラメータ等）を組み立ててから Generate multiple PDFs (sync/async) に渡すと、シナリオごとのループ（Make の Operations 消費）を抑えられます。
エラーやレート制限にはどう対処しますか？
401 は接続の失効・未認可、400 は designId が存在しないか、パラメータがテンプレートの必須項目を満たしていないことを示します。Watch file completed での 403 はトリガーを管理者以外のアカウントで接続したことを示し、それ以外の 403 はレスポンスのメッセージ（プラン制限など）を エラーハンドリング で確認してください。レート制限（429）に達した場合は、Retry-After ヘッダーの秒数だけ待ってから再試行 してください。
| 症状 | 原因 | 対処 |
|---|---|---|
401 Unauthorized | 接続が失効・未認可 | Make の 接続（Connections） から Re:port Flow を再接続 |
400 Bad Request | designId が存在しない／Template parameters がテンプレートの必須項目を満たしていない | Get design parameters で必須項目とキー名を再確認 |
403（管理者権限が必要です） | Watch file completed を管理者以外のアカウントで接続 | 管理者アカウントで接続し直す（詳細は上記「Re:port Flow を Make に接続するには？」） |
429 Too Many Requests | ワークスペース単位のレート制限超過（同期 30 req/min、非同期・ダウンロード 100 req/min） | レスポンスの Retry-After ヘッダーの秒数だけ待ってから再試行 |
詳細は エラーハンドリング と 制限事項 を参照してください。
トラブルシューティング
テンプレートの選択肢が表示されないのはなぜですか？
接続したワークスペースにテンプレートが存在するか確認してください。まだ無い場合は テンプレートギャラリー から複製すると選択肢に表示されます。
Watch file completed が起動しないのはなぜですか？
管理者アカウントで接続しているか確認してください（上記の警告を参照）。また、対象テンプレートを絞っている場合は Design ID / Version のフィルタが生成対象と一致しているかを確認してください。
生成した PDF が期待どおりでないのはなぜですか？
パラメータの値が空・型違いになっていないか、Get design parameters の出力と突き合わせて確認してください。
次のステップ
- 非同期ワークフロー設計 — 大量生成のベストプラクティス
- Webhook通知 — 完了通知の仕組みと管理者権限の詳細
- OAuth 2.0 認証 — 認可フローとスコープ