Webhooks und Benachrichtigungen: Webhook (ausgehend), Slack, Discord und Telegram

Ohne die Integration geht keine Benachrichtigung raus: Die Automation, die den Kanal nutzt, stellt nichts zu, und die Aktion der App wird mit dem Hinweis abgelehnt, dass der Kanal in dieser App nicht eingerichtet ist.

Bevor Sie anfangen

• Tarif: Slack und Discord funktionieren in jedem Tarif, auch im Free. Telegram und Webhook (ausgehend) verlangen den Tarif Builder, und bei ihnen wird der Tarif bei jedem Versand geprüft: Verlässt das Konto den Builder, hören sie auf;
• Kosten: Webhooks und Bots bei diesen Diensten anzulegen ist kostenlos. Jeder Versand der App verbraucht Integrations-Credits, und zwar nur, wenn das Ziel annimmt;
• Die Webhook-Adresse ist ein Passwort. Wer die URL eines Slack- oder Discord-Webhooks hat, kann in Ihrem Kanal posten. Veröffentlichen Sie die URL nirgendwo.

Alle liegen im Tab Integrationen: Slack, Discord und Telegram in der Kategorie Benachrichtigungen, Webhook (ausgehend) in Automatisierung.

Slack

Feld der Karte: Incoming Webhook URL.

1. legen Sie in api.slack.com/apps eine App in Ihrem Workspace an;
2. aktivieren Sie unter Incoming Webhooks die Funktion und klicken Sie auf Add New Webhook to Workspace;
3. wählen Sie den Kanal, der die Benachrichtigungen empfangen soll, und autorisieren Sie;
4. kopieren Sie die erzeugte URL (sie beginnt mit https://hooks.slack.com/services/);
5. fügen Sie auf der Karte Slack die URL ein und klicken Sie auf Speichern und aktivieren.

Jeder Slack-Webhook postet in genau einen Kanal. Für einen anderen Kanal legen Sie einen weiteren Webhook an.

Discord

Felder der Karte: Webhook URL, Bot Token (für DMs an Nutzer) und Server-Einladung (optional).

Für Benachrichtigungen in einem Kanal ist nur die Webhook URL nötig:

1. öffnen Sie in Discord die Servereinstellungen → Integrationen → Webhooks;
2. klicken Sie auf Neuer Webhook, wählen Sie den Kanal und kopieren Sie die Webhook-URL;
3. fügen Sie auf der Karte Discord die URL ein und klicken Sie auf Speichern und aktivieren.

Direktnachricht an die Nutzer der App

Damit die App eine Direktnachricht (DM) an Menschen schickt, die die App nutzen, und nicht in einen Kanal, sind drei Dinge nötig:

1. ein Bot, angelegt in discord.com/developers/applications, mit dem Token in Bot Token (für DMs an Nutzer);
2. die Anmeldung mit Discord, aktiv im Tab Authentifizierung: Sie verknüpft die Person in der App mit ihrem Discord-Konto;
3. die Person hat sich mit Discord in der App angemeldet.

Wer sich nicht mit Discord angemeldet hat, erhält die Benachrichtigung statt der DM innerhalb der App.

Telegram

Feld der Karte: Bot token.

Was die App tut: Sie schickt über Ihren Bot eine Nachricht an einen Chat, eine Gruppe oder einen Kanal in Telegram.

1. öffnen Sie in Telegram ein Gespräch mit @BotFather und senden Sie /newbot;
2. wählen Sie Namen und Benutzernamen des Bots. BotFather antwortet mit dem Token (etwa 123456:ABC-DEF…);
3. fügen Sie auf der Karte Telegram den Token ein und klicken Sie auf Speichern und aktivieren;
4. fügen Sie den Bot der Gruppe oder dem Kanal hinzu, die die Nachrichten empfangen sollen. In einem Kanal muss er Administrator sein. In einem privaten Gespräch muss die Person das Gespräch mit dem Bot vorher begonnen haben.

Zum Senden braucht die App die Chat-ID des Ziels. Geben Sie sie im Chat des Assistenten zusammen mit Ihrer Bitte an.

Webhook (ausgehend)

Feld der Karte: Ziel-URL.

Was die App tut: Sie schickt einen POST mit den Daten als JSON an die URL, die Sie eingetragen haben. So verbinden Sie die App mit jeder eigenen Automation: einem Zap bei Zapier, einem Szenario bei Make, einem Flow in n8n oder einer eigenen Adresse.

1. legen Sie im Automationsdienst einen Auslöser vom Typ Webhook an und kopieren Sie die URL, die er erzeugt;
2. fügen Sie sie auf der Karte Webhook (ausgehend) unter Ziel-URL ein und klicken Sie auf Speichern und aktivieren;
3. sagen Sie im Chat, was die App senden soll und wann (zum Beispiel „wenn eine Bestellung angelegt wird, sende die Bestellung an den Webhook“).

Zwei Regeln auf der anderen Seite:

• die URL muss öffentlich sein. Adressen im internen Netz werden abgelehnt;
• das Ziel muss mit Erfolg (Code 2xx) antworten. Jede andere Antwort, auch eine Weiterleitung, zählt als Fehlschlag, und Fehlschläge werden nicht berechnet.

Testen

Diese Karten testen die Zugangsdaten beim Speichern nicht: Verbunden bedeutet, dass gespeichert wurde. Die URL lässt sich testen, noch bevor die App beteiligt ist.

Slack oder Discord, direkt von Ihrem Computer: Führen Sie in einem Terminal den Befehl unten aus und ersetzen Sie die URL. Im Kanal sollte eine Nachricht erscheinen.

# Slack
curl -X POST -H "Content-Type: application/json" -d '{"text":"Test"}' "IHRE_SLACK_URL"

# Discord
curl -X POST -H "Content-Type: application/json" -d '{"content":"Test"}' "IHRE_DISCORD_URL"

Über die App: Bitten Sie im Chat um einen Testknopf, der die Benachrichtigung auslöst (das verbraucht KI-Credits, wie jedes Bauen). Nutzen Sie den Knopf und prüfen Sie den Kanal, die Gruppe oder den Verlauf des Automationsdienstes. Schlägt es fehl, enthält der angezeigte Fehler die Antwort des Ziels.

Häufige Probleme

• curl funktioniert, aber die App sendet nicht. Prüfen Sie, ob Sie dieselbe URL in die Karte eingefügt haben und ob das Guthaben an Integrations-Credits nicht aufgebraucht ist;
• Webhook (ausgehend) schlägt mit „destino recusou“ (Ziel hat abgelehnt) fehl. Der Zieldienst hat mit einem Fehler oder einer Weiterleitung geantwortet. Sehen Sie sich den Code in der Meldung und den Verlauf des Dienstes an;
• „webhook_url inválida ou aponta para rede interna“ (ungültig oder zeigt auf ein internes Netz). Die URL ist nicht öffentlich (lokale Adresse, interne IP). Verwenden Sie die öffentliche URL des Dienstes;
• Telegram stellt nicht zu. Der Bot ist nicht in der Gruppe, ist nicht Administrator des Kanals, oder die Person hat nie ein Gespräch mit ihm begonnen. Prüfen Sie auch die Chat-ID;
• Die Discord-DM landet als Benachrichtigung in der App. Die Person hat sich nicht mit Discord in der App angemeldet, oder die Anmeldung mit Discord ist nicht aktiv;
• Die URL eines Webhooks ist nach außen gelangt. Löschen Sie den Webhook in Slack oder Discord, legen Sie einen neuen an und fügen Sie die neue URL in die Karte ein. Bei Telegram erzeugen Sie mit /revoke bei @BotFather einen neuen Token.