本レシピはSmartHRメールアラートプラン以上の有償プランでご利用いただけます。ご利用をご希望の場合は下記よりお問い合わせください。

お問い合わせ | ActRecipe

従業員に対してSmartHR上の各種期限情報の確認および通知のメールを送信する方法を解説します。
レシピを使用するには事前にSmartHRの利用契約が必要になります。

管理者（人事担当者等）向けのメールアラートレシピは下記をご利用ください。

SmartHR - メールアラート

SmartHR - メールアラート (カスタム版-従業員情報)

メールアラートレシピをご活用いただいるお客様のお声はこちら

ITreviewのレビューコメントを表示

【ご説明動画】

レシピのご利用の流れをまとめておりますのでご覧ください。

0.事前準備

「SmartHR - 従業員メールアラート」レシピを使用するには、事前にSmartHR Plusでのアプリの登録が必要となります。
以下のSmartHR Plusにアクセスし、画面右上の「ログイン」ボタンよりSmartHRへログインします
https://www.smarthr.plus/apps/actrecipe
続いて「連携をはじめる」ボタン(青色)をクリックします
アプリのインストール確認画面にて「連携をはじめる」ボタンをクリックします
アプリの連携が完了しますと上記「2」のボタンが「アプリを開く」に変わりますので、同ボタンをクリックします
以下の確認画面が表示されますので「連携を許可」をクリックします(※)

連携するユーザはSmartHRの「管理者」権限を保持している必要があります。

※
ActRecipeのアカウントを保持しておりActRecipeにログインしていない場合にはログインをしてください。
ActRecipeのアカウントが未作成の場合は「無料ではじめる」ボタンよりアカウントを作成し、通知メールに従ってください。

1.マイレシピへの登録

メニューの「シェアレシピ」から、「SmartHR - 従業員メールアラート」にチェックを入れ、画面下にある登録ボタンを押下します。シェアレシピの画面に「SmartHR - 従業員メールアラート」が表示されない場合はSmartHR Plusの画面からやり直してください。

続いて「マイレシピ」から、レシピ名をクリックするか操作メニューより「編集」を選択します。
参考：シェアレシピ・マイレシピとはなんですか？

ヘッダーでは、レシピ名とレシピ説明を変更することができます。
参考：レシピヘッダーでは何を設定すれば良いですか？

2.SmartHRの認証情報設定

「SmartHR 社員情報取得 (OAuth)」を押下し、設定を展開します。

本タスクでは、以下の設定を行います。

サブドメイン (自動入力)：SmartHRとの連携ができていれば自動的にサブドメイン名がセットされます。
取得データの種類
- 物理名：システム上設定されているラベル名や項目名が取得されます。例えば、性別項目は「gender」というラベル名となり、値は「male」「female」となります。
- 論理名：画面に表示されるラベル名や項目名が取得されます。例えば、性別項目は「戸籍上の性別」というラベル名となり、値は「男性」「女性」となります。
フリーワード検索 (オプション)：SmartHRからの一度に取得するデータ件数(従業員数)が10,000件を超える場合等にはレシピ実行がタイムアウトエラー(サーバー応答コード: 202、または、504)となる可能性があります。そのような場合に、取得データを絞り込んでデータを取得できるオプションです。この機能は、SmartHR従業員リストの検索ボックスと同様の検索・絞り込みが可能です。例えば、社員番号の「0001」を指定しますと「00001」および「00010〜00019」が取得対象となります。他にも氏名、ビジネスネーム、部署名、役職名、事業所でも絞り込むことができます。本項目に値がある場合には下記の「詳細検索」の設定が無効となりますのでご留意ください。
詳細検索 (オプション)：フリーワード検索よりも細かな条件で対象データを絞り込むことができます。条件指定は最大10件まで行うことができます。
[社員番号, ユーザーID, 従業員のID, 戸籍上の性別, 雇用形態, 在籍状況, 入社年月日-開始日, 入社年月日-終了日, 部署ID, フリーワード検索]
詳細検索はOR条件ではなくAND条件です。例）【「在籍状況」が次に等しい「在職中」】、【「在籍状況」が次に等しい「休職中」】と設定した場合、「在職中」かつ「休職中」の従業員を検索することになるため、取得データは0件となります。

SmartHRとのOAuth接続を切断する場合は「テナントの変更・解除」をクリックし、続いて「接続解除」をクリックします。

3.カスタムトリガーの設定

「SmartHR カスタムトリガー設定」を押下し、設定を展開します。
本タスクでは、以下の設定を行います。

初回通知を有効にする（オプション）：標準では1回目のレシピ実行では通知が行われず、2回目以降のレシピ実行でSmartHR上のデータに差分があった場合に下記の「対象項目」以下の条件チェックが行われます。このオプションを有効にすることで、初回のレシピ実行から条件のチェックが行われメールが通知されるようになります。条件に該当した場合に確実にメール通知されたい場合は本オプションを有効化してください。なお、本オプションを有効にしますと初回のレシピ実行で多数のレコードを含むメールが送信される可能性ありますのでご留意ください。
メールを再送する（オプション）：標準では1度送信されたメールの再送は行われません。このオプションを有効にすることで、送信済みの内容も再度通知されることとなります。本オプションは検証用ですので、メール本文等の内容が確定した後には無効化していただいた上でレシピを自動化してご利用ください。なお、本オプションと上記の「初回通知を有効にする（オプション）」を同時に有効にしていただくことでレシピ実行時に確実にメールが送信されますので、検証時には両オプションを有効化していただくことを推奨いたします。
従業員情報の更新分も通知する（オプション）：標準では一度通知されるとSmartHRの値が更新されても通知されません。このオプションを有効にすることで、SmartHRの値が更新された後、次のレシピ実行時に通知対象となる条件を満たしている場合は通知されます。また、レシピ内の条件式が「期日後X日以降」であるとき、実行済みのレシピに対してこのオプションを有効化しますとSmartHRの値を変更していない場合も通知が行われますのでご留意ください。
対象項目：チェック対象の項目を入力します。指定可能な項目は日付項目のみとなります。本対象項目は1件のみ指定が可能ですので、異なる対象項目をチェックされたい場合は新たにレシピを作成してください。複数の対象項目の同時チェックには対応しておりません。
フォーマットと設定例は以下の通りです。
- 通常のフォーマット：#([項目名])
  設定例：「入社年月日」を対象とする場合には「#(入社年月日)」とします。
- カスタム従業員項目のフォーマット：#([カスタム項目グループ名.カスタム項目名])
  設定例：カスタム項目グループ名が「運転免許」、カスタム項目名が「自賠責保険有効期限」の場合は「#(運転免許.自賠責保険有効期限)」のようになります。
条件式：上記の対象項目に対して、どのような条件でチェックするかを指定します。項目の内容は以下の通りです。
- 次に等しい：「値」と同じ日付の場合。
  例えば、対象項目の日付が「2024/7/31」のものを通知します。
- 現在月に等しい：レシピを実行した月と同じ場合。
  例えば、レシピ実行日が「2024/7/31」の場合、対象項目の年月日のうち月が7月のものを通知します。
- 現在日に等しい：レシピを実行した日付と同じ場合。
  例えば、レシピ実行日が「2024/8/1」の場合、対象項目の年月日がレシピ実行日と同じ「2024/8/1」のものを通知します。
- 期日前X日以内：「対象項目」の日付から「値」の日数以内前になったら通知をします。
  例えば、対象項目の日付が「2024/7/31」、値が「5」の場合、2024/7/26〜2024/7/30の間にレシピを実行したら通知します。2024/7/25以前や2024/7/31以降にレシピを実行しても通知は行われません。
- 期日後X日以降：「対象項目」の日付から「値」の日数以降に通知をします。
  例えば、対象項目の日付が「2024/8/1」、値が「5」の場合、2024/8/6以降にレシピを実行したら通知します。2024/8/2〜2024/8/5や2024/7/31日以前にレシピを実行しても通知は行われません。
値：条件となる値を数字で指定します。
メール件名：送信するメールの件名を設定します。件名にはSmartHRの項目名(※)を変数をして使用することができます。
メール本文：アラートメールの本文を設定します。本文にもSmartHRの項目名(※)を変数をして使用することができます。

スクリーンショット 2025-03-18 144756.png

※ 例えば「入社年月日」を変数として使用する場合は「#(入社年月日)」と指定します。

SmartHRの項目名は下記ページの「SmartHR項目説明」をご利用ください。

SmartHR連携項目v1.5

4.宛先の設定

「SmartHR 宛先設定」を押下し、設定を展開します。
このタスクでは、以下の設定を行います。

テストメール宛先（オプション）：管理者宛にテストメールを送信する場合はこのフィールドに任意のメールアドレスを入力します。このフィールドに値がある場合は後続の「宛先条件」の内容は無視されます。
宛先条件：メールを送信する宛先を条件によって指定します。プルダウンの項目の内容は下記の通りです。
- 本人（システム標準）：「カスタムトリガーの設定」で指定した条件に該当する従業員本人(*1)にメールを送信します。例えば「在留期日」が近い従業員に直接通知をしたい場合に使用します。
  *1 管理者が指定可能な従業員リスト内のメールアドレスが使用されます。
- 本人（ログイン用）：「本人（システム標準）」と同様に従業員本人(*2)にメールを送信します。
  *2 「個人設定」から従業員自身が設定可能なメールアドレスが使用されます。　　　　　　　　　　　　　　　※　「本人（システム標準）」と「本人（ログイン用）」の併用はできないためご注意ください。
- 同一部署：「カスタムトリガーの設定」で指定した条件に該当する従業員と同一の部署の従業員全員にメールを送信します。例えば、「契約終了日が近い従業員と同一部署の上長(課長)にメールを送信したい場合」には以下のような組み合わせで設定します。

スクリーンショット 2024-12-11 17.19.23.png

- 同一事業所：「カスタムトリガーの設定」で指定した条件に該当する従業員と同一の事業所の従業員全員にメールを送信します。
- 任意：任意の従業員項目に該当する従業員にメールを送信することができます。入力方法は「部署1 役職」のようなSmartHRの論理名をコピー&ペーストしてください。カスタムトリガーの設定のように「#(部署1 役職)」のような変数指定ではなく「部署1 役職」となりますのでご注意ください。
メール宛先（Cc）（オプション）：従業員本人へのメールのCcに人事担当者等を加えたい場合に指定をします。複数ある場合はカンマ区切りで入力します。　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　　※　ToとCcのメールアドレスが同一の場合にはCcを削除して、通知します。

レシピを実行する (自動実行はこちら)

レシピの編集画面の上部の「レシピ実行」、または、マイレシピの操作メニューより「実行」を選択することでレシピを実行できます。
画面イメージや履歴の確認方法は以下をご参照ください。

参考：レシピを実行するにはどうすれば良いですか？

レシピが実行されるとActRecipe内にSmartHRから取得したデータを保存し、そのデータや差分をチェックしてメール送信が行われます。メールの自動送信をされたい場合は下記ページをご確認ください。

レシピを自動化する

【留意事項】

メール送信は途中でキャンセルすることができませんので必ず「テストメール宛先」を使用してテストメールの送信および内容確認を行ってください。
1つのレシピで指定できるアラートは1件のみとなります。複数の種類や同一種類のメールを複数利用されたい場合はシェアレシピから本レシピをマイレシピに複数登録してご利用ください。
「初回通知を有効にする（オプション）」にチェックがない場合、初回レシピ実行時はSmartHRからのデータ取得だけが行われるためメール送信は行われません。
2回目以降のレシピ実行によって、SmartHR上のデータの差分をチェックし条件に一致した場合に一度だけメール送信が行われます。データの更新がない場合にメール通知がされませんので、「入社年月日」や「生年月日」のように既に値が入っている項目を対象とする通知を行いたい場合は「初回通知を有効にする（オプション）」を有効にしてください。
従業員本人へのメール本文は一行表示となりますが、「テストメール宛先」に指定した宛先へのメールには対象従業員の数だけ本文が改行して表示されます。
送信元メールアドレスは「noreply@actrecipe.com」となります。
本文中に社員番号の変数「#(社員番号)」を指定しますと、メールでは社員番号が従業員のページへのリンクとなります。社員番号の値がブランクの場合には代わりに「_BLANK_」が挿入され、こちらもリンクとなります。

【注意事項】SmartHR - メールアラート (カスタム版-従業員情報) で取得可能な従業員情報の取扱いについて

取得できる従業員の範囲・項目は、本レシピの連携設定時に利用したSmartHRのアカウントの権限設定を反映します。目的と用途に応じた権限のSmartHRのアカウントを使って設定を行なってください。詳しくは、*従業員関連の閲覧・作成・更新・削除の権限を設定する* を参照してくださ
い。
https://support.smarthr.jp/ja/help/articles/1500001368101/

FAQ

Q.「SmartHR Plus上でActRecipeのアプリをインストールしてレシピを再実行してください。」と表示されますがどのようにすれば良いですか？
A.何らかの原因でSmartHR Plusの接続が切断されてしまった場合に表示されるメッセージです。以下の手順でSmartHR Plusとの再接続をお願いします。
・SmartHR Plusへアクセスし、アプリをアンインストールします。操作方法はこちら。
・続いてアプリの「追加」および「許可」をクリックしてください。操作方法はこちら。

有償プランについて
レシピの自動実行は有償プランでご利用いただけます。料金プランは下記をご覧ください。