SmartHR 連携 -SmartHR の従業員データを kintone アプリに連携する-

目次

はじめに

普段の業務の中で、人事や労務など用途に合わせていろいろな Web サービスを使っている方は多いと思います。
そんなとき、各システムに登録するためのユーザーマスターとして kintone を使っているという方もいらっしゃると思います。

各 Web サービスと kintone が連携できたら便利ですね。
この記事では、クラウド人事労務ソフト「 SmartHR (External link) 」と kintone を連携し、SmartHR で従業員データが作成されると、kintone の従業員名簿アプリにレコードが自動で追加される方法を説明します。

連携イメージ

SmartHR の Webhook を使い、従業員データが作成されると Zapier にデータを送信します。
Zapier で SmartHR からの Webhook を受け取り、kintone アプリにレコードを登録します。

下準備

  • SmartHR (External link) アカウント
  • kintone アプリ(人事労務パックの従業員名簿アプリ)
  • Zapier (External link) アカウント(Starter プラン以上)

設定手順

  1. まず最初に Zapier で SmartHR の Webhook をキャッチするための設定をします。
    サインアップ後の画面で、「Create Zap」をクリックします。

  2. Dashboard の画面が表示されます。
    「Name your Zap」にタイトルを入力し、「Webhooks by Zapier」をクリックします。
    「Webhooks by Zapier」は PremiumApp のため、有償の Starter プラン以上の契約が必要になります。
    参照: Plans & Pricing (External link)

    「Choose App」で「Webhooks by Zapier」(初期値で選択されています)を、「Choose Trigger Event」で「Catch Hook」を選択し「CONTINUE」をクリックします。

  3. Webhook 用のエンドポイントを取得します。
    「Custom Webhook URL」に URL が入力されていることを確認します。

  4. 次に SmartHR の設定をします。
    サインアップ後の画面で、右上のアカウント名から「共通設定」をクリックします。

    「共通設定」の「アプリケーション連携」をクリックします。

    「Webhook」をクリックします。

  5. SmartHR の Webhook の登録をします。
    「Webhook を登録する」をクリックします。

    「URL」に Zapier で発行された Webhook 用のエンドポイント(手順 3 の「Custom Webhook URL」に入力されている URL)を入力します。
    送信のトリガーとなるイベントは「従業員の追加」を選択し、「登録する」をクリックします。

  6. テストデータを作成します。
    右上の「従業員管理」から従業員のデータを登録してください。

  7. Zapier で Webhook が送信されていることを確認します。
    「CONTINUE」をクリックします。

    「Find Data」の「TEST & REVIEW」をクリックします。

    先ほど手順 7 で作成したテストデータの Webhook が送信されていることが確認できました。

  8. Zapier から kintone へレコードを追加する設定をします。
    「2.Do this ...」をクリックし、「kintone」を選択します。

    「Choose App」で「kintone」(初期値で選択されています)を、「Choose Action Event」で「Create Record」を選択し「CONTINUE」をクリックします。

  9. kintone のアプリを準備します。
    アプリストアから人事労務パックを追加してください。今回は「従業員名簿」アプリを使用します。

    「アプリの設定」から API トークンを発行します。
    アクセス権は「レコード閲覧」「レコード追加」にチェックを入れ保存し、アプリを更新します。

  10. Zapier の kintone への接続設定を行います。
    「Sign in to kintone」をクリックします。

    以下の項目を入力し、「Yes, Continue」をクリックします。

    • Sub Domain:サブドメイン
    • Application ID:「従業員名簿」アプリのアプリ ID
    • API Token:手順 9 で発行した「従業員名簿」アプリの API トークン
    • Domain:cybozu.com

    「CONTINUE」をクリックします。

  11. kintone への接続設定が完了したら、SmartHR の従業員データの項目と kintone の従業員名簿アプリのフィールドの紐づけを行います。
    各項目の紐づけが終わったら、ページ最下部の「CONTINUE」をクリックします。

  12. 「TEST & REVIEW」をクリックし動作確認を行います。

    「Test was successful!」と表示されれば成功です。kintone のアプリを確認しましょう!

    kintone に従業員データのレコードが登録されていることを確認できました。

おわりに

SmartHR の Webhook と Zapier を使って、ノンコーディングでマウスの操作だけで簡単に SmartHR と kintone を連携できました。
SmartHR の Webhook の送信のトリガーとなるイベントは、この記事で紹介した「従業員の追加」の他にも「従業員の更新」「従業員の削除」「従業員のインポート」があります。
この記事の連携方法を応用すれば、いろいろな活用ができそうですね。

ぜひ、従業員管理などの人事労務システムに SmartHR と kintone をご活用ください。

information

この Tips は、2019 年 12 月版 kintone で動作を確認しています。