Zum Hauptinhalt springen
Das Community-Paket n8n-nodes-famulor bietet 533 native Aktionen, 32 Polling-Ereignisse und fünf signierte Webhook-Ereignisse für die aktuelle Famulor-Workspace-API.

Famulor auf n8n

Öffnen Sie den offiziellen n8n-Integrationseintrag und die Einrichtungshinweise.

n8n-nodes-famulor auf npm

Paket und Veröffentlichungen für selbst gehostete n8n-Instanzen.
Quellcode und Release Notes des Connectors finden Sie auf GitHub. Ab Version 2.5.0 kannst du mit Create Platform Custom Payment und dem optionalen Feld replace_payment_id einen unbenutzten Zahlungslink im selben Kunden-Workspace ersetzen.

Installieren und verbinden

  1. Öffnen Sie in Ihrer selbst gehosteten n8n-Instanz als Owner oder Administrator Settings → Community Nodes.
  2. Installieren Sie n8n-nodes-famulor oder aktualisieren Sie das vorhandene Paket. Diese Anleitung gilt für Version 2.3.0 oder neuer.
  3. Wählen Sie in Famulor den gewünschten Workspace und erstellen Sie unter Settings → API & MCP einen API-Key mit den benötigten Berechtigungen.
  4. Erstellen Sie in n8n ein Credential vom Typ Famulor API und geben Sie den API-Key ein. Der Host wird automatisch gewählt; eine Base URL müssen Sie nicht eingeben. Bereits gespeicherte Verbindungshosts werden weiterhin unterstützt.
  5. Fügen Sie eine Famulor-Aktion oder einen Famulor Polling Trigger hinzu und wählen Sie dieses Credential.
Der Key bestimmt den Workspace. Famulor prüft API Access, Berechtigungen, verfügbare Funktionen und Credits. Speichern Sie den Key in den n8n-Credentials; bei der Erstellung wird er nur einmal angezeigt.
Der n8n-Verzeichniseintrag kann einen anderen Connector-Stand zeigen. n8n Cloud unterstützt verifizierte Community Nodes; die npm-Installation ist auf selbst gehosteten Instanzen verfügbar. Fehlen die unten beschriebenen nativen Aktionen, aktualisieren Sie den Connector, sofern unterstützt, oder verwenden Sie das HTTP-Request-Beispiel.
Siehe n8n-Installationsanleitung.

Credentials

Persönliche Aktionen wie Account → Get low-credit warning preferences benötigen ein nutzergebundenes Credential. Ein Service-Account-Key ist auch mit allen Berechtigungen keinem Nutzer zugeordnet. Verwalten Sie persönliche Guthabenwarnungen bei solchen Keys in den Famulor-Einstellungen. Account → Get current credential zeigt Credential-Typ und Workspace.

Native Aktionen

Fügen Sie Famulor hinzu, wählen Sie Resource → Operation und füllen Sie die Pflichtfelder aus. Die Aktionen umfassen Assistenten, Anrufe, Kampagnen, Kontakte, Telefonnummern, SMS, Gespräche, Wissen, Buchungen, Tools, Automationen, Missionen, Stimmen, Widgets, Einstellungen und Workspace-Verwaltung. Ab Version 2.7.0 akzeptiert Bookings → Permanently delete bookings die IDs beendeter oder stornierter nativer Buchungen. Prüfen Sie die IDs vor der Ausführung. Das Ergebnis führt gelöschte und übersprungene IDs getrennt auf. Ab Version 2.9.0 startet Campaigns → Launch a campaign eine Kampagne im Entwurf sofort oder zu einem festen start_at. Setzen Sie compliance_attestation auf true, um zu bestätigen, dass die Kampagne alle Gesetze und Einwilligungsregeln für ihre Kontakte einhält, und übernehmen Sie sequence_hash unverändert aus Get a campaign, damit der Start abbricht, wenn sich die Anrufsequenz geändert hat. Außerdem gibt es Pause a campaign, Resume a campaign, Cancel a campaign’s schedule und Get campaign analytics sowie App-Aktions-Tools, US-Do-not-Call-Prüfungen und Cal.com-Konten mit Ereignistypen. Gespeicherte Start a campaign-Nodes senden weiterhin keinen Body. Als ersten Lesetest verwenden Sie Account → Get current credential oder Calls → List calls. Fügen Sie bei der Anrufliste unter Optional Fields das Feld Limit mit dem Wert 10 hinzu.
  • Referenzen unterstützen From List und By ID. IDs können aus vorherigen Schritten übernommen werden.
  • Optionale Felder werden erst nach dem Hinzufügen gesendet. Explizite Werte wie false, 0, leere Arrays, leere Texte und unterstützte null-Werte bleiben erhalten.
  • Listen liefern ein n8n-Item pro Datensatz. Weitere Seiten rufen Sie über Limit und Offset ab. Audiovorschauen liefern Binärdaten.
  • Jedes Eingabe-Item führt einen Request aus. Schreibaktionen werden nicht automatisch wiederholt. Calls → Start an outbound call, SMS, Käufe und andere Schreibaktionen führen echte Vorgänge aus und können Credits verbrauchen.

Polling-Trigger

Fügen Sie Famulor Polling Trigger hinzu und wählen Sie Ihr Famulor API-Credential, Ereignis und Zeitplan. Ereignisse für Kampagnen-Leads benötigen zusätzlich eine Kampagnen-ID. Die 32 Optionen umfassen Anrufe, Gespräche, Kontakte, Kampagnen und Leads, Assistenten, Nummern, Wissen, Tools, Automationen, Missionen, Segmente, Sperrlisten, Buchungen und Rückrufe. Für abgeschlossene Anrufe wählen Sie Phone Call Completed, für abgeschlossene Messaging-Gespräche Conversation Completed. Die erste aktive Abfrage setzt einen Ausgangsstand und liefert keine historischen Datensätze. Manuelle Tests liefern aktuelle Beispiele, ohne den aktiven Ausgangsstand zu verändern. Ein bei der Aktivierung bereits laufender Anruf kann nach seinem Ende noch ein Abschlussereignis auslösen. Polling prüft beobachtete Datensätze und Statuswerte. Ein Statuswechsel zwischen zwei Abfragen kann übersehen werden. Zeitbasierte Quellen lesen ein Fenster von zehn Minuten erneut und entfernen Duplikate; noch später sichtbar werdende Datensätze können fehlen. Verwenden Sie Ereignis- oder Ressourcen-IDs, um doppelte Folgeaktionen zu vermeiden. Große Bestandslisten benötigen mehr API-Abfragen; fehlgeschlagene oder unvollständige Scans verändern den Polling-Stand nicht.

Bisherige manuelle Empfänger

Gespeicherte Webhook-Nodes der Versionen 2 und 3 behalten ihre Parameter und den manuellen Modus. Neue Action-Nodes verwenden Version 3; neue Webhook-Nodes Version 4 mit automatischer Registrierung. Hinterlege für die Umstellung Workspace-API-Key und Signatur-Secret und wähle Automatic Subscription. Behalte bisherige Credentials, bis alle abhängigen Workflows umgestellt sind. Bisherige manuelle Empfänger

Vorhandene Workflows

Gespeicherte Webhook-Nodes der Versionen 2 und 3 behalten ihre Parameter und den manuellen Modus. Neue Action-Nodes verwenden Version 3; neue Webhook-Nodes Version 4 mit automatischer Registrierung. Hinterlege für die Umstellung Workspace-API-Key und Signatur-Secret und wähle Automatic Subscription. Behalte bisherige Credentials, bis alle abhängigen Workflows umgestellt sind.

Alternative mit HTTP Request

Fügen Sie HTTP Request hinzu und wählen Sie Authentication → Generic Credential Type → Header Auth. Speichern Sie den Header-Wert in einem Credential. Verwenden Sie anschließend das data-Array der Antwort. Dieser Request liest Anrufe. Siehe n8n-HTTP-Request-Dokumentation.

Fehler beheben

  • 401: gespeicherten API-Key oder beim Webhook-Trigger das Signierungsgeheimnis prüfen.
  • 403: Berechtigungen, Workspace-Zugriff und Funktionsfreigaben prüfen. Persönliche Aktionen benötigen zusätzlich nutzergebundene Credentials.
  • 402: Workspace-Credits und Plan-Zugriff prüfen.
  • Keine Polling-Ausgabe: der Ausgangsstand überspringt alte Datensätze; Ereignis und Kampagne prüfen.
  • Keine Webhook-Ausgabe: URL, Testbereitschaft oder aktiven Workflow, Ereignis und Assistentenfilter prüfen.

API und CLI

Dieselbe Anrufliste erhalten Sie über GET /api/v1/calls und die Famulor CLI:
Die API-Referenz erklärt Authentifizierung und Aktionen.

Weitere Integrationen

Shopify-Widget-Auswahl im Theme

Mit Connector 2.3.0 oder neuer wählst du Shopify → Read Shopify widget choices oder Shopify → Synchronize Shopify widget choices und den verbundenen Shop. Diese Aktionen sind in den oben beschriebenen 485 nativen Aktionen enthalten. Die öffentliche Namensveröffentlichung ist standardmäßig aus. Synchronisieren aktiviert sie ausdrücklich und veröffentlicht geeignete Namen als öffentliche Shopify-Storefront-Daten, ohne zusätzliche Shopify-Berechtigungsanfrage. Hintergrundaktualisierungen behalten diese Freigabe bei. Wähle das Widget und speichere das Theme in Shopify. Die Synchronisierung aktiviert kein Theme. Ausschalten ist über die im Shopify-App-Leitfaden beschriebene Konfiguration möglich. Beide Aktionen benötigen Workspace-Owner-/Admin-Zugriff und Assistants: Read. Lesen benötigt zusätzlich Integrations: Read, Synchronisieren Integrations: Write. Fehlen die Aktionen im installierten Connector, nutze einen HTTP-Request-Node mit derselben gespeicherten Header-Auth-Verbindung: POST benötigt keinen Body. Die CLI-Befehle sind famulor get-shopify-widget-picker STORE_ID und famulor synchronize-shopify-widget-picker STORE_ID. Passende MCP-Tools und SDK-Methoden stehen im Shopify-App-Leitfaden. Die Shop-Auswahlliste benötigt zusätzlich Integrations: Read. Nutze By ID, wenn deine Synchronisierungsverbindung nur Schreibzugriff auf Integrationen hat.

Eigene KI-Avatare

Unter Avatars kannst du den Erstellungspreis lesen, den Foto-Upload vorbereiten, ihn mit ausdrücklicher Zustimmung einreichen und den Status prüfen. Erstellen und Löschen erfordern einen benutzergebundenen Workspace-API-Key. Übertrage die Fotodaten mit einem HTTP-Request-Node an die zurückgegebene signierte URL, ohne Famulor-Zugangsdaten für diesen Upload. Verwende bei einer unklaren Antwort dieselbe Avatar-ID weiter. Die einmalige Erstellung wird getrennt von der laufenden Nutzung berechnet; eine gespeicherte Auto-Topup-Regel kann greifen. Den vollständigen API-, CLI- und SDK-Ablauf findest du unter KI-Avatar.

Signierte Webhook-Abonnements

Neue Famulor-Trigger-Nodes ab Paket 2.3.0 registrieren automatisch. Hinterlege Workspace-API-Key und Signatur-Secret in Famulor Webhook API, wähle ein Ereignis und aktiviere den Workflow. Die Deaktivierung entfernt nur das eigene Abonnement. Gespeicherte Version-2/3-Nodes bleiben manuell, bis du ausdrücklich Automatic Subscription auswählst. Bestehende Ziele von Assistants, Connectors und Buchungen bleiben erhalten. Signierte Webhook-Abonnements

Firmenabsender und RCS

Ab Community-Paket 2.6.0 enthält SMS Firmenabsender-Anträge, Statusaktualisierung, Markenbilder-Uploads und Versand über eine SMS-Verbindung. Bestehende Send SMS-Nodes behalten ihr Nummernfeld; Zustellungsmodus, Rich Content und SMS-Ersatztext sind optional. Send SMS from a connection unterstützt auch Firmenabsender ohne Nummer. SMS-Konversationsereignisse enthalten RCS-Aktivität. Aktualisiere das Paket nach Veröffentlichung; npm-Veröffentlichung und n8n-Verzeichnisfreigabe sind getrennt. Ab 2.8.0 zeigt List company senders for SMS and RCS die verfügbaren Empfängerländer, den Vorschlag des Workspaces und die Länder, deren Einrichtung noch aussteht. Gib im Feld Countries beim Erstellen oder Bearbeiten eines Entwurfs einen oder mehrere verfügbare Ländercodes ein. Book company sender setup kann zusätzlich den Änderungszeitpunkt des geprüften Entwurfs übernehmen, um parallele Änderungen zu erkennen.