Ein Chat-Webhook lässt externe Dienste automatisierte Nachrichten in einen ISO Mate-Kanal posten. Ein Kanal-Admin aktiviert den Webhook in den Kanaleinstellungen, kopiert die Webhook-URL, und externe Tools senden dann eine POST-Anfrage mit einem kleinen JSON-Body, um eine Nachricht zu veröffentlichen. Ideal für Build-Benachrichtigungen, Monitoring-Warnungen und Statusaktualisierungen aus anderen Systemen.
Einen Kanal-Webhook aktivieren
- Öffnen Sie Chat in der Gruppe Allgemein der Seitenleiste und wählen Sie den Kanal.
- Öffnen Sie Kanaleinstellungen über die Kopfzeile des Kanals (nur Admins) und gehen Sie zum Tab Webhook.
- Schalten Sie Webhook aktiviert ein.
- Verwenden Sie URL kopieren, um die Webhook-URL für Ihren externen Dienst zu kopieren.
Eine Nachricht per Webhook posten
Senden Sie eine POST-Anfrage an die Webhook-URL mit einem JSON-Body. Nur der Nachrichtentext ist erforderlich, und Sie können Anzeigenamen und Avatar des postenden Bots festlegen.
POST /api/chat/webhook/{token}
Content-Type: application/json
{
"text": "Hallo von meiner Integration!",
"username": "Mein Bot",
"icon_url": "https://example.com/bot-avatar.png"
}Payload-Felder
- text: der Nachrichteninhalt, erforderlich, bis zu 4000 Zeichen.
- username: ein optionaler Anzeigename für den Bot, bis zu 100 Zeichen.
- icon_url: eine optionale Avatar-URL für den Bot.
So gepostete Nachrichten erscheinen im Kanal als Webhook gekennzeichnet, mit dem von Ihnen angegebenen Bot-Namen. Der Einstellungsdialog enthält außerdem ein cURL-Beispiel, das Sie zum schnellen Testen kopieren können.
Häufige Anwendungsfälle
- Build-Benachrichtigungen: posten Sie Ergebnisse der CI- und CD-Pipeline, etwa Erfolg oder Fehlschlag.
- Monitoring-Warnungen: leiten Sie Warnungen aus externen Monitoring-Tools weiter.
- Statusaktualisierungen: senden Sie automatisierte Updates von Drittanbieterdiensten.
Den Token neu generieren
Falls ein Webhook-Token möglicherweise offengelegt wurde, verwenden Sie Token neu generieren im Webhook-Tab. Die Neugenerierung macht die aktuelle Webhook-URL ungültig, aktualisieren Sie daher anschließend Ihre externen Dienste mit der neuen URL. Zum Verwalten des Kanals selbst siehe Team-Chat-Kanäle verwenden.
Automatisieren Sie die Updates Ihres Teams im Chat. Starten Sie Ihre kostenlose 14-tägige Testversion.