Zum Hauptinhalt springen

Slack-Benachrichtigungen

Echtzeit-Benachrichtigungen in Slack für die wichtigsten Ereignisse: neues Feedback, Kampagnenstart, Budget-Schwellenwerte und Auszahlungsfehler.

Die Integration nutzt Slack Incoming Webhooks — Slacks Standard-Mechanismus (ohne OAuth). Nur-Schreibend von Slacks Seite (wir können posten, aber Ihre Kanäle nicht lesen), keine App-Freigabe erforderlich, funktioniert mit Slack Free.

Was Sie bekommen​

EreignisAuslöserInhalt der Nachricht
Neues FeedbackAntwort besteht das KI-ScoringKampagne, Qualitätsscore (0–100), Belohnungshöhe
Hochwertiges FeedbackScore ≥ 75Identisch + "💎"-Hervorhebung
Budget-WarnungKampagnen-Belohnungsbudget überschreitet 80 %Kampagne, Prozentsatz verbraucht
Kampagne aktiviertKampagne wechselt nach Stripe-Zahlung von DRAFT zu ACTIVEKampagne, Budget
AuszahlungsfehlerTremendous meldet einen Fehler bei der Reward-ZustellungResponse-ID, Fehlermeldung

Alle Benachrichtigungen sind fire-and-forget: Sollte Slack ausfallen, wird Ihr Feedback-Flow nicht beeinträchtigt — die Nachricht wird geloggt und übersprungen. Kein Retry, keine Queue.

Voraussetzungen​

  • Ein Slack-Workspace, in dem Sie Apps hinzufügen dürfen (meist alle Mitglieder, sofern nicht vom Admin eingeschränkt).
  • Ein Kanal (oder DM), in den die Benachrichtigungen geschickt werden sollen. Private Kanäle funktionieren auch.
  • Zwei Minuten Zeit.

Schritt 1 — Slack Incoming Webhook erstellen​

  1. Öffnen Sie api.slack.com/apps und klicken Sie auf Create New App.

  2. Wählen Sie From scratch. Nennen Sie die App "Pay4Feedback" und wählen Sie Ihren Workspace. Create App.

  3. In der linken Seitenleiste: Incoming Webhooks. Schalten Sie Activate Incoming Webhooks auf On.

  4. Scrollen Sie nach unten und klicken Sie auf Add New Webhook to Workspace.

  5. Wählen Sie den Kanal, der die Benachrichtigungen empfangen soll. Allow.

  6. Zurück auf der Incoming-Webhooks-Seite: kopieren Sie die URL unter Webhook URL. Sie sieht so aus:

    https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX
URL geheim halten

Wer diese URL besitzt, kann in Ihrem Kanal posten. Nicht in öffentliche Issue-Tracker, Screenshots oder clientseitigen Code einfügen. Bei Leak: in Slack löschen und neu erstellen.

Schritt 2 — In Pay4Feedback einfügen​

  1. Im Pay4Feedback-Dashboard: Einstellungen → Slack-Benachrichtigungen.
  2. Webhook-URL in das Feld Webhook URL einfügen.
  3. Schalter Aktiviert umlegen.
  4. Send test message klicken. Innerhalb weniger Sekunden sollte eine "👋 Test notification from Pay4Feedback"-Nachricht im gewählten Slack-Kanal erscheinen.
  5. Wenn der Test klappt: Save Integration klicken.

Bei Fehlern siehe Fehlersuche unten.

Schritt 3 — Erste Live-Benachrichtigung verifizieren​

Einfachster Test: Widget im Inkognito-Fenster öffnen und eine Antwort abschicken. Innerhalb von Sekunden nach erfolgreichem KI-Scoring erscheint eine "⭐ / 👌 / ⚠️ New feedback received"-Nachricht in Slack, mit Qualitätsscore und Belohnungshöhe.

Wenn die Test-Nachricht ankommt, aber echte Events nicht: prüfen Sie, ob Aktiviert wirklich an ist und gespeichert wurde.

Beispiel-Benachrichtigungen​

Neues Feedback (hohe Qualität):

⭐ New feedback received Campaign: Q2 Pricing Exit Survey Quality: 87/100 Reward: €8.70

Hochwertiges Feedback:

💎 High-value feedback! (Score: 92/100) Campaign: Q2 Pricing Exit Survey This feedback contains detailed reasoning.

Budget-Warnung:

💰 Budget alert Campaign: Q2 Pricing Exit Survey 82% of budget used. Consider increasing or pausing.

Kampagne aktiviert:

🚀 Campaign activated Q2 Pricing Exit Survey is now live and collecting feedback. Budget: EUR 500.00

Auszahlungsfehler:

❌ Payout failed Response: 7b0f... Error: Tremendous returned: recipient email invalid

Welchen Kanal verwenden?​

  • Kleines Team / eine Kampagne: dedizierter Kanal wie #pay4feedback-alerts.
  • Mehrere Kampagnen: Slack-Webhooks sind pro Kanal. Pay4Feedback speichert aktuell eine Webhook-URL pro Tenant, d.h. alle Benachrichtigungen landen in einem Kanal. Kanal-Routing pro Kampagne steht auf der Roadmap — melden Sie sich bei sales@pay4feedback.com, wenn Sie das brauchen.
  • Zu laut? Budget-Warnungen und Auszahlungsfehler sind selten; der lauteste Stream ist "neues Feedback". Bei 10+ Approvals/Tag ist es üblich, die Kanalbenachrichtigungen stumm zu schalten und den Log sichtbar zu lassen.

Fehlersuche​

"URL doesn't look like a Slack Incoming Webhook"​

Der Test-Endpunkt prüft, ob die URL mit https://hooks.slack.com/ beginnt. Häufige Fehler:

  • Sie haben die Workspace-URL kopiert statt der Webhook-URL. Zurück zu Incoming Webhooks und gezielt die Webhook URL kopieren.
  • URL wurde beim Einfügen abgeschnitten. Die volle URL ist über 80 Zeichen lang und enthält nach /services/ drei Segmente.

"Slack responded with HTTP 404"​

Die Webhook-URL existiert nicht mehr. Gründe:

  • Slack-App wurde gelöscht oder Webhook entfernt.
  • URL wurde verkürzt.

Löschen Sie den Wert in Pay4Feedback, erstellen Sie einen neuen Webhook (Schritt 1 oben), einfügen, testen.

"Slack responded with HTTP 403"​

Slack lehnt die Anfrage ab — normalerweise: der Kanal wurde nach dem Install gelöscht oder privat gemacht. Neuen Webhook erstellen, aktiven Kanal wählen.

Test-Nachricht kommt an, echte Benachrichtigungen aber nicht​

  • Ist der Schalter Aktiviert wirklich an? URL und Schalter sind unabhängig — beide müssen gesetzt sein.
  • Haben Sie Save Integration geklickt? Der Test-Endpunkt speichert automatisch, der Haupt-Save-Button aktiviert nicht automatisch.
  • Speziell für "neues Feedback": die Benachrichtigung feuert nur, wenn Feedback das KI-Scoring besteht (Score ≥ Ablehnungsschwelle, Standard 30). Völlig unbrauchbare Antworten werden stumm abgelehnt. Reichen Sie eine Antwort mit einem echten Absatz Text ein.

Benachrichtigungen hörten nach einiger Zeit auf​

  1. Hat Slack den Webhook rotiert oder widerrufen? api.slack.com/apps → Ihre App → Incoming Webhooks. Wenn weg, URL tot. Neu erstellen, einfügen.
  2. Hat ein Workspace-Admin die Pay4Feedback-App entfernt? Gleiche Seite — falls entfernt, sind alle Webhooks ungültig.

Test-Button ist ausgegraut​

Der Button ist deaktiviert, solange das URL-Feld leer ist. Erst einfügen, dann testen.

Deaktivieren​

Schalter Aktiviert aus in Einstellungen → Slack-Benachrichtigungen, dann Save Integration. Die URL bleibt gespeichert für spätere Reaktivierung. Um sie komplett zu entfernen: Feld leeren und speichern.

Auch seitens Slack sauber widerrufen: api.slack.com/apps → Pay4Feedback → Manage Distribution → Remove App.

Sicherheit​

  • Die Webhook-URL liegt in der tenant_settings-Tabelle, at-rest verschlüsselt durch AWS RDS (AES-256) zusammen mit allen anderen Tenant-Daten.
  • Nur Nutzer mit Admin- oder Owner-Rolle Ihres Tenants können die URL in den Einstellungen sehen oder ändern.
  • Alle ausgehenden Webhook-Calls nutzen HTTPS mit TLS 1.2+.
  • Pay4Feedback loggt die Webhook-URL niemals im Klartext — nur Tenant-ID und Zustell-Status.

Verwandt​