.ppk署名済みのkintoneプラグイン(.zip)です。kintone「プラグインの追加」から読み込んでください。
概要
kintoneのレコードを保存したとき、プロセス管理のステータスが変わったとき、コメントが書き込まれたときに、Chatworkの指定したルームへ自動でメッセージを送るプラグインです。
通知のルールはいくつでも作れ、「区分が重要のときだけ」「受注金額が100万円以上のときだけ」のような条件や、送り先のルーム・宛先(TO)・本文をルールごとに決められます。本文にはレコードの項目の値やレコードへのリンクを差し込めます。
ご利用にはChatworkのAPIトークンが必要です。ライセンス認証は不要で、追加してすぐ使えます。
使い方・設定方法
kintoneでの動きを、チームが普段使っているChatworkのルームへ自動で知らせるプラグインです。「新しい案件が登録された」「申請が承認待ちになった」「レコードにコメントが付いた」といった出来事を、kintoneを開いていない人にも届けられます。
できること
- 4つのきっかけで通知:新規保存/編集保存/ステータス変更/コメント投稿
- 通知のルールを複数作成(上から順にすべて判定し、条件に合ったルールをそれぞれ送信)
- ルールごとに条件を設定(「すべてに一致」「いずれかに一致」を選択)
- 送り先ルーム・宛先(TO:ルームのメンバーから選択、または全員)をルールごとに指定
- タイトルと本文に、レコードの項目の値や「操作者」「レコードURL」などを差し込み
- 囲み枠(タイトル付き)での送信
- 設定画面からのテスト送信
事前準備
- 通知を送るChatworkアカウントで、APIトークンを発行します(Chatworkの「サービス連携」→「APIトークン」)。
- そのアカウントを、通知先のルームに参加させておきます。
通知専用のChatworkアカウントを用意することを強くおすすめします。 メッセージはトークンを発行したアカウントの名前で送られます。また、このアプリを使える人がブラウザの開発者ツールを使うと、そのアカウントの名前で、そのアカウントが参加しているルームへ投稿できてしまいます。通知するルームにだけ参加させたアカウントにしておけば、影響をそのルームの中にとどめられます。
設定手順
- アプリの設定 →「プラグイン」→「Chatwork通知」の歯車アイコンを開きます。
- APIトークンを入力し、「接続してルームを読み込む」を押します。接続したアカウント名と、参加しているルームが読み込まれます。
- 「ルールを追加」で通知ルールを作り、次の項目を設定します。
- 「テスト送信」で、送り先と本文の見え方を確認します。
- 「保存」を押し、アプリの設定画面で「アプリを更新」します。
| 設定項目 | 内容 |
|---|---|
| ルール名・有効 | ルールの名前。チェックを外すと一時的に止められます |
| 送信先ルーム | 読み込んだルームから選びます |
| 宛先(TO) | ルームのメンバーから選びます。「TO ALL(全員)」も選べます。選ばなければ宛先なしで投稿します |
| 通知のタイミング | 新規保存/編集保存/ステータス変更/コメント投稿 から選びます(複数可) |
| 編集保存:この項目が変わったときだけ | 選んだ項目が変わったときだけ送ります。何も選ばなければ、どの項目が変わっても送ります |
| ステータス変更:このアクションのときだけ | 選んだアクション(例:申請する)のときだけ送ります。何も選ばなければ、どのアクションでも送ります |
| 条件 | 項目ごとに条件を指定します。「すべてに一致」「いずれかに一致」を選べます。条件なしなら毎回送ります |
| タイトル・本文 | 送る文面です。差し込み(下表)を使えます |
| 囲み枠で送る | タイトル付きの枠で見やすく表示します |
条件で使える比べ方
| 項目の種類 | 比べ方 |
|---|---|
| 数値・計算(数値の書式) | 等しい/等しくない/より大きい/以上/より小さい/以下/空である/空でない |
| 日付・日時・時刻 | 等しい/等しくない/より後/以降/より前/以前/空である/空でない |
| 文字列・リンク | 等しい/等しくない/を含む/を含まない/空である/空でない |
| ドロップダウン・ラジオボタン・ステータス | 等しい/等しくない/空である/空でない |
| チェックボックス・複数選択 | を含む/を含まない/空である/空でない |
| ユーザー・組織・グループ選択 | を含む/を含まない/空である/空でない |
本文に差し込めるもの
| 差し込み | 内容 |
|---|---|
%アプリ名% | このアプリの名前 |
%レコード番号% | レコード番号 |
%レコードURL% | レコード詳細画面のURL |
%操作% | 新規保存/編集保存/ステータス変更/コメント投稿 |
%操作者% | 操作したユーザーの名前 |
%日時% | 通知した日時 |
%変更項目% | 編集保存で変わった項目名 |
%アクション% | ステータス変更で実行したアクション名 |
%変更前ステータス% / %変更後ステータス% | ステータス変更の前後 |
%コメント% | 投稿されたコメント本文 |
{{フィールドコード}} | レコードの項目の値(設定画面の一覧から選んで挿入できます) |
使い方
設定が済めば、利用者は特別な操作をする必要はありません。いつもどおりkintoneでレコードを保存したり、アクションを実行したり、コメントを書いたりすると、条件に合ったルールの通知がChatworkに届きます。
- 編集画面で何も変えずに保存したときは送りません。
- 項目の値に
[toall]や[To:…]のような文字が入っていても、Chatworkの宛先として働かないよう無害化して送ります。 - 送信に失敗したときは、画面の右下にお知らせを表示します(レコードの保存は取り消されません)。
注意事項・うまくいかないとき
- PC版とスマートフォンのブラウザで動きます。 kintoneモバイルアプリ、外部サービスやAPIからの登録・更新では通知されません。
- ステータス変更は、レコードの詳細画面でアクションを実行したときに通知します。
- コメント投稿は、レコード詳細画面でコメントを書いた本人の画面から送ります。
- 条件に使った項目を利用者が閲覧できない場合、その条件は「一致しない」として扱い、送りません。
- 通知が届かないときは、①トークンのアカウントが送信先ルームに参加しているか、②ルールが「有効」か、③条件・タイミングが合っているか、④設定の保存後に「アプリを更新」したか を確認してください。
- Chatworkには送信回数の上限があります(同じトークンで5分間に300回まで)。大量のレコードを短時間に保存するアプリでは、一部が送れないことがあります。
- 「Chatwork」は株式会社kubellの商標です。本プラグインは同社の公式製品ではありません。
バージョン履歴
- v1.0.02026-11-22
初回リリース。新規保存・編集保存・ステータス変更・コメント投稿をきっかけに、条件に合ったときだけChatworkへ通知できます。