RENOY
DX・内製化

Chatworkのメンション未読数で返信漏れは検知できない|実測で常に0だった原因と対策

目次

「返信漏れをシステムで検知したい」——チャットが業務の中心になるほど、この相談は増えます。私たちも自社の運用で、Chatworkのメンション未読数を使った返信漏れ検知の仕組みを作りました。

結果は、失敗でした。実装は正しく動いていたのに、一度も発火しないのです。原因を追うと、技術ではなく運用側にありました。

この記事では、そのときに分かったことと、検知の仕組みを作る前に必ずやるべき確認を整理します。

この記事の結論

  • メンション未読数は「放置する人」にしか立たないシグナル
  • 本当の課題は「読んだ後の返信忘れ」で、未読数では測れない
  • トリガを決める前に、対象者の実際の操作ログを実測する

Chatworkのメンション未読数(mention_num)とは

Chatworkには、自分宛のメンションのうち、まだ読んでいない件数を表す値があります。API上ではmention_numとして扱われ、チャットルームごとに取得できます。

「自分宛に呼びかけられたのに、まだ読んでいない」件数なので、一見すると返信漏れの検知にうってつけに見えます。私たちも、この値が一定以上になったら通知を飛ばす、という仕組みを作りました。設計としては素直で、実装も難しくありません。

なお、Chatwork APIの仕様は変わることがあるため、最新の項目や取得条件は必ず公式のドキュメントで確認してください。

未読数が常に0だった原因

仕組みを入れてから、実際の値を記録してみました。すると、ほぼ常に0。閾値を下げても、発火する日がほとんどありません。

理由は単純でした。通知が来たら、その場で開いてしまうからです。スマートフォンの通知を見て、内容を確認した時点で既読になります。返信は「あとでまとめて」でも、開くこと自体は即座にやっている。結果として、未読は残りません。

つまり、このシグナルが立つのは未読を放置するタイプの人だけです。放置しない人ほど値が0で張り付き、検知の対象から外れてしまいます。いちばん検知したかった自分自身が、いちばん検知できない対象だった、ということです。

検知したい状態と、観測できるシグナルがずれていた

ここが本質でした。私たちが困っていたのは「未読を放置している」ではありません。読んだが返信を忘れたことです。

この2つは、まったく別の状態です。

検知したい状態未読数で分かるか必要な観測点
未読のまま放置している分かるメンション未読数
読んだが返信を忘れた分からない自分宛の発言以降に自分の発言があるか
返信したが内容が不十分分からない人の判断が必要

構造としては、メールの返信漏れとまったく同じです。受信トレイを開いて中身を見た時点で未読は消えますが、返信したかどうかは別の話です。未読管理と返信管理は、別の指標で見るしかありません。

「読んだが返信していない」を捉えたいなら、観測すべきは未読数ではなく、自分宛の発言より後に自分の発言があるかどうかという時系列です。取得できる情報の範囲はサービス側の仕様に依存するので、ここも公式仕様の確認が前提になります。

同じ失敗を避けるための進め方

教訓は、ツール固有の話ではありません。検出トリガを決める前に、そのシグナルが自分の運用で本当に立つのかを実測するということです。

  1. 対象者の操作を観測する:仕組みを作る前に、まず値を記録するだけの状態で数日〜数週間動かします。閾値も通知もいりません。記録だけです。
  2. シグナルが立つか確認する:記録した値が、狙った場面で本当に変化しているかを見ます。0のまま動かないなら、その指標は使えません。
  3. 立つなら実装、立たなければ観測点を変える:立たない場合は、閾値を下げるのではなく、別の観測点を探します。閾値調整で粘るのは時間の無駄になりがちです。

особенно大事なのは、想像で決めないことです。「未読が溜まっているはずだ」という前提は、自分の実際の操作とは違っていました。作る側の思い込みと、現場の実際の手の動きがずれていた、というだけの話です。

先に「記録するだけ」を入れる価値

この順番のいいところは、コストがほとんどかからない点です。値を記録するだけの仕組みは短時間で作れますし、動かしても誰にも迷惑をかけません。そのうえで「このシグナルは使える/使えない」が事実として分かります。

逆に、通知や自動処理まで一気に作り込んでから空振りに気づくと、作った分がまるごと無駄になります。自動化の失敗の多くは、コードの品質ではなく観測点の選び間違いから起きます。

よくある質問

Q. Chatworkのメンション未読数で返信漏れは検知できますか? できないことが多いです。通知が来たらすぐ開く運用の人は未読が残らないため、未読数はほぼ常に0のままです。検知したいのは「読んだが返信を忘れた」状態で、未読数では測れません。

Q. なぜメンション未読数が常に0になるのですか? 原因は技術ではなく運用です。通知を見た時点でメッセージを開き、既読になるからです。未読が残るのは放置する人だけなので、放置しない人ほどこのシグナルは立ちません。

Q. 返信漏れを検知する仕組みはどう設計すればよいですか? 実装前に対象者の実際の操作ログを観測し、狙ったシグナルが本当に立つかを確かめます。立たないなら、未読ではなく「自分宛の発言以降に自分の返信があるか」など別の観測点に切り替えます。

まとめ

  • Chatworkのメンション未読数は、実測するとほぼ常に0で、検知トリガとして機能しなかった
  • 原因は技術ではなく運用。通知が来たらすぐ開く人には未読が残らない
  • 本当の課題は「読んだが返信を忘れた」で、これは未読数では測れない
  • 作る前に「記録するだけ」を入れて、シグナルが本当に立つかを実測する

RENOYでは、自動化の仕組みを作る前に「その指標で本当に検知できるのか」を確かめるところから設計しています。「チャットの返信漏れをなんとかしたい」「通知の仕組みを作ったが機能していない」といった段階のご相談も歓迎です。まずはお気軽に無料個別相談(オンライン・60分)をご利用ください。サービス内容をまとめた資料は資料請求からご覧いただけます。

#Chatwork#業務自動化#API連携#中小企業#DX