文書の状態が変更された時（トリガー）
このピースでできることfreeeサイン の接続方法ステップ 1：workrun のリダイレクト URL を確認するステップ 2：freeeサイン で OAuth クライアントを作成するステップ 3：workrun に接続を追加する事前に必要な設定ピースの設定項目1. 不正リクエスト対策パスワード（必須）
このピースでできること
- freeeサインで文書の状態（下書き・送信済み・締結完了など）が変わったときに、フローを自動で起動します。
- 契約の締結を検知して、通知や台帳への記録などを自動化できます。
freeeサイン の接続方法
workrun と freeeサイン を接続するには、freeeサイン の OAuth クライアント（クライアントID・クライアントシークレット） が必要です。
ステップ 1：workrun のリダイレクト URL を確認する
- workrun で freeeサイン のアクション／トリガーをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。
ステップ 2：freeeサイン で OAuth クライアントを作成する
- freeeサインの管理画面にログインします。
- 画面右上の設定（歯車アイコン）を開きます。
- 「インテグレーション」セクションの「OAuth2.0 API クライアント」を開きます。
- クライアントを追加し、クライアント名とリダイレクトURIを入力します。
- リダイレクトURIには、ステップ 1 でコピーしたリダイレクト URL をそのまま貼り付けてください。
- 発行された client_id（クライアントID） と client_secret（クライアントシークレット） をコピーしておきます。
スコープ一覧
| スコープ名 | 説明 |
|---|---|
| all | freeeサインAPIの全エンドポイントへのアクセスを許可します。 |
ステップ 3：workrun に接続を追加する
- ステップ 1 の接続画面に戻り、クライアントID と クライアントシークレット をそれぞれ貼り付けます。
- 「接続」 をクリックすると、freeeサイン の認証画面が開きます。
- freeeサイン にログインし、workrun に対するアクセスを 「許可」 します。
- 画面が自動で閉じ、接続が完了します。
事前に必要な設定
freeeサインにはWebhookを自動で登録する仕組みがないため、freeeサインの管理画面で手動の登録が必要です。
- freeeサイン管理画面にログインします。
- 画面右上の設定（歯車アイコン）を開きます。
- 「インテグレーション」セクションの「Webhook」を開きます。
- トリガーの設定画面に表示されているWebhook URL を「URL」欄に貼り付けます。
- 「トリガーイベント」欄で「文書の状態変更」にチェックを入れます。
- 「不正リクエスト対策パスワード」欄に任意の文字列を入力して保存します。
- トリガーの「不正リクエスト対策パスワード」項目に、手順 6 で入力したものと同じ値を入力します。
フローを停止・削除する場合も自動では解除されないため、freeeサインの管理画面でWebhook設定を手動で削除してください。
ピースの設定項目
1. 不正リクエスト対策パスワード（必須）
- freeeサイン管理画面のWebhook設定で入力した「不正リクエスト対策パスワード」と、まったく同じ値を入力します。
- この値が一致しない場合、freeeサインからの通知を受け取ってもフローは起動しません。フローが起動しないときは、まずこの値が一致しているか確認してください。
[設定例]