概要
このワークフローでは 手動トリガー を使用し、選択した任意のレコードに対してオンデマンドで PDF を生成できるようにします。 次を ロジック関数 が処理します:- URL(PDF 生成サービスから)から PDF をダウンロードする
- ファイルを Twenty にアップロードする
- レコードに関連付けられた添付ファイルを作成する
前提条件
ワークフローを設定する前に:- API キーを作成: Settings → APIs に移動して新しい API キーを作成します。 ロジック関数でこのトークンが必要になります。
- PDF 生成サービスを設定(任意):PDF を動的に生成したい場合(例: 見積書)は、Carbone、PDFMonkey、DocuSeal のようなサービスを使用して PDF を作成し、ダウンロード URL を取得します。
ステップバイステップの設定
ステップ 1: トリガーを設定
- Workflows に移動し、新しいワークフローを作成します
- 手動トリガー を選択します
- PDF を添付したい対象オブジェクト(例: Company や Opportunity)を選択します
ステップ 2: ロジック関数を追加する
- Code アクション(ロジック関数)を追加する
- 以下のコードで新しい関数を作成します
- 入力パラメーターを設定します
入力パラメーター
| パラメーター | 値 |
|---|---|
companyId | {{trigger.object.id}} |
別のオブジェクト(Person、Opportunity など)に添付する場合は、適切にパラメーター名を変更(例:
personId、opportunityId)し、ロジック関数を更新します。ロジック関数のコード
ステップ 3: ユースケースに合わせてカスタマイズする
別のオブジェクトに添付する場合
targetCompanyId を適切なフィールドに置き換えます:
| オブジェクト | フィールド名 |
|---|---|
| 会社 | targetCompanyId |
| 人物 | targetPersonId |
| 商談 | targetOpportunityId |
| カスタムオブジェクト | targetYourCustomObjectId |
variables.data オブジェクトの両方を更新します。
動的な PDF URL を使用する場合
PDF 生成サービスを使用する場合、次のことができます:- まず HTTP Request アクションで PDF を生成します
- 返された PDF URL をパラメーターとしてロジック関数に渡します
ステップ 4: テストして有効化
- ワークフローを保存します
- Company のレコードに移動します
- ⋮ メニューをクリックし、ワークフローを選択します
- レコードの Attachments セクションを確認し、PDF が添付されたことを確認します
- ワークフローを有効化します
PDF 生成サービスとの連携
動的な見積書や請求書を作成する場合:例: 見積書を生成 → PDF を添付
| 手順 | アクション | 目的 |
|---|---|---|
| 1 | 手動トリガー(Company) | ユーザーがレコード上で実行を開始 |
| 2 | レコード検索 | Opportunity または明細行の詳細を取得 |
| 3 | HTTPリクエスト | レコードデータを用いて PDF 生成 API を呼び出す |
| 4 | サーバーレス関数 | 生成された PDF をダウンロードして添付 |
一般的な PDF 生成サービス
- Carbone - テンプレートベースのドキュメント生成
- PDFMonkey - テンプレートからの動的な PDF 作成
- DocuSeal - ドキュメント自動化プラットフォーム
- Documint - API ファーストのドキュメント生成
トラブルシューティング
| 問題 | 解決策 |
|---|---|
| ”PDF のダウンロードに失敗しました” | PDF URL にアクセスでき、有効な PDF が返されることを確認します |
| ”アップロードに失敗しました” | API キーが有効で、書き込み権限があることを確認します |
| ”添付ファイルの作成に失敗しました” | オブジェクト ID のフィールド名が対象オブジェクトに一致していることを確認します |