---
title: "Slack"
description: "Benachrichtigungen in einen Slack-Kanal: eigene Slack-App anlegen, Incoming Webhooks aktivieren, Kanal wählen, Adresse in QuickTribe eintragen, testen – mit typischen Fehlern"
---

QuickTribe schickt Nachrichten über einen **Incoming Webhook** an Slack. Den Webhook legst du in einer eigenen, kleinen Slack-App an; das dauert etwa fünf Minuten. Jeder Webhook gehört zu genau einem Kanal.

## 1. Slack-App anlegen

1. Öffne [api.slack.com/apps](https://api.slack.com/apps) und melde dich mit deinem Slack-Konto an.
2. Klicke auf **Create New App** und wähle **From scratch**. Je nach Slack-Oberfläche kann die Beschriftung leicht abweichen (z. B. „Create an App“).
3. Gib einen **App Name** ein, zum Beispiel „QuickTribe“, wähle den Workspace und klicke **Create App**.

<Tip>
Name und Symbol, unter denen die Nachrichten in Slack erscheinen, legst du in der App unter **Basic Information → Display Information** fest. QuickTribe kann sie nicht überschreiben.
</Tip>

## 2. Incoming Webhooks aktivieren

1. Wähle links unter *Features* den Punkt **Incoming Webhooks**.
2. Stelle den Schalter **Activate Incoming Webhooks** auf **On**.
3. Klicke unten auf **Add New Webhook to Workspace**.
4. Wähle den Kanal, in den QuickTribe posten soll, und bestätige mit **Authorize** (in deutscher Oberfläche „Erlauben“ bzw. „Zulassen“). Für einen privaten Kanal musst du selbst Mitglied des Kanals sein.
5. Kopiere die Adresse unter **Webhook URLs for Your Workspace**. Sie sieht so aus: `https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX`.

Verlangt euer Workspace eine Freigabe neuer Apps, heißt der Knopf stattdessen **Request to Add New Webhook**. Dann schreibst du eine kurze Nachricht an die Workspace-Admins und sendest sie mit **Submit Request**; erst nach der Freigabe kannst du den Webhook anlegen.

<Note>
Die Webhook-Adresse ist ein Geheimnis: Wer sie kennt, kann in den Kanal posten. Gib sie nur in QuickTribe ein und nicht in Screenshots, Tickets oder Chats weiter.
</Note>

## 3. In QuickTribe eintragen

1. Öffne **Einstellungen → Integrationen** und klicke auf **Kanal hinzufügen** → **Slack**.
2. Gib einen **Namen** ein, zum Beispiel den Slack-Kanal „#team“.
3. Füge die kopierte Adresse unter **Webhook-Adresse** ein. QuickTribe akzeptiert nur Adressen von `hooks.slack.com` (bzw. `hooks.slack-gov.com` für GovSlack), die mit `/services/` beginnen.
4. Wähle die **Ereignisse**, die **Sprache** und die **Zeitzone** (siehe [Übersicht](/handbuch/owner/integrationen/uebersicht#optionen)) und klicke **Speichern**.
5. Klicke auf **Testnachricht senden**. In Slack erscheint eine Nachricht „Testnachricht“ mit Beispielfeldern; in QuickTribe steht „Testnachricht zugestellt“.

## So sieht eine Nachricht aus

Jede Nachricht besteht aus:

- einer **Überschrift** mit Symbol – 🔔 Information, ⏳ wartet auf das Team, ⚠️ Warnung – und dem Titel, z. B. „Neues Mitglied“,
- dem **Text**, z. B. „Anna Beispiel ist „Lauftreff Nord“ beigetreten.“,
- bis zu zehn **Feldern** (z. B. Plan, Preis, Endet am),
- einer **Fußzeile** mit Community-Name und Zeit in der gewählten Zeitzone,
- einem **Knopf** („Jetzt prüfen“, „Profil öffnen“ …), der die passende Seite in QuickTribe öffnet.

Namen und Titel aus der Community erscheinen immer als reiner Text: Sternchen, Unterstriche, spitze Klammern oder `@channel` in einem Anzeigenamen formatieren nichts und benachrichtigen niemanden. Link-Vorschauen sind ausgeschaltet.

## Kanal wechseln

Ein Slack-Webhook ist fest an seinen Kanal gebunden. Für einen anderen Kanal legst du in der Slack-App einen neuen Webhook an und trägst die neue Adresse in QuickTribe über **Bearbeiten** ein. Den alten Webhook kannst du danach in der App unter **Incoming Webhooks** entfernen.

## Typische Fehler

| Meldung in QuickTribe | Ursache | Lösung |
| --- | --- | --- |
| „Slack-Webhook-Adressen beginnen mit https://hooks.slack.com/services/ …“ | Falsche Adresse kopiert, z. B. ein Workflow-Link (`/triggers/…`) oder die Adresse der App-Seite | Die Adresse unter **Incoming Webhooks → Webhook URLs for Your Workspace** kopieren |
| Kanal **pausiert – Webhook existiert nicht mehr** | Slack antwortete mit 403, 404 oder 410: Webhook entfernt, App deinstalliert, Kanal archiviert oder gelöscht, Posten durch einen Admin eingeschränkt | Webhook neu anlegen, Adresse über **Bearbeiten** eintragen; oder den Kanal wiederherstellen und **Fortsetzen** |
| „Der Empfänger antwortet mit HTTP 400.“ | Slack hat die Nachricht abgelehnt (selten) | Testnachricht senden; bleibt der Fehler, das Zustellprotokoll an den Betreiber weitergeben |
| Privater Kanal fehlt in der Auswahl | Du bist kein Mitglied des Kanals | Erst dem Kanal beitreten, dann den Webhook anlegen |

Slack nimmt über einen Webhook etwa eine Nachricht pro Sekunde an. Kommen mehr Ereignisse auf einmal, antwortet Slack mit „zu viele Anfragen“; QuickTribe wartet dann die von Slack genannte Zeit ab und versucht es erneut.
