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

お問い合わせ | ActRecipe

SmartHR上の従業員情報（カスタム従業員項目含む）の更新時に各種アラートメールを行う方法を解説します。
レシピを使用するには事前にSmartHRの利用契約が必要になります。

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

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

メールアラートカスタム版.png

【ご説明動画】

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

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」が取得対象となります。他にも氏名、ビジネスネーム、部署名、役職名、事業所でも絞り込むことができます。本項目に値がある場合には下記の「詳細検索」の設定が無効となりますのでご留意ください。
マイナンバーを含める：
マイナンバー情報を含める場合にはチェックを付けます。本機能はSmartHR上のマイナンバー情報を取得可能な権限が付与されたアカウントでのみご利用いただけます。また、本機能を初めて利用される際や権限の更新時には、SmartHRとのテナント再認証（再接続）が必要となります。レシピ設定画面にて登録済みのSmartHRテナント情報を一度削除またはログアウトし、再度ログインして認証を完了させてからレシピを実行してください。
詳細検索 (オプション)：フリーワード検索よりも細かな条件で対象データを絞り込むことができます。条件指定は最大10件まで行うことができます。
[社員番号, ユーザーID, 従業員のID, 戸籍上の性別, 雇用形態, 在籍状況, 入社年月日-開始日, 入社年月日-終了日, 部署ID, フリーワード検索]
詳細検索はOR条件ではなくAND条件です。例）【「在籍状況」が次に等しい「在職中」】、【「在籍状況」が次に等しい「休職中」】と設定した場合、「在職中」かつ「休職中」の従業員を検索することになるため、取得データは0件となります。
※部署IDは、部署名にも対応しております。以下の赤枠すべてを指定ください。

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

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

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

初回通知を有効にする（オプション）：標準では1回目のレシピ実行では通知が行われず、2回目以降のレシピ実行でSmartHR上のデータに差分があった場合に下記「アラート種別」の条件チェックが行われます。このオプションを有効にすることで、初回のレシピ実行から「アラート種別」の条件チェックが行われメールが通知されるようになります。条件に該当した場合に確実にメール通知されたい場合は本オプションを有効化してください。なお、本オプションを有効にしますと初回のレシピ実行で多数のレコードを含むメールが送信される可能性ありますのでご留意ください。
メールを再送する（オプション）：標準では1度送信されたメールの再送は行われません。このオプションを有効にすることで、送信済みの内容も再度通知されることとなります。本オプションは検証用ですので、メール本文等の内容が確定した後には無効化していただいた上でレシピを自動化してご利用ください。なお、本オプションと上記の「初回通知を有効にする（オプション）」を同時に有効にしていただくことでレシピ実行時に確実にメールが送信されますので、検証時には両オプションを有効化していただくことを推奨いたします。
従業員情報の更新分も通知する（オプション）：標準では一度通知されるとSmartHRの値が更新されても通知されません。このオプションを有効にすることで、SmartHRの値が更新された後、次のレシピ実行時に通知対象となる条件を満たしている場合は通知されます。また、レシピ内の条件式が「期日後X日以降」であるとき、実行済みのレシピに対してこのオプションを有効化しますとSmartHRの値を変更していない場合も通知が行われますのでご留意ください。
対象項目：チェック対象の項目を入力します。指定可能な項目は日付項目のみとなります。本対象項目は1件のみ指定が可能ですので、異なる対象項目をチェックされたい場合は新たにレシピを作成してください。複数の対象項目の同時チェックには対応しておりません。
フォーマットと設定例は以下の通りです。
- 通常のフォーマット：#([項目名])
  設定例：「入社年月日」を対象とする場合には「#(入社年月日)」とします。
- カスタム従業員項目のフォーマット：#([カスタム項目グループ名.カスタム項目名])
  設定例：カスタム項目グループ名が「運転免許」、カスタム項目名が「自賠責保険有効期限」の場合は「#(運転免許.自賠責保険有効期限)」のようになります。
  
  ※ 対象項目とできるのは従業員情報のみとなります。もし、家族情報の項目を条件にして、通知したい場合は、以下のレシピを使用して、家族情報更新時に該当従業員のカスタム従業員項目も更新されるように設定いただき、本レシピの対象項目にそのカスタム従業員項目を入力ください。
  SmartHRデータアップデート
条件式：上記の対象項目に対して、どのような条件でチェックするかを指定します。項目の内容は以下の通りです。
- 次に等しい：「値」と同じ日付の場合。
  例えば、対象項目の日付が「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上で通勤経路を変更した際に、その更新を自動で検知し、通知します。
  空欄への値追加(”空欄”→”値”)や値の削除(”値→”空欄”)も通知対象となります
  新規従業員追加は通知対象になりません。
  【補足：更新前の値（old機能）の出力について】
  メール本文に #(old:項目名) と記載することで、変更後の値だけでなく「変更前の値」もメール本文に含めることができます。
  - 設定例：
    - 変更前の通勤経路：#(old:通勤経路)
    - 変更後の通勤経路：#(通勤経路)
      
      ※実行前後で値に変更があった「その回限り」で変化前の値を取得できます。
      対象項目に更新がない場合や、更新前の値が存在しない場合は _BLANK_ が出力されます。
      ”値が更新”においては、初回実行時にSmartHRから取得した情報を保存し、次回実行時のデータと比較することで更新を検知します。そのため、通知が行われるのは2回目以降の実行時となります。
値：条件となる値を数字で指定します。
メール件名：送信するメールの件名を設定します。件名にはSmartHRの項目名(※)を変数をして使用することができます。
メール本文：アラートメールの本文を設定します。件名にはSmartHRの項目名(※)を変数をして使用することができます。

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

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

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

SmartHR連携項目v2.1

4.宛先の設定

「メール送信」を押下し、設定を展開します。
このタスクでは、以下の設定を行います。

メール宛先（To）：宛先(To)を指定します。複数ある場合はカンマ区切りで入力します。
メール宛先（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へアクセスし、アプリをアンインストールします。操作方法はこちら。
・続いてアプリの「追加」および「許可」をクリックしてください。操作方法はこちら。

Freeプランについて
このレシピはActRecipeのFreeプランでご利用いただけます。Freeプランの制約事項や有償プランへの移行は下記をご覧ください。