Skip to main content
Twenty で PDF を自動生成または取得し、レコードに添付します。 これは、会社、商談、またはその他のオブジェクトに関連付けられた見積書、請求書、レポートを作成する用途で一般的に使用されます。

概要

このワークフローでは 手動トリガー を使用し、選択した任意のレコードに対してオンデマンドで PDF を生成できるようにします。 A Logic Function handles:
  1. URL(PDF 生成サービスから)から PDF をダウンロードする
  2. ファイルを Twenty にアップロードする
  3. レコードに関連付けられた添付ファイルを作成する

前提条件

ワークフローを設定する前に:
  1. API キーを作成: Settings → APIs に移動して新しい API キーを作成します。 You’ll need this token for the logic function.
  2. PDF 生成サービスを設定(任意):PDF を動的に生成したい場合(例: 見積書)は、Carbone、PDFMonkey、DocuSeal のようなサービスを使用して PDF を作成し、ダウンロード URL を取得します。

ステップバイステップの設定

ステップ 1: トリガーを設定

  1. Workflows に移動し、新しいワークフローを作成します
  2. 手動トリガー を選択します
  3. PDF を添付したい対象オブジェクト(例: CompanyOpportunity)を選択します
手動トリガーを使用すると、レコードを選択すると右上に表示されるボタンからこのワークフローを実行し、PDF を生成して添付できます。

Step 2: Add a Logic Function

  1. Add a Code action (logic function)
  2. 以下のコードで新しい関数を作成します
  3. 入力パラメーターを設定します

入力パラメーター

If attaching to a different object (Person, Opportunity, etc.), rename the parameter accordingly (e.g., personId, opportunityId) and update the logic function.

Logic Function Code

ステップ 3: ユースケースに合わせてカスタマイズする

別のオブジェクトに添付する場合

companyId を適切なフィールドに置き換えます: 関数のパラメーターと、添付のミューテーション内の variables.data オブジェクトの両方を更新します。

動的な PDF URL を使用する場合

PDF 生成サービスを使用する場合、次のことができます:
  1. まず HTTP Request アクションで PDF を生成します
  2. Pass the returned PDF URL to the logic function as a parameter

ステップ 4: テストして有効化

  1. ワークフローを保存します
  2. Company のレコードに移動します
  3. メニューをクリックし、ワークフローを選択します
  4. レコードの Attachments セクションを確認し、PDF が添付されたことを確認します
  5. ワークフローを有効化します

PDF 生成サービスとの連携

動的な見積書や請求書を作成する場合:

例: 見積書を生成 → PDF を添付

一般的な PDF 生成サービス

  • Carbone - テンプレートベースのドキュメント生成
  • PDFMonkey - テンプレートからの動的な PDF 作成
  • DocuSeal - ドキュメント自動化プラットフォーム
  • Documint - API ファーストのドキュメント生成
Each service provides an API that returns a PDF URL, which you can then pass to the logic function.

トラブルシューティング

関連