【SmartHR導入事例】SmartHR APIを活用した企業向け健康管理アプリの連携開発

ソリューション

SupremeTechは、クライアントの企業向け健康管理アプリに対し、SmartHRとの連携機能を構築しました。

本プロジェクトでは、大きく2つの取り組みを行いました。1つは、クライアントのアプリをSmartHR Plus上で利用できるようにすること。もう1つは、SmartHRから社内システムへ従業員情報を同期する仕組みを構築することです。

SmartHRとの連携では、単に従業員情報を取得するだけでは十分ではありません。まず、外部アプリケーションをSmartHRの仕組みに正しく接続し、そのうえで、安全かつ安定した方法で従業員情報を同期できる環境を構築する必要があります。

SmartHRとの連携を検討している企業にとっても、これは重要なポイントです。

SmartHR連携の対応範囲

SupremeTechは、SmartHR Plusへの申請支援から認証、データ連携、公開準備まで、SmartHR連携に必要な一連の対応を行いました。

主な対応内容は以下の通りです。

• クライアントアプリケーションのSmartHR Plus申請支援
• SmartHRログインを起点とした接続フローの構築
• SmartHR OAuth 2.0を利用した認証機能の実装
• SmartHRから送信されるWebhook通知の受信・更新処理
• データの整合性を確認するための定期バッチ処理
• 従業員情報と社内データベースの項目対応・データ変換
• SmartHR Plus公開に向けたテストおよび申請手続きの支援

これにより、法人ユーザーはSmartHRから健康管理アプリとの連携設定を行い、その後は従業員情報を継続的に同期できるようになりました。

SupremeTechが申請から開発、テストまでを一貫して支援することで、クライアントは複数の作業や関係者との調整を個別に進めることなく、SmartHR連携に必要な仕組みを整えることができました。

技術連携の設計

この連携は、4つの主要な技術要素を中心に設計しました。

SmartHR OAuth 2.0による安全な認証

SmartHR OAuth 2.0を利用し、SmartHRと健康管理アプリの間に安全な接続を構築しました。これにより、保護されたアクセストークンを通じてデータをやり取りできます。

Webhookによるリアルタイム更新

SmartHR上で従業員情報が変更された場合、たとえば従業員の新規登録、プロフィールの更新、利用停止などが行われると、Webhookイベントを通じて健康管理アプリへ通知されます。これにより、変更内容をより早く反映できます。

定期バッチによるデータ照合

データの整合性を長期的に保つため、SmartHR Crew Export APIを利用した定期バッチ処理も実装しました。

Webhookイベントに遅延や欠落、一時的な中断が発生した場合でも、従業員の基本情報を確認し、両システム間のデータを整合させることができます。

SmartHRを基準としたデータ連携

全体のデータ連携では、Webhookイベントとエクスポートによる同期を組み合わせました。

従業員情報は、健康管理アプリのデータベースや管理画面の処理へ連携されます。これにより、SmartHRを従業員情報の基準となるシステムとして維持しながら、健康管理アプリ側でも最新の人事情報と整合した状態を保てます。

この仕組みは、他の社内システムにも応用できます。すでにSmartHRを従業員情報の管理に利用している企業であれば、SupremeTechは正確な従業員情報を必要とする社内システムとの連携を支援できます。

導入効果

SmartHRとの連携機能はすでに本番環境で稼働しており、クライアントと健康管理アプリを利用する企業の双方に、さまざまな効果をもたらしています。

クライアント側の成果

新たに法人顧客が契約した際、従業員一覧を初日から健康管理アプリ上で利用できるようになり、手作業による初期設定が不要になりました。

また、クライアントの事業拡大に合わせて、連携の仕組みをそのまま拡張できるようになりました。

SmartHR Plusに掲載されたことで、SmartHRを利用している企業が健康管理アプリを見つけやすくなりました。さらに、すでにSmartHRを利用している見込み顧客に対しては、導入時の説明をより簡潔に行えるようになりました。

健康管理アプリを利用する人事担当者側の効果

従業員情報が両システム間で自動的に同期されるようになり、手作業による再入力が不要になりました。

入社、部署異動、退職などが発生した場合も、その変更内容が健康管理アプリに反映されます。

従業員情報を正確かつ一貫した状態で管理できるため、健康施策に関するデータの信頼性も高まりました。

これにより、人事担当者は管理作業にかける時間を減らし、より重要な健康管理業務に集中できるようになりました。

また、SupremeTechはSmartHRチームと直接連携し、検証環境でのテスト、SmartHR APIの確認、SmartHR Plusへの申請手続き全体を支援しました。

異なる2つのサービス間で調整を進めるには、時間と丁寧なコミュニケーションが必要です。SupremeTechがその対応を担うことで、クライアントが本来のサービス開発に集中できるよう支援しました。

この事例から得られた学び

本プロジェクトを通じて分かったのは、SmartHR連携は、単にAPIを接続するだけでは十分ではないということです。重要なのは、従業員情報が実際の業務でどのように利用されるのかを理解し、その業務の流れに合わせて連携方法を設計することでした。

更新内容をすぐに反映する必要がある場合には、Webhookが有効です。一方、長期的にデータの整合性を保つためには、定期的なバッチ同期も欠かせません。

この2つを組み合わせることで、更新の速さとデータの信頼性を両立した連携の仕組みを構築できました。

また、SmartHR Plusへの申請やテストを進めるうえでは、SmartHR側との丁寧な連携も重要でした。技術的な実装だけでなく、外部サービス上でアプリケーションを適切に提供するための調整も、プロジェクトを成功させるための大切な要素でした。

また、SmartHR Plusへの申請やテストを進めるうえでは、SmartHR側との丁寧な連携も重要でした。技術的な実装だけでなく、外部サービス上でアプリケーションを適切に提供するための調整も、プロジェクトを成功させるための大切な要素でした。

今後の展望

SmartHRとの連携により、この健康管理アプリは、今後のサービス拡充に向けたより強固なデータ基盤を備えることができました。

SmartHRから従業員情報を安定して取得できるようになったことで、クライアントは企業向けサービスのさらなる拡大に向けて、継続的に機能改善を進められるようになりました。

クライアントは現在、日本全国で事業を拡大しており、今後は次のような取り組みを予定しています。

• 日本全国のより多くの企業や自治体への展開
• 人事担当者向けの、より高度な分析機能と組織の健康状態に関するレポート
• 従業員の心身の健康に関するAI活用機能

SupremeTechは、長期的な開発パートナーとして、引き続きクライアントを支援しています。新機能の開発、健康管理アプリの安定運用、今後必要となる改善の検討まで、クライアントとともに取り組んでいます。

技術スタック

• Backend: PHP
• Mobile: iOS, Android
• Database: MySQL
• Infrastructure: AWS, GCP
• Authentication: SmartHR OAuth 2.0
• Data Update: SmartHR Webhook Subscriptions

SmartHRを利用しており、従業員情報を他の社内システムと連携したいとお考えの企業にとって、本SmartHR導入事例が参考になれば幸いです。

SupremeTechは、安全で実用性が高く、将来の拡張にも対応できるSmartHR連携の設計・開発をご支援します。

SmartHR連携をご検討の際は、ぜひSupremeTechまでお気軽にお問い合わせください。

プラットフォームの拡大をお考えなら、SupremeTechにお任せください。

SmartHR連携でも、まったく新しいシステム構築でも、私たちは長期的なパートナーとして貴社の成長に寄り添います。

→ お問い合わせはこちら: https://www.supremetech.vn/ja/contact/