HRMOS勤怠 の API で、チャットから打刻と勤怠の確認をする方法|管理者の設定と、できないこと

出勤の打刻を忘れて、昼過ぎに気付く。月末に残業時間を確認したくて、勤怠の画面を開き直す。HRMOS勤怠 を使っている会社では、こうした小さな操作が毎日のように起きます。

この記事は、HRMOS勤怠 を使っている会社の管理者と社員に向けて、チャットから打刻し、自分の勤務日と休暇の残りを確認する手順を説明します。後半では、管理者やマネージャーが全社の勤怠や月次レポートをチャットで確認する使い方も紹介します。

結論

• HRMOS勤怠 には公式の REST API があります。管理画面で API KEY を発行し、その Secret Key でトークンを発行して使います
• HRMOS勤怠 自身にも、Slack から打刻できる「slack打刻」があります。打刻と自分の勤怠サマリーを見るだけなら、まずこちらで足ります
• Samurai App の HRMOS勤怠 連携は、この API を使います。打刻と打ち忘れの修正、1 か月の勤務日と合計、休暇の残りを、自分の分だけチャットで扱えます
• 管理者とマネージャーは、全社や特定の社員の勤怠、ある日の全員の勤怠、月次レポートもチャットで見られます。見るだけで、ほかの人の打刻や修正はできません
• 月締めの申請と承認、年末調整の書類、打刻した場所の情報は、チャットから扱えません

チャットから打刻する 3 つの方法

HRMOS勤怠 の slack打刻 は、Slack に「HRMOS勤怠」のアプリを入れ、@HRMOS勤怠 を付けて in(出勤)や out(退勤)と送ると打刻できる機能です。HRMOS勤怠 の案内では、s と送ると総労働時間・実労働時間・残業時間・有給の残りのサマリーが本人にだけ表示されます。管理者が「システム管理」→「システム設定」で slack打刻 を有効にし、各自が「アカウント設定」→「アカウント連携」で Slack のアカウントとつなぎます。

API を呼ぶ連携ツール は、ノーコードの自動化サービスなどで HRMOS勤怠 の API を呼ぶ方法です。「このチャンネルに投稿したら出勤を打刻する」のように、決めた流れを自動で回すのに向いています。

Samurai App のチャット は、決まったコマンドを覚えずに頼めるのが違いです。「先週の水曜は 9 時半に出勤していたので、出勤の時刻を直して」のように、打刻と確認と修正を同じ会話で続けられます。

Samurai App でできること・できないこと

「コネクタ」の画面(/settings/connections)の HRMOS勤怠 の設定には、「チャットからできること」の一覧が 3 つに分けて載っています。連携する前から読めます。

自分の勤怠を見る(誰でも)

• 自分の 1 か月の勤怠と、実働・残業・深夜の合計を見る。日ごとに勤務区分、出退勤と休憩の時刻(入力した時刻と打刻した時刻)、実働・残業・深夜・法定内の時間が分かります。月の区切りは、HRMOS勤怠 に設定された各自の締め日に従います
• 自分の打刻の履歴を、新しい順に見る。出勤だけ、退勤だけのようにも絞れます
• 自分の休暇の付与・取得・残数を、年度ごとに見る
• 勤務区分、部門、雇用形態、拠点、休暇の種類の一覧を見る

打刻・修正する(自分の分だけ。既定では、実行する前に確認が出ます)

• 出勤・退勤・休憩の開始と終了を打刻する。打刻の時刻は、頼んだときの時刻だけです。夜勤の打刻を前日の勤務に数えることもできます
• 自分の日の出退勤と休憩の時刻を修正する。休憩は 2 回分まで直せます。修正できるのは、HRMOS勤怠 にすでにある日だけです

全社の勤怠を見る(管理者とマネージャーだけ)

• 社員の一覧を見る。社員番号、氏名、メールアドレス、入社日、部門、雇用形態、拠点が分かります
• 全社か、特定の社員の 1 か月の勤怠を見る
• ある日の全社の勤怠を見る
• 月次レポートを見る。所定と実働の時間、残業の 45 時間・60 時間の区分、出勤・欠勤・遅刻の日数、有給の取得と残りが分かります。申請や承認の状態でも絞れます
• ほかの社員の休暇の残数を見る

ここでいう管理者とマネージャーは、Samurai App での役割です。読める範囲は全社で、部門やチームだけに絞る設定はありません。

できないこと

• ほかの社員の打刻や修正
• 過去の時刻を指定した打刻。打ち忘れは、その日の時刻の修正で直します
• 月締めの申請と承認
• 年末調整の書類
• 打刻した場所の情報(位置や住所)

使い方の例

社員が自分の勤怠を確認する

• 朝の打刻。 「出勤を打刻して」と頼むと承認カードが出て、許可すると打刻した時刻が返ります
• 打ち忘れの修正。 「昨日は退勤を押し忘れた。18 時 40 分で直して」と頼みます。修正の前に、どの日のどの時刻をどう変えるかがカードに出ます
• 月の途中の確認。 「今月ここまでの残業の合計と、深夜の時間がある日を教えて」と頼むと、日ごとの記録から拾って答えます
• 休暇の残り。 「今年度の有給休暇の残りの日数を教えて」と頼みます。休暇の種類の一覧から有給休暇を選び、付与と取得の履歴の最後の行から残りを答えます

管理者とマネージャーが全社の勤怠を確認する

• その日の出勤の状況。 「今日の全社の勤怠を一覧にして、出勤の打刻がない人を挙げて」と頼みます
• 月末の残業の確認。 「先月の月次レポートで、残業が 45 時間の区分を超えた人を部門ごとにまとめて」と頼みます。社員の一覧に部門が入っているので、部門ごとにまとめられます
• 休暇の取得の状況。 「先月の月次レポートから、有給の残りが多い順に 10 人並べて」と頼みます

読んだ結果をもとに声をかけたり、勤怠を直してもらったりするのは人の仕事です。チャットから、ほかの社員の勤怠は書き換えられません。

用意するもの

• HRMOS勤怠 の管理画面で API KEY を発行できる人
• Samurai App の管理者かマネージャー(HRMOS勤怠 と連携する人)
• 会社の文字列。HRMOS勤怠 のログイン URL の https://ieyasu.co/ の後ろに続く、会社ごとの文字列です
• 使う人の HRMOS勤怠 の社員情報に、Samurai App にサインインしているメールアドレスが登録されていること

手順

1. HRMOS勤怠 で API KEY を発行する

HRMOS勤怠 の「システム管理」→「システム設定」で API KEY を発行し、Secret Key を控えます。Secret Key は、API のトークンを発行するための値です。流出しないように扱います。

2. 管理者が Samurai App で連携する

「コネクタ」の画面を開き、「API 連携」タブの「API 連携を追加」から HRMOS勤怠 を選びます。「会社の文字列」と「Secret Key」を入れ、「HRMOS勤怠 と連携する」を押します。

連携が済むと「連携済み」と表示されます。Secret Key は連携しているあいだ Samurai App が預かり、期限の切れたトークンの発行し直しに使います。期限切れの警告は出ません。

3. 各メンバーが自分の HRMOS勤怠 アカウントを確認する

使う人はそれぞれ、同じ節の「自分の HRMOS勤怠 アカウントを確認する」を 1 回押します。HRMOS勤怠 の社員のうち、メールアドレスが同じ人に結び付き、「HRMOS勤怠 では ○○ として操作します」と表示されます。管理者とマネージャーも、全社の勤怠を見る前にこの確認をします。

確認していない人は、チャットから HRMOS勤怠 を使えません。

4. チャットで頼む

今月の私の勤怠を日ごとに見せて。
残業のあった日だけを抜き出して、残業の合計も教えて

11 月 5 日の休憩を 12 時から 13 時に直して。直す前に、いまの記録と並べて見せて

既定では、打刻と修正の前に承認カードが出ます。種類と時刻を読んでから許可します。

注意点

打刻は、頼んだときの時刻で入ります。 「9 時に出勤」と言っても、打刻そのものは今の時刻です。過去の時刻にしたいときは、打刻ではなく修正を頼みます。

修正は、HRMOS勤怠 にすでにある日だけ。 送った項目だけが変わり、ほかの時刻はそのままです。修正したあとの申請や承認は、HRMOS勤怠 の画面で行います。

全社の勤怠には、社員の氏名やメールアドレスが含まれます。 読んだ結果をほかの人に渡すときは、相手と範囲を選んでください。

連携を解除すると、全員の本人確認も外れます。 確認の画面が出て、預けた Secret Key とトークンを破棄します。解除せずに別の会社の文字列でつなぎ直したときも、本人確認は外れます。API KEY そのものを無効にするには、HRMOS勤怠 の管理画面で削除してください。HRMOS勤怠 の公式文書では、API KEY を削除すると、そこから発行したトークンもすべて削除されます。

よくある質問

HRMOS勤怠 の API はどのプランで使えますか

2026 年 11 月 9 日時点の HRMOS勤怠 の料金ページでは、「HRMOS勤怠API」は有料プランの基本機能の一覧に載っています。無料プランで使えるかは、料金ページには書かれていませんでした。契約の前に HRMOS勤怠 に確認してください。

slack打刻 と何が違いますか

slack打刻 は HRMOS勤怠 が提供する機能で、決まったコマンドで打刻と今日時点のサマリーの確認ができます。Samurai App は、日ごとの記録や休暇の履歴まで読み、打ち忘れの修正も同じ会話で頼める点が違います。全社の勤怠を読めるのも Samurai App の側です。打刻だけで足りるなら、slack打刻 で十分です。

チームリーダーに、チームの勤怠だけを見せられますか

できません。全社の勤怠を読めるのは Samurai App の管理者とマネージャーだけで、読める範囲は全社です。チームリーダーにチームの分だけを見せたいときは、管理者かマネージャーが読んだ結果から、そのチームの分だけを渡します。

打刻の場所は記録されますか

Samurai App からの打刻には、場所の情報を付けていません。チャットで打刻の履歴を読んでも、位置や住所は返しません。

出典

• ハーモス勤怠 API 定義(HRMOS勤怠、バージョン 1.0.19)
• 【ハーモス勤怠の使い方】slack打刻をリリースいたしました(HRMOS勤怠、2022 年 2 月 14 日)
• API連携方法|『マネーフォワード クラウド給与』と『ハーモス勤怠』の連携方法(HRMOS勤怠)
• 料金プラン(HRMOS勤怠)
• 外部サービスとの連携(Samurai App の使い方)
• API 連携の各サービスの繋ぎ方(Samurai App の使い方)

2026 年 11 月 9 日時点で、HRMOS勤怠 の公式の API 文書、料金ページ、使い方の記事を確認したものです。