Slack - 通知の送信

2026年2月24日にメンテナンス済み

kintone と Slack を連携させることで、レコードの作成・更新時に Slack チャンネルへ自動通知を送ることができます。kintone には Slack との標準連携機能がありますが、担当者へのダイレクトメッセージに限定されるため、チャンネルへの通知やカスタムメッセージの送信には JavaScript カスタマイズが必要です。

この記事では、Slack の Incoming Webhook と kintone.proxy を使って、kintone から Slack に通知を送る方法を解説します。

事前準備

Slack Incoming Webhook の設定

Slack API のアプリページにアクセスし、新しいアプリを作成するか、既存のアプリを選択します
「Incoming Webhooks」を有効にします
「Add New Webhook to Workspace」から通知先のチャンネルを選択します
生成された Webhook URL をコピーします

Webhook URL は以下のような形式です。

https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX

チェック

Webhook URL には認証情報が含まれています。ソースコード上にハードコーディングせず、kintone の設定用アプリや環境変数で管理することを推奨します。

基本的な通知の送信

シンプルなテキスト通知

最もシンプルな Slack 通知の実装です。

slack-simple.js

(() => {
  'use strict';

  /**
   * Slack の Incoming Webhook にメッセージを送信する
   * @param { Object } params
   * @param { string } params.webhookUrl - Slack Webhook URL
   * @param { string } params.message - 送信するメッセージ
   * @returns { Promise<[string, number, Object]> } kintone.proxy のレスポンス
   */
  const sendSlackMessage = (params) => {
    const { webhookUrl, message } = params;

    return kintone.proxy(
      webhookUrl,
      'POST',
      { 'Content-Type': 'application/json' },
      JSON.stringify({ text: message })
    );
  };

  // 使用例
  const WEBHOOK_URL = 'https://hooks.slack.com/services/xxx/yyy/zzz';

  sendSlackMessage({
    webhookUrl: WEBHOOK_URL,
    message: 'kintone からのテスト通知です',
  }).then(([body, statusCode]) => {
    console.log('送信結果:', statusCode);
  });
})();

kintone.proxyの使い方

kintone JavaScript カスタマイズから外部 API を呼び出す際に必要な kintone.proxy の使い方を解説します。GET/POST/PUT/DELETE の各メソッドの使い方、リクエストヘッダーの設定、レスポンスの

レコード保存時に自動通知する

レコードの作成・更新が成功したタイミングで Slack に自動通知を送る実装です。

slack-on-submit.js

(() => {
  'use strict';

  const WEBHOOK_URL = 'https://hooks.slack.com/services/xxx/yyy/zzz';

  /**
   * Slack に通知を送信する
   * @param { string } message - メッセージ
   */
  const notifySlack = async (message) => {
    const [, statusCode] = await kintone.proxy(
      WEBHOOK_URL,
      'POST',
      { 'Content-Type': 'application/json' },
      JSON.stringify({ text: message })
    );

    if (statusCode !== 200) {
      console.error('Slack通知に失敗しました:', statusCode);
    }
  };

  // レコード作成成功時に通知
  kintone.events.on('app.record.create.submit.success', async (event) => {
    const record = event.record;
    const recordUrl = `${location.origin}/k/${kintone.app.getId()}/show#record=${event.recordId}`;

    const message = [
      '📝 新しいレコードが作成されました',
      `*タイトル:* ${record['タイトル'].value}`,
      `*作成者:* ${record['作成者'].value.name}`,
      `*リンク:* ${recordUrl}`,
    ].join('\n');

    await notifySlack(message);

    return event;
  });

  // レコード更新成功時に通知
  kintone.events.on('app.record.edit.submit.success', async (event) => {
    const record = event.record;
    const recordUrl = `${location.origin}/k/${kintone.app.getId()}/show#record=${event.recordId}`;

    const message = [
      '✏️ レコードが更新されました',
      `*タイトル:* ${record['タイトル'].value}`,
      `*更新者:* ${record['更新者'].value.name}`,
      `*リンク:* ${recordUrl}`,
    ].join('\n');

    await notifySlack(message);

    return event;
  });
})();

チェック

submit.success イベントは、レコードの保存が成功した後に発火します。このタイミングで通知を送ることで、保存に失敗した場合に不要な通知が送られるのを防げます。

リッチなメッセージの送信

Slack のメッセージフォーマットを使って、より見やすい通知を送ることができます。

Block Kit を使ったリッチメッセージ

slack-blocks.js

/**
 * Block Kit を使ったリッチな Slack 通知を送信する
 * @param { Object } params
 * @param { string } params.webhookUrl - Webhook URL
 * @param { Object } params.record - kintone レコード
 * @param { string } params.recordUrl - レコードのURL
 */
const sendRichSlackMessage = (params) => {
  const { webhookUrl, record, recordUrl } = params;

  const payload = {
    blocks: [
      {
        type: 'header',
        text: {
          type: 'plain_text',
          text: '📋 新しい申請が登録されました',
        },
      },
      {
        type: 'section',
        fields: [
          {
            type: 'mrkdwn',
            text: `*申請者:*\n${record['申請者'].value.name}`,
          },
          {
            type: 'mrkdwn',
            text: `*カテゴリ:*\n${record['カテゴリ'].value}`,
          },
          {
            type: 'mrkdwn',
            text: `*金額:*\n¥${Number(record['金額'].value).toLocaleString()}`,
          },
          {
            type: 'mrkdwn',
            text: `*優先度:*\n${record['優先度'].value}`,
          },
        ],
      },
      {
        type: 'section',
        text: {
          type: 'mrkdwn',
          text: `*内容:*\n${record['申請内容'].value}`,
        },
      },
      {
        type: 'actions',
        elements: [
          {
            type: 'button',
            text: {
              type: 'plain_text',
              text: 'kintone で確認する',
            },
            url: recordUrl,
          },
        ],
      },
    ],
  };

  return kintone.proxy(
    webhookUrl,
    'POST',
    { 'Content-Type': 'application/json' },
    JSON.stringify(payload)
  );
};

条件に応じた通知先の切り替え

フィールドの値に応じて通知先のチャンネル（Webhook URL）を切り替える例です。

slack-conditional-channel.js

(() => {
  'use strict';

  /** カテゴリごとの Webhook URL */
  const WEBHOOK_URLS = {
    営業: 'https://hooks.slack.com/services/xxx/sales/zzz',
    開発: 'https://hooks.slack.com/services/xxx/dev/zzz',
    総務: 'https://hooks.slack.com/services/xxx/general/zzz',
  };

  /** デフォルトの通知先 */
  const DEFAULT_WEBHOOK = 'https://hooks.slack.com/services/xxx/default/zzz';

  kintone.events.on('app.record.create.submit.success', async (event) => {
    const record = event.record;
    const category = record['部署'].value;

    const webhookUrl = WEBHOOK_URLS[category] || DEFAULT_WEBHOOK;

    const message = `新しい申請: ${record['タイトル'].value} (${category})`;

    await kintone.proxy(
      webhookUrl,
      'POST',
      { 'Content-Type': 'application/json' },
      JSON.stringify({ text: message })
    );

    return event;
  });
})();

エラーハンドリング

Slack 通知の送信に失敗しても、レコードの保存処理自体には影響を与えたくない場合のエラーハンドリングパターンです。

slack-error-handling.js

/**
 * Slack 通知を送信する（失敗してもエラーをスローしない）
 * @param { string } webhookUrl - Webhook URL
 * @param { string } message - メッセージ
 * @returns { Promise<boolean> } 送信成功の場合は true
 */
const sendSlackSafe = async (webhookUrl, message) => {
  try {
    const [, statusCode] = await kintone.proxy(
      webhookUrl,
      'POST',
      { 'Content-Type': 'application/json' },
      JSON.stringify({ text: message })
    );

    if (statusCode !== 200) {
      console.warn(`Slack通知に失敗しました (HTTP ${statusCode})`);
      return false;
    }

    return true;
  } catch (error) {
    console.warn('Slack通知でエラーが発生しました:', error);
    return false;
  }
};

チェック

通知の送信失敗がユーザーの業務に影響を与えないよう、try-catch で囲んでエラーを吸収するのが一般的なパターンです。通知は「ベストエフォート」として扱い、失敗してもレコード操作は正常に完了させましょう。

Webhook URL を安全に管理する

Webhook URL をソースコードにハードコーディングするのはセキュリティ上好ましくありません。kintone の設定用アプリに保存して取得する方法を推奨します。

webhook-config.js

/**
 * 設定アプリから Webhook URL を取得する
 * @param { string | number } configAppId - 設定用アプリのID
 * @returns { Promise<string> } Webhook URL
 */
const getWebhookUrl = async (configAppId) => {
  const response = await kintone.api(
    kintone.api.url('/k/v1/records.json', true),
    'GET',
    {
      app: configAppId,
      query: '設定キー = "SLACK_WEBHOOK_URL"',
      fields: ['設定値'],
    }
  );

  if (response.records.length === 0) {
    throw new Error('Webhook URL の設定が見つかりません');
  }

  return response.records[0]['設定値'].value;
};

定数定義

定数定義は本当に様々な方法で実装可能なため、どのように実装するのがベストなのか、今でもよく悩むところです。今回は、僕が実際に採用してうまくいった方法を紹介したいと思います。

まとめ

kintone.proxy と Slack の Incoming Webhook を使って、kintone から Slack に通知を送信できる
submit.success イベントを使うことで、レコード保存成功後に自動通知が可能
Block Kit を使ってリッチなメッセージフォーマットで通知できる
フィールドの値に応じて通知先チャンネルを切り替えることも可能
通知の失敗がレコード操作に影響しないよう、エラーハンドリングを適切に行う
Webhook URL はソースコード以外の安全な場所で管理する

#kintone #JavaScript #Slack

kintoneとGoogle Apps Script(GAS)を連携してデータを同期する方法

kintoneからMicrosoft Teamsに通知を送信する方法