Skip to main content
Das Community-Paket n8n-nodes-famulor bietet 423 native Aktionen, 32 Polling-Ereignisse und fünf signierte Webhook-Ereignisse für die aktuelle Famulor-Workspace-API.

Famulor für n8n

Installationsanleitung, Veröffentlichungen und Quellcode des Connectors.

​
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.1.1 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. 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.

​
Signierte Buchungs-Webhooks

Für signierte Zustellungen verwenden Sie Famulor Trigger mit Famulor Webhook API-Credentials. Die Ereignisse sind booking.created, booking.cancelled, booking.rescheduled, call.completed und conversation.ended. Für Buchungen:
  1. Wählen Sie das Buchungsereignis im n8n-Trigger und kopieren Sie die Production URL.
  2. Bearbeiten Sie in Famulor den Buchungstyp und öffnen Sie Advanced → Webhook URL.
  3. Fügen Sie die URL ein und speichern Sie. Bei der ersten Einrichtung zeigt Famulor ein generiertes Webhook signing secret. Kopieren Sie es in das Feld Webhook Secret des n8n-Credentials.
  4. Aktivieren Sie den n8n-Workflow. Die Test URL verwenden Sie nur, während n8n auf ein Testereignis wartet; für den aktiven Workflow verwenden Sie die Production URL.
Der Trigger prüft die Signatur vor der Datenausgabe. Fehlende oder falsche Signaturen ergeben HTTP 401. Das gewählte Ereignis muss zur Zustellung passen. Der optionale Assistentenfilter gilt für Anruf- und Gesprächsereignisse.
Die URL unter Automations → Call completed beim Assistenten und die Gesprächsabschluss-URLs der Messaging-Connectoren senden unsignierte Ereignisse. Sie können diesen signierten Trigger nicht verwenden. Nutzen Sie dafür die Polling-Ereignisse, sofern noch keine signierte Zustellung eingerichtet ist. Eine Workspace-Seite Settings → Webhooks gibt es nicht.
Die Signatur allein verhindert keine erneute Zustellung desselben Ereignisses. Prüfen Sie Ereignis- oder Ressourcen-IDs vor Folgeaktionen. Der Connector ändert Famulor-Webhook-Ziele niemals automatisch. Siehe n8n-Webhook-Anleitung.

​
Vorhandene Workflows

Gespeicherte Aktions- und Webhook-Knoten der Version 2 behalten ihre Definitionen und Parameter. Neue Knoten verwenden Version 3. Wählen Sie beim Umstieg die native Aktion, ordnen Sie die Felder zu und testen Sie vor der Aktivierung. Verschieben Sie das Signierungsgeheimnis signierter Trigger in Famulor Webhook API-Credentials. Behalten Sie alte 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