Zum Inhalt springen

Leitfaden

Integrationen im Überblick: API, Webhooks und Zapier

Automatisierungen & Integrationen · 4 Min. Lesezeit

Mateflow verbindet deine Community auf drei Wegen mit anderen Tools: über verbundene Apps (Slack, Discord und Zapier), über Webhooks an deinen eigenen Server und über die Open API für Entwickler. Alle drei findest du auf einer einzigen Admin-Seite, Admin → Einstellungen → Integrationen.

Wer kann das tun: Inhaber und Administratoren. · Wo: Web (Admin-Konsole). · Tarif: Webhooks, API-Zugang und das tägliche Limit für API-Anfragen hängen von deinem Plattform-Tarif ab.

Integrationen in der Admin-Konsole finden

Gehe zu Admin → Einstellungen → Integrationen. Die Seite heißt Integrationen & API und hat vier Tabs:

Tab Was du dort tust
Integrationen Slack, Discord oder Zapier unter Verbundene Apps verbinden
Webhooks Community-Ereignisse an deinen eigenen Endpunkt senden
API-Zugang API-Schlüssel erstellen und widerrufen und die Entwicklerdokumentation öffnen
Zustellprotokolle Jede Anfrage prüfen, die Mateflow an deine Webhooks, Apps und Automatisierungsregeln gesendet hat

Slack, Discord oder Zapier verbinden

Verbundene Apps übertragen Community-Ereignisse wie neue Mitglieder, Beiträge oder Zahlungen an einen anderen Dienst:

  • Slack: postet Nachrichten über eine Incoming-Webhook-URL in einen Channel.
  • Discord: postet Nachrichten über eine Discord-Webhook-URL in einen Channel. Es sendet nur Nachrichten; Mitglieder und Rollen werden nicht synchronisiert.
  • Zapier: sendet Ereignisse an einen Zapier Catch Hook, sodass ein Zap sie an Tausende andere Apps weitergeben kann.

Um eine App zu verbinden, öffne den Tab Integrationen und klicke auf Slack verbinden, Discord verbinden oder Zapier verbinden. Füge die Webhook-URL aus diesem Dienst ein, wähle unter Zu übertragende Ereignisse die gewünschten Ereignisse aus, füge optional einen Signaturschlüssel (optional) hinzu und klicke auf Verbinden. Klicke dann auf Testereignis senden, um sicherzugehen, dass Nachrichten ankommen.

Eine verbundene Karte zeigt, welche Ereignisse sie überträgt. Über ihr Menü kannst du Einstellungen bearbeiten, Testereignis senden oder Trennen wählen.

Ereignisse mit Webhooks an deinen eigenen Server senden

Webhooks senden eine HTTPS-Anfrage an einen Endpunkt, den du kontrollierst, sobald ein ausgewähltes Ereignis eintritt, zum Beispiel Mitglied beigetreten, Mitglied zu Zugriffsgruppe hinzugefügt, Beitrag erstellt oder Zahlung erhalten. Jeder Webhook hat eigene Ereignisse, einen optionalen Signaturschlüssel und einen Schalter Aktiv. Webhooks und die Anzahl, die du erstellen kannst, hängen von deinem Plattform-Tarif ab. Siehe Webhooks einrichten.

Mit der Open API eine eigene Integration bauen

Mit der Open API kann ein Entwickler die Daten deiner Community aus eigenem Code lesen und schreiben: Beiträge, Spaces und Mitglieder lesen, Beiträge erstellen, Medien hochladen und Personen einladen. Jeder API-Schlüssel gehört zu genau einer Community, und du wählst seine Berechtigungen (Scopes), wenn du ihn erstellst. API-Schlüssel werden nicht im Creator-Dashboard (app.mateflow.com) verwaltet; dessen Community-Seite Übersicht verlinkt stattdessen auf diese Admin-Seite.

Über die API gesendete Einladungen können Zugriffsgruppen enthalten, die die Person erhält, wenn sie die Einladung annimmt. Siehe So funktionieren Zugriffsgruppen.

Die vollständige API-Referenz findest du unter mateflow.com/developers. Klicke im Tab API-Zugang auf Dokumentation öffnen, um dorthin zu gelangen, und schicke den Link an deinen Entwickler; er braucht kein Konto in deiner Community. Siehe API-Schlüssel erstellen.

Ausgehende Anfragen in den Zustellprotokollen prüfen

Der Tab Zustellprotokolle listet ausgehende Anfragen auf, die deine Webhooks, verbundenen Apps und Automatisierungsregeln mit Trigger webhook gesendet haben. Filtere nach Ereignistyp, Ergebnis und Datum und klicke auf Details anzeigen, um die vollständige Anfrage und Antwort zu sehen. Zustellprotokolle werden 30 Tage lang aufbewahrt. Fehlgeschlagene Webhook-Zustellungen werden automatisch erneut versucht; es gibt keine Schaltfläche, um eine Zustellung selbst erneut zu senden.

Anfragen, die mit deinen API-Schlüsseln gestellt werden, werden hier nicht protokolliert. Der Tab API-Zugang zeigt stattdessen für jeden Schlüssel das Datum Zuletzt verwendet.

Verwandte Artikel

War dieser Leitfaden hilfreich?

Zurück zu den Leitfäden

Sie finden nicht, was Sie brauchen?

Wenn Sie Mitglied einer Community sind, helfen Ihnen deren Admins weiter. Wenn Sie eine Community auf Mateflow aufbauen oder betreiben, hilft Ihnen unser Team.

Kostenlos starten