Entwickler-Anleitung

Verfügbar

Holen Sie die Alerts Ihres Teams in Slack

Verspätete Stempelungen, Urlaubsanträge, Prozess-Genehmigungen erscheinen direkt in Ihrem Slack-Kanal. Ihr Team prüft nicht mehr drei Apps am Morgen. Ein Kanal, eine Wahrheit.

Connectors öffnen Alle Integrationen

Warum Ihr Team Ihnen danken wird

HR-Verantwortliche müssen morgens nicht mehr drei Apps prüfen. Verspätete Stempelungen erscheinen sofort — nicht erst in der Zusammenfassung von morgen. Abwesenheitsanfragen werden im Team-Channel gepostet, wo der Rückstand für alle sichtbar ist. Prozessfreigaben werden automatisch in den richtigen Channel geleitet. Einmal einrichten; läuft danach dauerhaft.

Kein IT-Ticket

Die Channel-Verantwortlichen klicken auf Connect, wählen den Channel — fertig. Keine Tenant-Admin-Freigabe, kein 30-Tage-Beschaffungsprozess.

Saubere Nachrichten

Jede Benachrichtigung ist eine formatierte Slack-Nachricht mit Deeplink zur Anfrage — Ihr Team handelt mit einem Klick.

Schalten Sie aus, was Sie nicht wollen

Schichtzuweisungen interessieren Sie nicht? Schalten Sie sie aus, ohne die Verspätungs-Alerts zu verlieren. Pro Alert-Kontrolle ab Pro-Tarif.

Geheimnisse unter Verschluss

Slack-Tokens werden im Ruhezustand verschlüsselt. Selbst der SVDY-Support kann sie nach der Installation nicht mehr lesen.

In 30 Sekunden eingerichtet

Öffnen Sie /admin/integrations in Ihrem QuTime- / PureOA-Tenant.

Klicken Sie auf die Slack-Karte → Connect.

Slack öffnet die Autorisierungsseite; wählen Sie den Channel für die Benachrichtigungen.

Slack kehrt zu svdy zurück; ein grüner "Connected"-Chip und die Toggle-Liste pro Event werden angezeigt.

(Optional) Klicken Sie auf Send test, um die Integration mit einer echten Nachricht zu prüfen.

Erforderlicher Tarif: Starter oder höher. Organisationen im Free-Tarif erhalten beim Connect ein 402 mit dem Code license_required.

Alerts, die Sie aktivieren können

7 Alert-Typen — verspätete Stempelungen, Abwesenheitsanfragen, Prozessfreigaben. Jede Slack-Nachricht enthält eine einzeilige Zusammenfassung und einen "Open request"-Button, damit eine Führungskraft mit einem Klick reagieren kann. Alle 7 sind ein- und ausschaltbar, sodass Ihr Channel nicht zur Geräuschmaschine wird.

⏰

Verspätete Stempelung

Quelle: attendance

clock_in_late

Standardmäßig EIN

Pro: stummschalten

🌴

Abwesenheitsanfrage eingereicht

Quelle: leaves

leave_request_submitted

Standardmäßig EIN

Pro: stummschalten

✅

Abwesenheit genehmigt

Quelle: leaves

leave_request_approved

Standardmäßig EIN

Pro: stummschalten

❌

Abwesenheit abgelehnt

Quelle: leaves

leave_request_rejected

Standardmäßig EIN

Pro: stummschalten

📋

Prozessanfrage eingereicht

Quelle: process

process_request_submitted

Standardmäßig EIN

Pro: stummschalten

🔄

Prozessstatus geändert

Quelle: process

process_request_status_changed

Standardmäßig EIN

Pro: stummschalten

📅

Schicht zugewiesen

Quelle: attendance

shift_assigned

Standardmäßig AUS

Pro: stummschalten

Professional+

Stummschalten pro Event

In den Tarifen Professional und Enterprise zeigt der Verbindungs-Dialog Schalter für jedes der 7 Events. Schalten Sie laute Events stumm (z. B. shift_assigned bei häufig wechselnden Plänen), ohne die Integration zu trennen. Niedrigere Tarife erhalten alle sieben Events standardmäßig — keine UI-Köder für nicht aktivierte Funktionen.

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

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

Partielles PATCH — im Body weggelassene Schlüssel behalten ihren bisherigen Wert. Unbekannte Event-Schlüssel werden stillschweigend verworfen (Schutz gegen Tippfehler des Clients).

Block-Kit-Nachrichtenformat

Jedes Event wird als vier Block-Kit-Blöcke gerendert: emoji + title header, mrkdwn section body, optional ein actions-Button (wenn ein Deeplink vorhanden ist) und ein kleiner grauer context-Footer mit Event-Key und Zeitstempel.

{
  "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" }
      ] }
  ]
}

Fehlerbehebung

Schlägt die Installation fehl, leitet svdy nach /admin/integrations?integration_error=<code> zurück. Häufige Codes:

license_required

Der Organisationstarif liegt unter Starter (Slack) oder Professional (Teams / WeCom).

Upgrade in /admin/billing durchführen oder den Vertrieb kontaktieren.

state_expired_or_invalid

Das OAuth-State-Token ist abgelaufen (TTL 5 Min.) oder wurde gefälscht.

Erneut auf Connect Slack in /admin/integrations klicken.

provider_mismatch

Das OAuth-State wurde für einen anderen Provider erstellt als in der URL angegeben.

Höchstwahrscheinlich ein Angriff — ablehnen und neu installieren.

code_exchange_failed

Slack hat den Authorization-Code abgelehnt.

Trennen und neu verbinden. Bei dauerhaftem Problem support@svdy.com kontaktieren.

provider_error:access_denied

Der Admin hat im Slack-Autorisierungsdialog auf "Abbrechen" geklickt.

Erneut auf Connect Slack klicken und genehmigen.

Weitere Messaging-Anbieter

Slack nutzt OAuth, weil die Slack-API einen incoming-webhook-Scope bietet, der eine kanalgebundene URL zurückgibt. Microsoft und Tencent bieten keine Entsprechung — beide arbeiten mit einem URL-Einfügen-Modell: Sie erstellen einen Connector / Bot in der Plattform und fügen seine URL in svdy ein.

Microsoft Teams

Professional+

Verwenden Sie einen Power Automate Workflow mit HTTP-Trigger — Microsoft hat die Office-365-Connectors zum 2025-12-31 abgekündigt. Adaptive-Card-v1.5-Payload.

Akzeptierte Webhook-Hosts: *.webhook.office.com, *.logic.azure.com, *.azurewebsites.net.

WeCom (企业微信)

Professional+

Erstellen Sie einen Gruppen-Bot in WeCom (群机器人) und kopieren Sie dessen Webhook-URL. Markdown-Payload (Limit 4096 Byte).

Akzeptierter Host: qyapi.weixin.qq.com. Sowohl ein HTTP-Status außerhalb von 2xx als auch ein errcode ungleich null gelten als Fehler.

Bereit, Slack zu verbinden?

Öffnen Sie die Integrations-Seite in Ihrem Tenant und klicken Sie auf Connect — 30 Sekunden bis zur funktionierenden Installation. Die Tarif-Details sind einen Klick entfernt, falls Sie zuerst vergleichen möchten.

Connectors öffnen Tarife ansehen