メインコンテンツにスキップ
SVDY Logo
開発者ガイド
提供中

チームのアラートをSlackで受け取る

遅刻通知、休暇申請、プロセスの承認がSlackチャンネルに直接届きます。3つのアプリをチェックする必要はもうありません。1つのチャンネルが唯一の情報源になります。

現場が感謝してくれる理由

HR 担当者は、もう毎朝 3 つのアプリを行き来する必要はありません。打刻の遅れは「翌朝のサマリー」ではなく、発生した瞬間に通知されます。休暇申請はチームのチャンネルに直接投稿され、滞留状況が全員から見える状態になります。承認は対象のチャンネルへ自動でルーティングされます。最初に一度だけ設定すれば、あとはずっと動き続けます。

情シスへのチケット不要

チャンネル管理者が Connect を押し、チャンネルを選ぶだけで完了します。テナント管理者の承認も、30 日かけた稟議も不要です。

整理されたメッセージ

各通知は整形済みの Slack メッセージで、対象の申請に直接ジャンプできるリンク付きです。チームはワンクリックで対応できます。

不要な通知だけ止められる

シフト割当の通知が不要なら、それだけオフにできます。打刻遅刻の通知は維持できます。アラート単位の制御は Pro プランから利用可能です。

シークレットは厳重に管理

Slack トークンは保存時に暗号化されます。インストール後は SVDY のサポートチームでさえ復号して読み取ることはできません。

30 秒でインストール

1

QuTime / PureOA テナントの /admin/integrations を開きます。

2

Slack のカードをクリックし、Connect を選択します。

3

Slack の認可画面が開くので、通知を受け取りたいチャンネルを選びます。

4

Slack から svdy に戻ります。緑色の "Connected" バッジと、イベントごとのトグル一覧が表示されます。

5

(任意)Send test をクリックして、実際のメッセージで連携を確認します。

必要なプラン:Starter 以上。Free プランの組織が Connect を押すと、license_required コードとともに 402 が返ります。


オン/オフできるアラート一覧

アラートは 7 種類 — 打刻遅刻、休暇申請、承認フロー。各 Slack メッセージには 1 行サマリーと「Open request」ボタンが付き、マネージャーはワンクリックで対応できます。すべて個別にオン/オフでき、チャンネルが通知の洪水にならないように設計されています。

打刻遅刻

ソース: attendance

clock_in_late
デフォルト ON

Pro:ミュート可

🌴

休暇申請の提出

ソース: leaves

leave_request_submitted
デフォルト ON

Pro:ミュート可

休暇承認

ソース: leaves

leave_request_approved
デフォルト ON

Pro:ミュート可

休暇却下

ソース: leaves

leave_request_rejected
デフォルト ON

Pro:ミュート可

📋

ワークフロー申請の提出

ソース: process

process_request_submitted
デフォルト ON

Pro:ミュート可

🔄

ワークフロー状態の変更

ソース: process

process_request_status_changed
デフォルト ON

Pro:ミュート可

📅

シフト割当

ソース: attendance

shift_assigned
デフォルト OFF

Pro:ミュート可

Professional+

イベント単位のミュート

Professional / Enterprise プランでは、接続ダイアログに 7 種類すべてのイベントトグルが表示されます。割当が頻繁なシフト(例:shift_assigned)など、騒がしいイベントだけを連携を切らずにミュートできます。下位プランでは 7 種すべてが既定でオンになります — 利用できない機能を UI 上でちらつかせることはありません。

PATCH /v1/integrations/connections/slack/event-subscriptions

{
  "event_subscriptions": {
    "clock_in_late": false,
    "shift_assigned": true
  }
}

部分 PATCH — ボディに含まれないキーは現在の値を保持します。未知のイベントキーは静かに破棄されます(クライアントの誤入力に対する保護)。


Block Kit メッセージの構成

各イベントは 4 つの Block Kit ブロックでレンダリングされます:絵文字+タイトルの header、mrkdwn の section 本文、ディープリンクがある場合の actions ボタン(任意)、そしてイベントキーとタイムスタンプを含む小さなグレーの context フッター。

{
  "text": "⏰ Alice late by 12 min",
  "blocks": [
    { "type": "header",
      "text": { "type": "plain_text", "text": "⏰ Alice late by 12 min", "emoji": true } },
    { "type": "section",
      "text": { "type": "mrkdwn", "text": "Clocked in at 09:12 · scheduled 09:00 · Front Office" } },
    { "type": "actions",
      "elements": [
        { "type": "button", "style": "primary",
          "text": { "type": "plain_text", "text": "Open in svdy" },
          "url": "https://qutime.com/admin/attendance/entries/te_..." }
      ] },
    { "type": "context",
      "elements": [
        { "type": "mrkdwn",
          "text": "`clock_in_late` · 2026-05-24 14:00 UTC" }
      ] }
  ]
}

トラブルシューティング

インストール失敗時、svdy は /admin/integrations?integration_error=<code> にリダイレクトします。よく見るコード:

license_required

組織のプランが Slack では Starter 未満、Teams / WeCom では Professional 未満です。

/admin/billing でアップグレードするか、営業にお問い合わせください。

state_expired_or_invalid

OAuth ステートトークンの有効期限切れ(TTL 5 分)、または改ざんが検出されました。

/admin/integrations から Connect Slack をもう一度クリックしてください。

provider_mismatch

OAuth ステートが、URL に記載されたプロバイダーとは別のプロバイダー向けに発行されています。

ほぼ確実に攻撃の兆候です — リクエストを拒否し、最初からやり直してください。

code_exchange_failed

Slack が認可コードを拒否しました。

一度切断してから再度接続してください。改善しない場合は support@svdy.com までご連絡ください。

provider_error:access_denied

管理者が Slack の認可画面で「キャンセル」をクリックしました。

Connect Slack をもう一度クリックして承認してください。


他のメッセージング基盤

Slack が OAuth を使えるのは、incoming-webhook スコープがチャンネル固有の URL を返してくれるからです。Microsoft と Tencent には同等の仕組みがないため、両方とも「URL を貼り付ける」方式になります。プラットフォーム側でコネクタやボットを作成し、その URL を svdy に貼り付けてください。

Microsoft Teams

Professional+

HTTP トリガーの Power Automate Workflow を使用してください。Microsoft は 2025-12-31 に Office 365 Connectors を廃止しました。ペイロードは Adaptive Card v1.5 です。

受け付けている Webhook URL のホスト: *.webhook.office.com, *.logic.azure.com, *.azurewebsites.net.

WeCom (企业微信)

Professional+

WeCom 内でグループロボット(群机器人)を作成し、Webhook URL をコピーしてください。ペイロードは Markdown(4096 バイト上限)。

受け付けているホスト: qyapi.weixin.qq.com. HTTP ステータスが 2xx 以外、または errcode が 0 以外の場合は失敗として扱います。

Slack 連携の準備はできましたか?

テナントの統合ページを開き、Connect をクリックするだけ — 30 秒で動作する状態になります。料金プランをまず比較したい場合も、すぐ参照できます。