---
title: "Integrationen"
description: "Plattform-Kanäle für Slack, Mattermost oder einen Webhook: neue Communities, fehlgeschlagene Hintergrundjobs, nicht verarbeitete Stripe-Ereignisse und Wartungsmodus an das Betriebsteam"
---

Unter **Plattform-Admin → Integrationen** (`/admin/integrations`) richtest du Kanäle für Ereignisse der **ganzen Installation** ein – etwa für das Betriebsteam. Die Bedienung ist dieselbe wie bei den Integrationen einer Community (siehe [Integrationen – Übersicht](/handbuch/owner/integrationen/uebersicht)): Kanaltyp wählen, Adresse eintragen, Ereignisse wählen, Testnachricht, Zustellprotokoll, Pausieren und Fortsetzen. Es gibt bis zu **10** Plattform-Kanäle; sie sind von den Kanälen der Communities getrennt.

Nur Plattform-Admins sehen und verwalten Plattform-Kanäle. Owner sehen sie nicht, auch nicht in ihren Einstellungen.

## Ereignisse

| Ereignis | `event` | Bedeutung | `data` im allgemeinen Webhook |
| --- | --- | --- | --- |
| **Neue Community** | `platform.community_created` | Jemand hat eine Community angelegt. Nennt den Owner (außer bei „Ohne Namen“) und verlinkt auf die Landingpage. | `communityId`, `ownerUserId` |
| **Fehlgeschlagene Hintergrundjobs** | `platform.jobs_failed` | Stündliche Prüfung: In der Fehlerwarteschlange liegen mehr Einträge als bei der letzten Prüfung. Meldet höchstens einmal je Stunde und nie für einen unveränderten Stand. | `total`, `new`, `mails` |
| **Stripe-Ereignis nicht verarbeitet** | `platform.stripe_webhook_failed` | Ein Stripe-Ereignis ließ sich auch nach allen Versuchen nicht verarbeiten und liegt in der Fehlerwarteschlange. | `stripeEventId`, `stripeEventType`, `communityId` (falls zuzuordnen) |
| **Wartungsmodus geändert** | `platform.maintenance_changed` | Der Wartungsmodus wurde im Plattform-Admin oder auf der Konsole ein- oder ausgeschaltet. | `enabled`, `userId` (Plattform-Admin, falls bekannt) |

Fehlgeschlagene Hintergrundjobs prüfst du anschließend mit `bin/console messenger:failed:show` (siehe [Konsole](/handbuch/plattform-admin/konsole)). Das Schema der Nachrichten und die Signaturprüfung beschreibt [Allgemeiner Webhook](/handbuch/owner/integrationen/webhook).

## Pausierte Plattform-Kanäle

Pausiert ein Plattform-Kanal (Webhook gelöscht oder 5 Fehlschläge in Folge), gibt es keine Glocke – Plattform-Kanäle gehören zu keiner Community. Stattdessen erscheint in der [Übersicht](/handbuch/plattform-admin/admin-bereich#übersicht-und-systemstatus) unter **Systemstatus** der Hinweis „Integration „…“ ist pausiert.“ mit Link zum Fortsetzen. Pausieren, Fortsetzen und alle Änderungen stehen im [Protokoll](/handbuch/plattform-admin/protokoll).

## Interne Ziele

Ein Mattermost oder n8n im internen Netz erreicht QuickTribe nur, wenn der Host in [`APP_INTEGRATION_ALLOWED_HOSTS`](/konfiguration#integrationen) freigegeben ist.
