Integrations組織共有

SmartHR 連携

SmartHR と Pigeon Workflow を連携すると、従業員・部署・扶養家族のデータを取り込んだり、従業員の登録・更新を自動化できます。従業員情報の変更をきっかけにワークフローを起動することもできます。

この連携は組織単位で登録します。一度登録すれば、同じ組織のメンバーがワークフローから利用できます。権限管理が有効な組織では、シークレットに「利用」権限を持つメンバーが利用できます。詳しくは権限管理の完全ガイドを参照してください。

連携でできること

SmartHR の管理画面でアクセストークンを 1 つ発行します。あわせて次の情報を入力します。

入力する項目	例	説明
表示名	本番環境	連携を見分けるための名前です。
サブドメイン	`your-company`	SmartHR の URL に含まれる部分です。
アクセストークン	—	下記の手順で発行します。
Webhook シークレット	—	任意。自動起動を使う場合に設定すると、より安全に受信できます。

SmartHR の管理画面で「共通設定」→「アプリケーション連携」→「アクセストークン」→「新規作成」を開きます。スコープでは、データを取り込むなら従業員の読み取り、従業員を登録・更新するなら従業員の書き込みを選びます。

「設定」→「サービス連携」→「SmartHR」を開き、「連携を追加」をクリックします。表示名・サブドメイン・アクセストークンを入力し、「接続テスト」で確認してから「追加」をクリックします。

追加直後に Webhook URL が表示されます。この URL は一度しか表示されません。自動起動を使う場合はコピーしておいてください。紛失した場合は連携一覧の再生成ボタンで作り直せます。

サンドボックスに接続する場合は、サブドメインをドメインまで含めて入力してください。

SmartHR の管理画面で「共通設定」→「外部システム連携」→「Webhook」→「追加」を開き、控えておいた URL を貼り付けます。通知するイベントを選んで「保存」をクリックします。

ワークフローに SmartHR トリガーノードを置き、連携と受け取りたいイベントを選びます。対応しているのは従業員の追加・更新・削除です。

ノード	できること	主な設定
SmartHR 取得	従業員一覧 / 従業員詳細 / 部署一覧 / 扶養家族一覧を取得します	SmartHR 連携 / 操作 / 従業員ID / 在職状況フィルタ / 部署フィルタ / 社員番号フィルタ / 最大取得件数
SmartHR 保存	従業員を作成・更新します	SmartHR 連携 / 操作 / Webhook通知をスキップ / フィールドマッピング
SmartHR トリガー	従業員の追加・更新・削除でワークフローを起動します	SmartHR 連携 / トリガーイベント

自動起動のワークフローの中で従業員を更新すると、その更新がまた自動起動の対象になることがあります。保存ノードの「Webhook通知をスキップ」を有効にすると、この繰り返しを防げます。