Webhookイベントを受信した時（トリガー）
このピースでできることfreee人事労務 の接続方法ステップ 1：workrun のリダイレクト URL を確認するステップ 2：freee でアプリケーションを登録するステップ 3：workrun に接続を追加する事前に必要な設定テスト方法起動するイベントの範囲ピースの設定項目
このピースでできること
- freee人事労務で従業員の作成・更新・削除が行われたときに、フローを自動で起動します。
- 入社・退職などの人事イベントを検知して、通知や他システムへの反映を自動化できます。
- どのイベントを通知するかは、freee開発者ページのアプリ管理画面で設定します。
freee人事労務 の接続方法
workrun と freee人事労務 を接続するには、freee の OAuth クライアント（クライアントID・クライアントシークレット） が必要です。
ステップ 1：workrun のリダイレクト URL を確認する
- workrun で freee人事労務 のアクション／トリガーをフローに追加します。
- 「接続を選択」の横にある 「＋ 新しい接続」 をクリックします。
- 接続画面に表示される 「リダイレクト URL」 をコピーしておきます。
ステップ 2：freee でアプリケーションを登録する
- freeeアプリストア でアプリケーションを登録します。
- コールバックURL に、ステップ 1 でコピーしたリダイレクト URL をそのまま登録します。
- 権限設定 で、以下の項目にチェックを入れます。
- ［人事労務］従業員: 参照・更新
- 「カスタムAPI呼び出し」アクションを利用する場合は、そのエンドポイントに対応する権限も追加してください
- 発行された クライアントID と クライアントシークレット をコピーしておきます。
スコープ一覧
| スコープ名 | 説明 |
|---|---|
| read | freee人事労務のデータの参照を許可します。 |
| write | freee人事労務のデータの作成・更新を許可します。 |
ステップ 3：workrun に接続を追加する
- ステップ 1 の接続画面に戻り、クライアントID と クライアントシークレット をそれぞれ貼り付けます。
- 「接続」 をクリックすると、freee の認証画面が開きます。
- freee にログインし、連携する事業所を選択します。
- workrun に対するアクセスを 「許可」 します。
- 画面が自動で閉じ、接続が完了します。
事前に必要な設定
freee人事労務にはWebhookを自動で登録する仕組みがないため、freee開発者ページで手動の登録が必要です。
- freee開発者ページ にアクセスします。
- 対象のアプリケーションを選択し、「Webhook設定」タブを開きます。
- トリガーの設定画面に表示されている Webhook URL を「URL」欄に貼り付けます。
- 通知したいイベントを選択して保存します。
フローを停止・削除する場合も自動では解除されないため、freee開発者ページでWebhook設定を手動で削除してください。
テスト方法
フローを実際に起動せずにサンプルデータを生成したい場合は、Webhook URL の末尾に を追加してください。
起動するイベントの範囲
このトリガーは人事労務のイベントのみを受け付けます。同じfreeeアプリに他プロダクト（会計など）のWebhookを設定していても、それらのイベントではフローは起動しません。
ピースの設定項目
このピースには入力する設定項目はありません。設定画面に表示される Webhook URL をコピーして、上記の「事前に必要な設定」に従って freee 開発者ページで登録してください。
また、このトリガーは接続（認証情報）の選択も不要です。