SmartHR と dejiren AI の接続設定方法
本記事では、SmartHR と dejiren AI の連携方法について説明します。
前提条件・必要な権限
| サービス名 | 必要な権限 | 権限が必要な場面 |
|---|---|---|
| SmartHR | オーナー、もしくは管理者権限のアカウント | アクセストークンの発行、 Webhook の登録 |
| dejiren AI | エージェント編集者、もしくはエージェント管理者権限 | 接続設定の新規作成、 Webhook の発行 |
| システム管理者権限 | 外部ユーザー割り当て | |
| dejiren AI 一般ユーザー | 個人認証 |
※あらかじめ、SmartHR API を使用するためのアクセストークンを発行できる状態が必要です。
※SmartHR との接続は、すべて個人認証設定でつなぎます。接続設定を利用する各ユーザーは、初回利用時に個人認証を実施してください。
設定作業の流れ

設定手順
手順1. SmartHR でアクセストークンを発行する
公式手順に従って、アクセストークンを発行します。
SmartHRのテナントの /admin/access_tokens にアクセスします。
(URLは環境によって異なります)
1. [新規発行]を押下します。
2. [アクセストークン名]に任意の文字列を入力します。
3. [リソースのアクセス許可]で、[給与明細]と[従業員情報]の[参照]をチェックします。
最低限必要な権限は外さないようにします。
4. [従業員項目のアクセス許可]で、以下の項目の[参照]のチェックは外さないようにします。
姓 / 名 / 姓(カタカナ) / 名(カタカナ) / 生年月日 / 戸籍上の性別 / メールアドレス
5. [従業員項目のアクセス許可]で、以下の項目の[参照]のチェックは外さないようにします。
入社年月日 / 退職年月日 / 社員番号 / 役職 / 業務内容 / 部署 / 住所 / 電話番号
6. [登録]ボタンを押下します。
7. 発行されたアクセストークンを[コピー]ボタンでコピーして控えます。
※アクセストークンの文字列は、再度表示できません。必ずこの場で保管してください。忘れた場合は、新規発行し直す必要があります。
手順2. dejiren AI で接続設定を作成
新しい接続設定を作成します。
1. dejiren AI のエージェント管理画面の[接続設定]で、[新規作成]をクリックします。
2. [新しい接続設定をつくる]で[SmartHR]をクリックで選択して[つぎへ]を押下します。
3. [接続名]を入力します。
4. SmartHRのテナントのURLを入力します。
5. 手順1-7でコピーしたアクセストークンを転記します。
6. [Webhookシークレットトークン]は、この時点では任意の値を入力します。
(手順5で、SmartHRに登録したシークレットトークンに入れ替えます)
7. [作成する]を押下します。
| 設定項目 | 設定値 |
|---|---|
| 接続名 | この接続設定を識別するための任意の名称を入力します。 |
| テナントURL | SmartHRのテナントのURLを入力します。 |
| アクセストークン | 手順1-7で控えたアクセストークンを貼り付けます。 |
| Webhookシークレットトークン | この時点では任意の値を入力します。手順5で、SmartHRに登録したシークレットトークンに入れ替えます。 |
| 個人認証 | [ユーザーごとに認証が必要]が固定で選択されます。 ※SmartHRは、すべて個人認証設定でつなぎます。 |
手順3. 接続設定から Webhook を発行する
作成した接続設定から Webhook を発行します。
1. [接続設定]画面で、登録した SmartHR の接続設定を押下します。
2. [webhookを発行する]ボタンを押下します。
3. 発行された Webhook URL の[コピーアイコン]を押下します。
手順4. SmartHR に Webhook を登録する
SmartHRのテナントの /admin/webhooks にアクセスし、Webhook を登録します。
(URLは環境によって異なります)
1. [Webhook を登録する]を押下します。
2. [URL]に、手順3でコピーした Webhook URL を貼り付けます。
※https (443ポート) のみ設定できます。
3. [シークレットトークン]の[自動生成]ボタンを押下します。
※このシークレットトークンは、SmartHR からの POST リクエストに X-SmartHR-Token というヘッダーで付与されます。
4. [シークレットトークン]をコピーして控えます。(手順5で使います)
5. [送信のトリガーとなるイベント]で、従業員の中でトリガーにしたいイベントにチェックします。
(従業員の追加 / 従業員の更新 / 従業員の削除 など)
6. [登録する]ボタンを押下します。
手順5. Webhookシークレットトークンの登録
作成した接続設定に、SmartHR で 取得した Webhook シークレットトークンを登録します。
1. [接続設定]画面で、作成した SmartHR の接続設定を開き、[Webhookシークレットトークン]に、手順4でコピーしたシークレットトークンを貼り付けます。
2. [保存する]ボタンを押下します。
手順6. 外部ユーザー割り当て
1. dejiren AI のシステム管理画面に、システム管理者ロールに所属するアカウントでアクセスします。
https://www.dejiren.com/admin
2. [外部ユーザー割り当て]を選択します。
3. [連携先]で[SmartHR]を選択します。
4. 以下のフォーマットのCSVファイルを作成し、[ファイルを選択]をクリックして、作成したファイルを指定します。
| operation | login_id | external_tenant_id | external_user_id |
|---|---|---|---|
| N | dejiren AI のアカウント(ログイン用メールアドレス) | 連携する SmartHR のメールアドレスのドメイン部分 | 連携する SmartHR のメールアドレス |
※operation は、新規なら N、更新なら U、削除なら X を指定します。
5. [インポート]を押下します。
外部ユーザー割り当てが実行されます。実行結果は[インポート実行履歴]画面でご確認ください。
※SmartHR との接続は、すべて個人認証設定でつなぎます。
接続設定を利用する各ユーザーは、初回利用時に各自のアカウントでの個人認証を実施してください。
※接続設定を新たに作成した場合には、その接続設定に対して改めて上記の手順を行う必要があります。
※認証処理が正常に完了できないときは、システム管理者による[外部ユーザー割り当て]が正常になされているかご確認ください。
以上で、SmartHR と dejiren AI の接続設定は完了です。
#SmartHR #SmartHRアプリ連携
