Zum Inhalt springen

Releases

Integrationen & APIs kommt in die Einstellungen, mit persönlichen API-Schlüsseln, damit dein CRM, n8n oder ein Skript die API mit Berechtigungen pro Modul aufruft, und Webhooks, die diese Systeme benachrichtigen, sobald jemand beitritt, kauft, abonniert, sich für eine Veranstaltung anmeldet oder einen Kurs abschließt. Und die fertigen Integrationen sind da: Discord, Slack, Telegram, RD Station und HubSpot sind mit wenigen Klicks eingeschaltet. Die Plattform hat außerdem neue Sicherheitskontrollen.

Um die Community mit einem anderen System zu verbinden, braucht es kein eigenes Konto mehr: Jede Person erstellt ihren eigenen Schlüssel, kreuzt an, was er darf, und widerruft ihn, wann sie will. Und umgekehrt benachrichtigt die Community deine Systeme jetzt von selbst.

Persönliche API-Schlüssel mit Berechtigungen pro Modul

Was es ist. Ein Schlüssel, mit dem ein CRM, eine Automatisierung (n8n, Zapier, Make) oder ein Skript die API der Community in deinem Namen aufruft, ohne Anmeldung. Beim Erstellen kreuzt du Modul für Modul an, was er darf: lesen, erstellen und bearbeiten und löschen und destruktive Aktionen. Ohne Häkchen kann der Schlüssel nichts, und er geht nie über das hinaus, was deine Rolle erlaubt.

Warum es wichtig ist. Bisher brauchte eine Integration ein eigenes Mitglied, mit E-Mail und Passwort im fremden System gespeichert und mit der ganzen Macht seiner Rolle. Jetzt kann der Schlüssel nur, was du freigegeben hast, er kann ein Ablaufdatum und eine IP-Liste haben und hört in dem Moment auf zu funktionieren, in dem er widerrufen wird. Geld (Erstattung, Auszahlung, Checkout, Karte), das Konto (Passwort, Anmeldung, E-Mail, Telefon) und die Verwaltung der eigenen Schlüssel bleiben für jeden Schlüssel unerreichbar.

Wo es ist. Eigentümer und Administrator: Einstellungen, Tab Integrationen & APIs. Die anderen Rollen: Integrationen & APIs im Kontomenü, unter Abrechnung.

So fängst du an.

  1. Klicke auf Neuer Schlüssel, gib einen Namen ein und kreuze nur die Module und Spalten an, die die Integration braucht.
  2. Wenn du willst, setze ein Ablaufdatum und die IPs des Servers, der aufrufen wird.
  3. Kopiere den Schlüssel sofort: Er erscheint nur ein einziges Mal.

Beispiel. Rafael, Administrator, erstellt den Schlüssel CRM mit lesen bei Mitglieder und bei Verkäufe und Abonnements, gebunden an die IP des CRM-Servers. Das CRM holt die neuen Abonnenten jetzt von selbst. Eigentümer und Administrator sehen alle Schlüssel der Community unter Alle der Community, können jeden widerrufen und verfolgen die Aufrufe des Monats im Block Nutzung. Siehe Integrationen & APIs.

Einstellungen › Integrationen & APIs › Neuer Schlüssel
Die 28 Module und die drei Spalten: lesen, erstellen und bearbeiten, löschen und destruktive Aktionen.

Webhooks in Integrationen & APIs

Was es ist. Benachrichtige dein CRM, Zapier, Make oder n8n, wenn jemand beitritt, kauft, abonniert, sich für eine Veranstaltung anmeldet oder einen Kurs abschließt. Du hinterlegst die Ziel-URL, wählst die Ereignisse (13, in 6 Familien), und Memberfy sendet eine signierte Benachrichtigung, sobald es passiert.

Warum es wichtig ist. Bisher musste das externe System die API immer wieder fragen, um von einem Kauf oder einem neuen Mitglied zu erfahren. Jetzt kommt die Benachrichtigung von selbst, mit Name und E-Mail der Person, und die Tabelle, das CRM oder die Gruppe des Teams sind in Sekunden aktuell. Fällt das Ziel aus, versucht Memberfy es fast zwei Tage lang weiter und schaltet den Webhook aus, wenn es nicht zurückkommt, mit einer E-Mail.

Wo es ist. Einstellungen, Tab Integrationen & APIs, Tab Webhooks. Eigentümer und Administrator.

So fängst du an.

  1. Klicke auf Neuer Webhook, füge die URL ein, die Zapier, Make oder n8n dir gegeben hat, und kreuze die Ereignisse an (die ganze Familie oder einzeln).
  2. Kopiere das Secret: Es wird nur einmal angezeigt, und damit prüft das Ziel, dass die Benachrichtigung von Memberfy kommt.
  3. Klicke auf Test senden und sieh dir die Antwort des Ziels an.

Beispiel. Julia, Eigentümerin, verbindet die Familie Käufe mit einem Zapier-Trigger. Jeder abgeschlossene Kauf wird zu einer Nachricht im Kanal des Teams. Im Bereich Zustellungen des Webhooks sieht sie jede Sendung mit der Antwort des Ziels und sendet erneut, was fehlgeschlagen ist. Akzeptiert die Firewall des Ziels nur bekannte Adressen, lässt die Option Von festen IPs senden die Zustellungen von zwei Memberfy-IPs kommen. Siehe Integrationen & APIs › Webhooks.

Einstellungen › Integrationen & APIs › Webhooks › Neuer Webhook
Die Ziel-URL, die Ereignisse nach Familie und der Hinweis zu personenbezogenen Daten.

Außerdem neu: Der Block Nutzung zählt jetzt die im Monat zugestellten Webhooks, und die Seite Verwaltung › Logs bekommt den Typ API-Schlüssel mit allem, was die Schlüssel getan haben. Siehe Logs › API-Schlüssel.

Fertige Integrationen

Was es ist. Fertige Integrationen: Discord, Slack, Telegram, RD Station, HubSpot und Abkürzungen zu Zapier, Make und n8n. Du wählst die App, fügst ihre Zugangsdaten ein, markierst die Ereignisse und schaltest sie ein. Ohne Automatisierung dazwischen und ohne Code.

Warum es wichtig ist. Bisher brauchte es einen Webhook und eine selbst gebaute Automatisierung, um das Team in Slack über jeden Kauf zu informieren oder neue Mitglieder ins CRM zu bringen. Jetzt kommt die Nachricht im Kanal an („Maria hat Karriere-Mentoring gekauft.“, nur mit dem Vornamen, in der Sprache der Community), der Lead erscheint in RD Station mit der Conversion, und der HubSpot-Kontakt bekommt den Deal für Kauf und Verlängerung, ohne Duplikate.

Wo es ist. Einstellungen, Tab Integrationen & APIs, Tab Integrationen. Eigentümer und Administrator.

So fängst du an.

  1. Klicke auf die Karte der App und folge der Anleitung „So verbindest du …“, um URL, Token oder Schlüssel beim Anbieter zu erzeugen.
  2. Füge sie ein, markiere die Ereignisse und bestätige, was die App empfängt.
  3. Klicke auf Einschalten und dann auf Test senden.

Beispiel. Júlia schaltet Telegram ein: Sie erstellt den Bot in BotFather, fügt ihn der Team-Gruppe hinzu und nutzt Meine Gruppe finden. Bei jeder Event-Anmeldung bekommt die Gruppe „Maria hat sich für Oktober-Treffen angemeldet.“. Ausschalten pausiert und behält die Konfiguration; Integration entfernen löscht Zugangsdaten und Zustellverlauf. Fällt der Anbieter 72 Stunden lang aus, wird die App ausgeschaltet und Eigentümer und Administratoren erhalten eine E-Mail. Siehe Fertige Integrationen.

Einstellungen › Integrationen & APIs › Integrationen
Eine Karte pro App, mit dem, was sie empfängt, und ihrem Status.

Verbesserungen

  • Webhooks bearbeiten. Bisher musste man für eine neue URL, andere Ereignisse oder feste IPs einen neuen Webhook anlegen und den alten löschen. Jetzt haben die Details Bearbeiten, ohne das Secret zu ändern: Laufende Zustellungen gehen weiter an das alte Ziel, eine neue URL setzt die Fehler zurück, und Bearbeiten schaltet nicht wieder ein. Siehe Einen Webhook bearbeiten.
  • Neue Sicherheitskontrollen.
  • Website: Die Seite Plattform auf memberfy.net bekommt den Abschnitt Integrationen & APIs, der die fertigen Integrationen als verfügbar zeigt, und die Startseite sowie die Seiten Für Communities, Für HR und Für Coworkings erwähnen ihn mit Beispielen.

Für Entwickler

API

  • API-Schlüssel (X-Api-Key) statt des Tokens, immer mit dem X-CommunityId der Community des Schlüssels; zusammen mit Authorization gibt es 400. Der Schlüssel handelt als sein Inhaber, und die effektive Berechtigung ist der Bereich (<Modul>:<Stufe>, 28 Module, read/write/delete) und gleichzeitig dessen aktuelle Rolle. Auf einer öffentlichen Route läuft ein Schlüssel ohne den Bereich anonym weiter. Siehe Authentifizierung › API-Schlüssel.

  • Limit von 120 Aufrufen pro Minute pro Person in jeder Community, summiert über ihre Schlüssel, mit 429 und Retry-After. Erlaubte IPs pro Schlüssel (bis zu 20, IPv4, IPv6 oder CIDR).

  • Fehler mit stabilem code: API_KEY_SCOPE_MISSING, API_KEY_BLOCKED, API_KEY_ROUTE_NOT_COVERED, API_KEY_IP_NOT_ALLOWED, API_KEY_RATE_LIMITED, API_KEY_WITH_AUTHORIZATION und API_KEY_PATH_INVALID. Siehe Antworten und Fehler.

  • Routen /api/integrations/api-keys (auflisten, erstellen, ansehen, umbenennen und IPs ändern, widerrufen, Nutzung) und /api/integrations/usage, nur mit dem Anmelde-Token. Siehe API-Referenz › Integrations.

  • Die Spezifikation bekommt das Schema apiKey, und jede Operation sagt, welchen Bereich der Schlüssel braucht oder dass sie keinen Schlüssel akzeptiert; die Referenz zeigt das neben API-Schlüssel.

  • GET /api/activity-logs bekommt die Herkunft apiKeys: Schlüssel erstellt, umbenannt, mit geänderten IPs, widerrufen, und jedes Schreiben mit einem Schlüssel („über den Schlüssel {Name}“).

  • Webhooks (Standard Webhooks): der Umschlag (id, type, version, occurredAt, community, data), die 13 Ereignisse und der ping, die Signatur webhook-id/webhook-timestamp/webhook-signature mit Node-Beispiel (standardwebhooks), Deduplizierung über die webhook-id und keine garantierte Reihenfolge. 8 Versuche (1 Min., 5 Min., 30 Min., 2 Std., 6 Std., 12 Std., 24 Std., etwa 45 Std.); 410 schaltet sofort aus; 72 Std. ohne Erfolg schalten aus, mit E-Mail an Eigentümer und Administratoren; 429 beachtet Retry-After und zählt nicht als Fehler. Nur https auf Port 443, keine Weiterleitung, 10 s. Siehe Webhooks.

  • Webhook-Ereignisse: die aus dem öffentlichen Katalog GET /api/integrations/events erzeugte Referenz, mit dem JSON Schema jedes Ereignisses.

  • Feste IPs: 3.227.95.35 und 34.199.138.158, zum Freigeben in der Firewall.

  • Verwaltung unter https://developers.memberfy.net/api/webhooks (Anmelde-Token von Eigentümer oder Administrator, nie ein API-Schlüssel). Erstellen, Test senden, wieder einschalten, erneut senden und URL ändern teilen sich ein Limit von 10 pro Minute pro Community; bis zu 10 Webhooks pro Community.

  • Webhook bearbeiten: PATCH /api/webhooks/{id} (url, description, events, fixedIps, nur was sich ändert). Gilt für spätere Ereignisse; laufende Zustellungen behalten ihr Ziel; eine neue URL setzt failureCount zurück; schaltet nicht wieder ein; Verlaufszeile updated mit Vorher und Nachher. Siehe Webhooks › Einen Webhook bearbeiten.

  • Fertige Integrationen: /api/apps unter https://developers.memberfy.net (Katalog, PUT/DELETE der Installation, mit ?remove=true zum Entfernen, Test, POST /api/apps/telegram/chats, Zustellungen und erneutes Senden), mit demselben Token von Eigentümer oder Administrator. Siehe Webhooks › Fertige Integrationen.

  • GET /api/logs akzeptiert type=apiKeys, mit actor.via = api_key bei Aufrufen mit Schlüssel.

MCP: technische Details

  • list_integrations (neu, nur lesen, jede Rolle): scope: mine (Standard) listet deine Schlüssel; scope: community (Eigentümer und Administrator) listet die aller, mit member_id und status. Die Bereiche kommen mit den Namen aus der Oberfläche; das Geheimnis nie. Kein Erstellen, Bearbeiten oder Widerrufen von Schlüsseln über den Assistenten. Siehe Werkzeuge · Community.
  • list_activity_logs nimmt source: apiKeys an, und die Community-Liste in list_integrations schlägt diese Abfrage in next_steps vor.
  • Neue Rezepte: Welche API-Schlüssel habe ich?, Welche Schlüssel der Community sind aktiv? und Was hat der n8n-Schlüssel gemacht?. Der Server hat jetzt 445 Tools.
  • list_integrations zeigt Eigentümer und Administrator auch die Webhooks (type: webhooks oder ohne type): Status, Fehler in Folge, die letzte Zustellung und, wenn er fehlschlägt, die letzten fehlgeschlagenen Zustellungen. Nur lesend: Einen Webhook erstellen, testen, erneut senden und löschen geht nur in der Oberfläche; die vollständige URL und das Secret kommen nie mit.
  • list_logs akzeptiert type: apiKeys.
  • list_integrations mit type: apps (oder ohne type), für Eigentümer und Administrator: jede je eingeschaltete App, mit Status, Ereignissen, Fehlern in Folge, letzter erfolgreicher Zustellung und den letzten fehlgeschlagenen Zustellungen; die Konfiguration kommt nie mit. Kein Einschalten, Testen oder Ausschalten von Apps über den Assistenten. Neues Rezept: Fällt eine App oder ein Webhook aus?.

Per Feed abonnieren (Atom)