# 19. Oktober 2026

> 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](#personliche-api-schlussel-mit-berechtigungen-pro-modul)
- [Webhooks in Integrationen & APIs](#webhooks-in-integrationen-apis)
- [Fertige Integrationen: Discord, Slack, Telegram, RD Station, HubSpot und Abkürzungen zu Zapier, Make und n8n](#fertige-integrationen)

## 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](/configuracoes/integracoes-e-apis).

![Einstellungen › Integrationen & APIs › Neuer Schlüssel](/screens/integracoes-nova-chave.png "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](/configuracoes/integracoes-e-apis#webhooks).

![Einstellungen › Integrationen & APIs › Webhooks › Neuer Webhook](/screens/integracoes-novo-webhook.png "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](/membros/registros-de-atividades#api-schlussel).

## 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](/integracoes/integracoes-prontas).

![Einstellungen › Integrationen & APIs › Integrationen](/screens/integracoes-apps.png "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](/configuracoes/integracoes-e-apis#einen-webhook-bearbeiten).
- **Neue Sicherheitskontrollen.**
- **Website:** Die Seite Plattform auf [memberfy.net](https://memberfy.net/plataforma#integracoes) 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](/api/autenticacao#chave-de-api).
- 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](/api/respostas-e-erros#fehler-des-api-schlussels).
- 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](/api/referencia/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](/api/referencia) 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](/api/webhooks).
- [Webhook-Ereignisse](/api/eventos-de-webhook): die aus dem öffentlichen Katalog `GET /api/integrations/events` erzeugte Referenz, mit dem JSON Schema jedes Ereignisses.
- [Feste IPs](/api/ips-fixos): `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](/api/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](/api/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](/mcp/ferramentas-comunidade#list-integrations).
- `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?](/mcp/receitas#73-welche-api-schlussel-habe-ich), [Welche Schlüssel der Community sind aktiv?](/mcp/receitas#74-welche-schlussel-der-community-sind-aktiv) und [Was hat der n8n-Schlüssel gemacht?](/mcp/receitas#75-was-hat-der-n8n-schlussel-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?](/mcp/receitas#76-fallt-eine-app-oder-ein-webhook-aus).