> ## Documentation Index
> Fetch the complete documentation index at: https://docs.famulor.io/llms.txt
> Use this file to discover all available pages before exploring further.

# N8N Integration

> Verbinde Famulor mit N8N - Die open-source Alternative zu Famulor Automation für flexible, selbst-gehostete Workflows mit unserem offiziellen N8N-Node

# N8N Integration

**Open-Source Alternative zu Famulor Automation**: Falls du die native Famulor Automation Platform nicht nutzen möchtest, bietet N8N eine leistungsstarke, open-source Alternative für die Automatisierung deiner Workflows.

Verbinde Famulor nahtlos mit **N8N** durch unseren offiziellen N8N-Node. Automatisiere Workflows zwischen deiner KI-Telefonie-Plattform und über **400 verfügbaren Nodes** - von CRM-Systemen bis hin zu selbst entwickelten APIs.

<Card title="Offizieller Famulor N8N-Node" icon="github" href="https://github.com/bekservice/n8n-famulor">
  Installiere unseren offiziellen N8N-Node direkt von GitHub
</Card>

## Wann solltest du N8N wählen?

<CardGroup cols={2}>
  <Card title="✅ N8N verwenden wenn" icon="check-circle" color="green">
    * du open-source Lösungen bevorzugst
    * du vollständige Kontrolle über deine Daten wünschst
    * du eigene Nodes entwickeln möchtest
    * du kostenlosen, selbst-gehosteten Betrieb benötigst
    * du komplexe, verzweigte Workflows erstellen willst
    * du bereits N8N für andere Integrationen nutzt
  </Card>

  <Card title="⚡ Famulor Automation verwenden wenn" icon="wand-magic-sparkles" color="blue">
    * du eine gehostete, wartungsfreie Lösung wünschst
    * du sofort ohne Setup beginnen möchtest
    * du native Famulor-Features bevorzugst
    * du die volle Integration ins Famulor-Ökosystem willst
    * du direkten Support von Famulor benötigst
  </Card>
</CardGroup>

## N8N vs. Famulor Automation Platform

Beiden Lösungen haben ihre spezifischen Stärken. Hier ist ein detaillierter Vergleich:

| Feature                      | N8N                                 | Famulor Automation              |
| ---------------------------- | ----------------------------------- | ------------------------------- |
| **Setup-Komplexität**        | ⚠️ Erfordert Installation & Hosting | ✅ Sofort verfügbar, kein Setup  |
| **Verfügbare Integrationen** | ✅ 400+ Nodes + Custom Nodes         | ⚠️ Begrenzte Auswahl            |
| **Workflow-Komplexität**     | ✅ Sehr komplex, erweiterte Logik    | ✅ Verzweigt, komplexe Logik     |
| **Kosten**                   | ✅ Open-Source, kostenlos            | ✅ Kostenlos enthalten           |
| **Hosting**                  | ⚠️ Selbst-gehostet erforderlich     | ✅ Vollständig gemanagt          |
| **Custom Code**              | ✅ JavaScript/Python/SQL Support     | ✅ JavaScript/Python Support     |
| **Datenkontrolle**           | ✅ Vollständige Datenkontrolle       | ⚠️ Famulor-gehostet             |
| **Community**                | ✅ Große Open-Source-Community       | ✅ Direkte Famulor-Unterstützung |

### Praktische Anwendungsfälle für N8N

**✅ Ideal für N8N:**

* **Custom Workflows**: Komplexe, mehrstufige Automatisierungen
* **Datenverarbeitung**: Erweiterte Datenmanipulation und -transformation
* **API-Integrationen**: Verbindung zu beliebigen REST/GraphQL APIs
* **Datenschutz**: Vollständige Kontrolle über deine Daten
* **Enterprise-Integration**: Integration in bestehende IT-Infrastruktur

**⚡ Besser mit Famulor Automation:**

* **Schneller Start**: Sofort ohne Installation loslegen
* **Wartungsfrei**: Keine Server-Wartung oder Updates erforderlich
* **Native Features**: Tiefe Integration in Famulor-Features
* **Support**: Direkter Support vom Famulor-Team
* **Einfachheit**: Plug-and-Play ohne technische Komplexität

## Installation des Famulor N8N-Nodes

<Steps>
  <Step title="N8N-Installation">
    Falls noch nicht installiert, installiere N8N:

    ```bash theme={null}
    npm install n8n -g
    ```
  </Step>

  <Step title="Famulor-Node installieren">
    Klone unser Repository und installiere den Node:

    ```bash theme={null}
    git clone https://github.com/bekservice/n8n-famulor.git
    cd n8n-famulor
    npm install
    npm run build
    ```
  </Step>

  <Step title="Node zu N8N hinzufügen">
    Kopiere den gebauten Node in dein N8N-Custom-Nodes-Verzeichnis oder verwende npm link
  </Step>

  <Step title="N8N neu starten">
    Starte N8N neu, damit der neue Node erkannt wird
  </Step>
</Steps>

<Note>
  **Tipp**: Detaillierte Installationsanweisungen findest du in der [README des GitHub-Repositories](https://github.com/bekservice/n8n-famulor).
</Note>

## Architektur-Übersicht

Die N8N-Integration ermöglicht bidirektionale Kommunikation zwischen Famulor und beliebigen Anwendungen über selbst-gehostete N8N-Instanzen.

```mermaid theme={null}
graph TB
    subgraph "Ihre Infrastruktur"
        A[N8N Instance]
        B[Custom Nodes]
        C[Webhook Endpoints]
        D[Datenbank]
    end
    
    subgraph "Famulor System"
        E[API Gateway]
        F[Webhook Service]
        G[Integration Database]
    end
    
    subgraph "Externe APIs"
        H[CRM APIs]
        I[Database APIs]
        J[Custom APIs]
        K[Cloud Services]
    end
    
    A --> B
    B --> C
    A --> D
    C --> E
    E --> F
    F --> G
    
    A --> H
    A --> I
    A --> J
    A --> K
    
    E --> A
```

## Verfügbare Trigger

Der Famulor N8N-Node unterstützt folgende Trigger-Events:

### Anruf-basierte Trigger

| Trigger              | Beschreibung         | Payload-Felder                                                     |
| -------------------- | -------------------- | ------------------------------------------------------------------ |
| `call_started`       | KI-Anruf begonnen    | `caller_id`, `assistant_id`, `phone_number`, `timestamp`           |
| `call_completed`     | KI-Anruf beendet     | `duration`, `transcript`, `caller_id`, `assistant_id`, `timestamp` |
| `call_failed`        | Anruf fehlgeschlagen | `caller_id`, `error_reason`, `timestamp`                           |
| `voicemail_received` | Voicemail empfangen  | `caller_id`, `duration`, `audio_url`, `timestamp`                  |

### SMS-basierte Trigger

| Trigger        | Beschreibung  | Payload-Felder                                   |
| -------------- | ------------- | ------------------------------------------------ |
| `sms_received` | SMS empfangen | `sender`, `message`, `phone_number`, `timestamp` |
| `sms_sent`     | SMS versendet | `recipient`, `message`, `status`, `timestamp`    |

## Verfügbare Actions

Der N8N-Node unterstützt auch Actions für ausgehende Operationen:

### KI-Assistant Actions

| Action             | Beschreibung                     | Erforderliche Felder                      |
| ------------------ | -------------------------------- | ----------------------------------------- |
| `make_call`        | Ausgehenden Anruf starten        | `phone_number`, `assistant_id`, `context` |
| `send_sms`         | SMS versenden                    | `phone_number`, `message`                 |
| `create_assistant` | Neuen KI-Assistenten erstellen   | `name`, `prompt`, `voice_id`              |
| `update_assistant` | Assistenten-Konfiguration ändern | `assistant_id`, `prompt`, `settings`      |

### Lead-Management Actions

| Action        | Beschreibung                     | Erforderliche Felder             |
| ------------- | -------------------------------- | -------------------------------- |
| `create_lead` | Neuen Lead erstellen             | `phone_number`, `name`, `source` |
| `update_lead` | Lead-Informationen aktualisieren | `lead_id`, `data`                |
| `get_lead`    | Lead-Informationen abrufen       | `lead_id` oder `phone_number`    |

## Authentifizierung & Sicherheit

Der N8N-Node implementiert robuste Sicherheitsmaßnahmen:

* **API-Key-Authentifizierung**: Sichere Verbindung mit deinem Famulor-Account
* **Webhook-Signatur-Verifizierung**: Verifizierung aller eingehenden Webhooks
* **HTTPS-Verschlüsselung**: Alle Datenübertragungen sind verschlüsselt
* **Rate Limiting**: Schutz vor API-Missbrauch

## Beliebte Workflow-Beispiele

### CRM-Synchronisation

```mermaid theme={null}
flowchart LR
    A[Call Completed] --> B[Extract Lead Data]
    B --> C[Check CRM for Existing Contact]
    C --> D{Contact Exists?}
    D -->|No| E[Create New Contact]
    D -->|Yes| F[Update Existing Contact]
    E --> G[Add Call Notes]
    F --> G[Add Call Notes]
```

### Lead-Qualifizierung

```mermaid theme={null}
flowchart LR
    A[Call Completed] --> B[Analyze Transcript]
    B --> C{Positive Intent?}
    C -->|Yes| D[Mark as Qualified Lead]
    C -->|No| E[Mark as Cold Lead]
    D --> F[Send to Sales Team]
    E --> G[Add to Nurture Campaign]
```

### Multi-Channel-Follow-up

```mermaid theme={null}
flowchart LR
    A[Call Completed] --> B[Wait 1 Hour]
    B --> C[Send Follow-up SMS]
    C --> D[Wait 24 Hours]
    D --> E[Send Email Summary]
    E --> F[Create Calendar Reminder]
```

## Erweiterte Konfiguration

### Webhook-Konfiguration

```json theme={null}
{
  "webhook_url": "https://your-n8n.domain.com/webhook/famulor",
  "secret": "your-webhook-secret",
  "events": [
    "call_completed",
    "call_started",
    "sms_received"
  ]
}
```

### Custom Node Development

Der Famulor N8N-Node ist erweiterbar. Du kannst eigene Nodes für spezifische Anwendungsfälle entwickeln:

```javascript theme={null}
import {
  IExecuteFunctions,
  INodeType,
  INodeTypeDescription,
} from 'n8n-workflow';

export class FamulorCustom implements INodeType {
  description: INodeTypeDescription = {
    displayName: 'Famulor Custom',
    name: 'famulor-custom',
    group: ['transform'],
    version: 1,
    description: 'Custom Famulor integration',
    // ... weitere Konfiguration
  };
}
```

## Best Practices

### Performance-Optimierung

* Verwende Webhook-Filter um unnötige Trigger zu vermeiden
* Implementiere Batch-Verarbeitung für hochvolumige Workflows
* Nutze N8Ns Queue-Mode für ressourcenintensive Operationen

### Sicherheit

* Verwende starke Webhook-Secrets
* Implementiere IP-Whitelisting wenn möglich
* Logge sensible Daten nicht in N8N-Logs

### Monitoring

* Nutze N8Ns integriertes Monitoring
* Implementiere Health-Checks für kritische Workflows
* Richte Alerts für fehlgeschlagene Executions ein

## Warum N8N eine ausgezeichnete Alternative ist

### 🔓 Vollständige Kontrolle

N8N ist open-source und selbst-gehostet. Du behältst die vollständige Kontrolle über deine Daten und Workflows.

### 🛠️ Unendliche Erweiterbarkeit

Mit der Möglichkeit, eigene Nodes zu entwickeln, bist du nicht auf vorgefertigte Integrationen beschränkt.

### 💰 Kosteneffizient

Keine monatlichen Gebühren - nur deine Hosting-Kosten. Ideal für Unternehmen mit hohem Workflow-Volumen.

### 🎯 Perfekt für Entwickler

N8N bietet alle Tools, die Entwickler benötigen: Code-Nodes, Git-Integration, und vollständige API-Kontrolle.

### 🏢 Enterprise-Ready

Self-hosted Deployment, RBAC, und Integration in bestehende IT-Landschaften.

<Warning>
  **Wichtiger Hinweis**: N8N erfordert technisches Know-how für Installation, Wartung und Betrieb. Für einfache Workflows ohne technische Ressourcen ist die Famulor Automation Platform oft die bessere Wahl.
</Warning>

## Support und Ressourcen

<CardGroup cols={2}>
  <Card title="N8N-Node auf GitHub" icon="github" href="https://github.com/bekservice/n8n-famulor">
    Quellcode, Dokumentation und Issues des offiziellen Famulor N8N-Nodes
  </Card>

  <Card title="N8N Dokumentation" icon="book" href="https://docs.n8n.io/">
    Offizielle N8N-Dokumentation für erweiterte Workflows
  </Card>

  <Card title="Famulor Automation Platform" icon="wand-magic-sparkles" href="/de/automation-platform/introduction">
    Vergleiche mit unserer nativen Automatisierungsplattform
  </Card>

  <Card title="Support kontaktieren" icon="life-ring" href="mailto:support@famulor.io">
    Benötigst du Hilfe mit der Integration? Kontaktiere uns
  </Card>
</CardGroup>

## Contribution & Community

Unser N8N-Node ist open-source und wir freuen uns über Beiträge:

* **Bug Reports**: Melde Probleme über GitHub Issues
* **Feature Requests**: Schlage neue Features vor
* **Pull Requests**: Trage Code-Verbesserungen bei
* **Dokumentation**: Hilf bei der Verbesserung der Docs

<Note>
  Folge unserem [GitHub-Repository](https://github.com/bekservice/n8n-famulor) für Updates und neue Features.
</Note>

***

**Fazit**: N8N ist eine ausgezeichnete Alternative zur Famulor Automation Platform, besonders wenn du vollständige Kontrolle über deine Workflows und Daten wünschst. Für Entwickler und Enterprise-Umgebungen bietet N8N unschlagbare Flexibilität und Anpassungsmöglichkeiten.

<Tip>
  Passende Seiten: [Introduction](/de/automation-platform/introduction) und [Building Flows](/de/automation-platform/building-flows) und [Debugging Runs](/de/automation-platform/debugging-runs).
</Tip>