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.
replace_payment_id einen unbenutzten Zahlungslink im selben Kunden-Workspace ersetzen.
Installieren und verbinden
- Öffnen Sie in Ihrer selbst gehosteten n8n-Instanz als Owner oder Administrator Settings → Community Nodes.
- Installieren Sie n8n-nodes-famulor oder aktualisieren Sie das vorhandene Paket. Diese Anleitung gilt für Version 2.3.0 oder neuer.
- Wählen Sie in Famulor den gewünschten Workspace und erstellen Sie unter Settings → API & MCP einen API-Key mit den benötigten Berechtigungen.
- 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.
- Fügen Sie eine Famulor-Aktion oder einen Famulor Polling Trigger hinzu und wählen Sie dieses Credential.
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.
Credentials
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 festenstart_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ütztenull-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ängerVorhandene 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 überGET /api/v1/calls und die Famulor CLI:
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.