SmartHRとの連携を追加する

SmartHR連携の手順

SmartHRとの連携方法には「OAuthで連携」と「アクセストークンで連携」の2パターンが存在します。
SmartHRの従業員情報の作成・変更を行う場合は「アクセストークンで連携」が必要です。

1. ［アプリカタログ］から「SmartHR」を探し、［連携を追加］をクリックします。
   
2. ［アクセストークンで連携］をクリックすると以下モーダルが表示されるので、「ドメイン」「アクセストークン」を入力し［連携を追加］をクリックします。
   

ドメインの確認方法

SmartHRにアクセスするURLを確認してください。例えばアクセスしているURLが「https://xxxxxx.smarthr.jp/」である場合、「ドメイン」は「xxxxxx.smarthr.jp」です。

アクセストークンの確認方法

詳しくはSmartHR公式サイトの「アクセストークンの発行方法」のヘルプページをご参照ください。

1. SmartHRにアクセスし、管理者アカウントでログインします。
2. ［共通設定］をクリックします。
   
3. ［外部システム連携］→［アクセストークン］→［新規発行］をクリックします。
   
4. 「アクセストークン名」には「freee IT管理連携用」などのわかりやすい名前を入力し、画面下にスクロールします。
   

5. ［リソースの制限］および［従業員項目のアクセス許可］からfreee IT管理がアクセス可能なアカウント情報を選択できます。
   最低限のアカウント同期には以下の参照権限が必須となるので、必ずチェックを入れます。

   • ユーザーID
   • 姓
   • 名
   • メールアドレス
   • 在籍状況
   • 従業員招待フォーム
   • 部署
   • 役職

   例えば、「生年月日」と「戸籍上の性別」の［参照］のチェックを外すと、freee IT管理上でSmartHRアカウントの生年月日と性別が確認できなくなります。
   
   この設定はアクセストークン発行後もSmartHRのアクセストークン管理画面から編集が可能です。すべてにチェックを入れた状態でアクセストークンを発行いただき、不要なものを後から外すことができます。

6. 設定が完了したら、画面下部の［登録］をクリックします。
   
7. アクセストークンが表示されます。
   

Webhookの再設定方法

Webhookは、初回のアクセストークンの連携時には何も設定いただかずに自動的に連携が行われる仕様になっておりますが、何らかの理由でアクセストークンを再度発行した場合は、Webhookも設定し直す必要があります。

詳しくはSmartHR公式サイトの「Webhook連携を設定する」のヘルプページをご参照ください。

1. 誤操作防止のためにSmartHR上にある、既存のfreee IT管理用WebhookのURLを削除します。［共通設定］→ ［外部システム連携］→［Webhook］→ ［操作］→ ［削除］をクリックします。
   
2. 下記モービルが表示されるので、［削除］をクリックします。
   
3. 再度freee IT管理上でWebhookを設定します。freee IT管理にログインし［マイアプリ］→［SmartHR］→［設定］→［Webhook］→［・・・（三点リーダー）］をクリックします。
   
4. 下記モービルが表示されるので、トークンの中身を消去し、空の状態で［送信］をクリックします。
   
5. トークンを削除したWebhookの［URL］をコピーします。
   
6. SmartHR上のWehbook画面で「Webhookを登録する」を押し、コピーしておいた「URL」を貼り付け、［シークレットトークンをランダム作成］をクリックします。
   
7. 下にスクロールし、［送信のトリガーとなるイベント］にチェックを入れて［追加］をクリックします。
   
8. 先ほど発行した［シークレットトークン］をfreee IT管理にログインし［Webhook］の［トークン］に貼り付ける。