kintoneでフィールドが特定の値に変更された時にLINEへ通知する設定とJavaScriptサンプルコード

悲報

えぇ…記事公開から24時間も経たないうちになんというニュース…

概要

前の記事にて、kintoneのレコード保存で、
Slackへ通知する方法を記載しました。

が、コードはほぼそのままで、
LINE Notify APIを使うことでLINEへも簡単に通知することができたので、
こちらに手順を記載していきます。

前準備

LINE Notifyにログインします。

サイトは以下となります。

初めてログインするとLINEにて、LINE Notifyからトークが届いています。
確認し、通知を行いたいルームへLINE Notifyを追加します。

アクセストークンの発行

PCのLINE Notify管理画面に戻り、マイページから、
「アクセストークンの発行(開発者向け)」を選択。

すると、どのルームに対し発行するかを求められるので
先ほどのルームを選択。

すると無事にアクセストークンを発行できました。

これを用いてコードを記述します。

発行したアクセストークンを設定します。

コード

yourLineNotifyTokenに先ほどのトークンを貼り付けつつ、全体の情報を変更します。

(function () {
    const subdomain = 'yourDomain'; // あなたのkintoneのサブドメイン
    const appId = '123'; // あなたのkintoneのアプリID
    const targetFieldCode = 'yourFieldCode'; // 監視するフィールドコード
    const specificValue = 'yourValue'; // 監視するフィールドコードの値
    const lineNotifyToken = 'yourLineNotifyToken'; // LINE Notifyのアクセストークン
    let oldValue; // 監視対象のフィールドコードの旧値を保持する変数
    // メッセージに含みたいフィールドコードIDがあれば追加で変数を定義する

    // 編集画面が表示されたときに発火するイベント
    kintone.events.on('app.record.edit.show', function (event) {
        // 監視対象のフィールドコードの旧値を取得
        oldValue = event.record[targetFieldCode].value;
    });

    // 保存ボタンが押されたときに発火するイベント
    kintone.events.on('app.record.edit.submit', function (event) {
        // 現在のフィールドの値を取得
        const currentValue = event.record[targetFieldCode].value;

        // 監視するフィールドの値が旧値から変更されていて、なおかつ指定した特定の値に等しい場合のみ、LINE通知する処理を続行する
        if (currentValue !== oldValue && currentValue === specificValue) {
            // 対象レコードのURLを取得（メッセージ用）
            const recordId = event.recordId;
            const recordUrl = `https://${subdomain}.cybozu.com/k/${appId}/show#record=${recordId}`;

            // LINEに送信するメッセージ
            const message = `フィールド ${targetFieldCode} の値が ${specificValue} に変更されました。\n対象レコード：${recordUrl}`;

            // kintone.proxyを使用してLINE Notify APIにPOSTリクエストを送信
            const body = `message=${encodeURIComponent(message)}`; // LINE NotifyはURLエンコードされた形式でメッセージを送信
            const requestOptions = {
                method: 'POST',
                headers: {
                    'Content-Type': 'application/x-www-form-urlencoded',
                    'Authorization': `Bearer ${lineNotifyToken}`
                },
                body: body
            };

            // kintone.proxyでリクエストを実行
            kintone.proxy('https://notify-api.line.me/api/notify', requestOptions.method, requestOptions.headers, requestOptions.body)
                .then(function (response) {
                    console.log('LINEへの通知に成功:', response);
                })
                .catch(function (error) {
                    console.error('LINEへの通知に失敗:', error);
                });
        }

        return event; // 処理を続行
    });
})();

前回のSlackと同様に、コード内にトークンを入れるのはそれなりにリスクがあるため、
場合によっては環境変数などで行うことをオススメします

テスト

kintoneのレコード編集でぶじに通知が来ました。

なお、Slackの通知と共存することも可能です。

まとめ

基本的に通常の内容はSlackで良いと思いますが、
緊急性を要するものや重大な内容についてはLINEなど、
棲み分けをすることで対応意識に差をつけることができると思います。

内容や組織体によってどちらを使うか選んでいきましょう！