Skip to main content
Öffne Einstellungen → Workspace → Datenmigration, um ein Famulor-1.0-Konto mit seinem API-Key zu verbinden. Der Key wird nur während der Vorschau oder des Imports verwendet. Er wird weder gespeichert noch geloggt, gecacht oder zurückgegeben. Alternativ kannst du Milian sagen: „Ziehe meine Assistenten aus Famulor 1.0 um“. Milian zeigt eine sichere Autorisierungskarte. Nach einem Klick auf Famulor 1.0 autorisieren öffnet sich die OAuth-Seite von Famulor 1.0 und kehrt danach in denselben Milian-Dialog zurück. Milian:
  1. liest die verfügbaren Migrations-Tools über den Famulor-1.0-MCP-Endpunkt,
  2. zeigt Assistenten, Automatisierungen, Kampagnen, Tools und Wissensdatenbanken als Vorschau,
  3. fragt nach „alles“ oder konkreten Quell-IDs/-Namen und ob alle zugehörigen Tools und Wissensdatenbanken enthalten sein sollen und
  4. importiert nur die ausdrücklich bestätigte Auswahl.
OAuth-Access- und Refresh-Tokens sind verschlüsselt, an den Workspace gebunden und werden serverseitig erneuert. Sie erscheinen nie im Milian-Dialog.

​
Mit deinem Famulor 1.0 Konto anmelden

Falls du bereits ein Famulor-1.0-Konto hast, kannst du dich direkt auf der Hauptdomain dieser Plattform mit deiner alten E-Mail-Adresse und deinem alten Passwort anmelden — eine separate Registrierung ist nicht nötig. Beim ersten Login wird hier automatisch ein passendes Konto angelegt (ein Platform-Root-Workspace). Danach benötigt die 1-Klick-Migration keinen eingefügten API-Key mehr: Öffne Einstellungen → Workspace → Datenmigration und klicke im Schritt „Connect“ auf Mit meinem Famulor-1.0-Konto verbinden. Es läuft dieselbe Vorschau und derselbe Import wie im API-Key-Ablauf ab — nur authentifiziert über deinen Login statt über einen eingefügten Key.
Plattform-Admins aktivieren diese Login-Bridge, indem sie die Umgebungsvariable FAMULOR_V1_WHITELABEL_ADMIN_KEY auf den White-Label-Admin-API-Key von app.famulor.de setzen. Dieser Key bleibt ausschließlich serverseitig und wird nie an den Client weitergegeben. Ohne ihn ist die Bridge deaktiviert und der Connect-Schritt fällt auf den reinen API-Key-Ablauf zurück. Die Bridge funktioniert nur auf der Hauptdomain der Plattform — nie auf White-Label-Reseller-Domains —, antwortet bei jedem Fehler neutral (sie verrät nie, ob auf einer der beiden Plattformen ein Konto existiert) und ist ratenbegrenzt.

​
Ressourcen-Verknüpfungen und Tool-Migration

  • In Famulor 1.0 am Assistenten hinterlegte Built-in-Tools werden als eigene Einträge in der zentralen Tools-Bibliothek angelegt und nur dem jeweiligen Quell-Assistenten zugewiesen. Das umfasst Auflegen, Kalt-/Warmweiterleitung, DTMF-/Tastenfeld-Erfassung und Assistenten-Weiterleitung. Ziele einer Assistenten-Weiterleitung werden erst aufgelöst, nachdem alle ausgewählten Assistenten angelegt wurden; dadurch bleiben auch Vorwärtsverweise erhalten. DTMF- und Tastenfeld-Erfassung sind auf der neuen Plattform flowgebunden: Die Migration legt sie an und weist sie zu; vor der Ausführung muss jedoch der passende DTMF- oder Collect-Knoten im Flow Builder platziert werden.
  • Ausgewählte eigene HTTP-Mid-Call-Tools werden ebenfalls zentral angelegt. Die Lese-API von Famulor 1.0 liefert diese Tools kontoweit, jedoch ohne die tool_ids-Verknüpfungen zu Assistenten. Deshalb wird jedes ausgewählte eigene Tool allen Assistenten zugewiesen, die im selben Lauf importiert werden.
  • Eine calendar_integration mit verwendbaren Cal.com-Zugangsdaten (API-Key und Event-Type-ID) wird als native Kalenderintegration angelegt und ihrem Quell-Assistenten zugewiesen, statt sie zusätzlich als Built-in-Tool zu duplizieren. Kalendereinträge für andere Anbieter (zum Beispiel Calendly) oder Cal.com-Einträge ohne verwendbare Zugangsdaten werden nicht importiert — verbinde diesen Kalender nach dem Import manuell unter Integrationen. Calendly selbst wird auf der neuen Plattform nativ über eine eigene OAuth-Verbindung unterstützt; dafür ist kein API-Key nötig.
  • Ausgewählte Wissensdatenbank-Hüllen werden vor den Assistenten angelegt. Verweist ein Assistent auf eine davon, wird die neue Wissensdatenbank-ID automatisch am Assistenten gespeichert. Famulor 1.0 liefert keine Dokumentinhalte; diese müssen weiterhin neu hinzugefügt werden.
  • Famulor-1.0-Assistenten mit dualplex werden im Modus Half-cascade importiert.
  • Die Vorschau listet für jeden Assistenten die einzelnen Built-in-Tool-Konfigurationen (Weiterleitung, DTMF, Auflegen usw.) in seinen Details auf, damit du vor dem Import genau siehst, was angelegt wird.
Falls der Tarif des Quellkontos keine Automatisierungen enthält, kann die Quell-API nur für diese Ressourcenfamilie HTTP 403 liefern. Vorschau und Import überspringen Automatisierungen dann und fahren mit allen anderen ausgewählten Ressourcen fort.
Der kanonische Callback verwendet NEXT_PUBLIC_APP_DOMAIN (zum Beispiel app.famulor.io). Optional kann er mit FAMULOR_V1_OAUTH_REDIRECT_BASE_URL=https://app.famulor.io überschrieben werden. Erlaube diesen Ursprung im OAuth-Server von Famulor 1.0. Danach kehrt der Ablauf in den ursprünglichen Whitelabel-Dialog zurück.

​
Empfohlener Ablauf

  1. Erzeuge eine Vorschau und prüfe jede Warnung.
  2. Importiere Assistenten zusammen mit Kampagnen und Automatisierungen, damit deren Verknüpfungen im selben Lauf wiederhergestellt werden können.
  3. Verbinde Telefonnummern, Messaging-Absender, freigegebene WhatsApp-Vorlagen, Kalender (jeder Anbieter außer Cal.com sowie Cal.com-Einträge ohne verwendbare Zugangsdaten) und Wissensdatenbank-Dokumente auf der neuen Plattform.
  4. Öffne jede importierte Kampagne und Automation, repariere Prüfpunkte, teste sie und aktiviere sie erst danach manuell.
Sprachkampagnen übernehmen Assistent, Zeitzone, tägliche und mitternachtsübergreifende Zeitfenster, Parallelität, Retry-Regeln und Zielvariablen, soweit die Zielressourcen aufgelöst werden können. Laufende oder geplante Quellkampagnen werden immer als Entwurf angelegt. WhatsApp- und SMS-Kampagnen können erst neu angelegt werden, nachdem Ziel-Absender, Vorlage oder Versandnummer verbunden wurden, weil Famulor-1.0-IDs nicht portabel sind. Die Quell-API liefert keine Kampagnen-Leads; die Audience muss separat importiert oder zugewiesen werden. Automatisierungen werden immer als deaktivierte Entwürfe erstellt. Direkt unterstützt sind Assistant-Events, Webhook-, Schedule- und manuelle Trigger sowie HTTP-, Webhook-Response-, Delay-, SMS-, Outbound-Call-, Contact-Upsert- und Workspace-E-Mail-Schritte. Nicht unterstützte Integrationen und Legacy-Code bleiben als sichtbare Prüfknoten erhalten.

​
REST API und MCP

Nutze zuerst POST /api/v1/migrations/famulor mit action: "preview" und danach action: "import" mit den ausgewählten Quell-IDs. Der Ziel-API-Key benötigt Leserechte für die Vorschau und die passenden Schreibrechte für jede ausgewählte Ressourcenfamilie. Der API-Key-Ablauf ist über die MCP-Tools preview_famulor_1_migration und import_famulor_1_data verfügbar. Für den Bulk-Import ist REST empfohlen: deterministisch und für unbeaufsichtigte Läufe geeignet. Milian nutzt stattdessen die OAuth-Verbindung zum Quell-MCP, führt aber dieselbe deterministische Mapping-Engine und dieselben Entwurfs-Sicherheitsregeln aus.
Der MCP-Endpunkt von Famulor 1.0 verwendet einen eigenen OAuth-Flow. Ein Famulor-1.0-REST-API-Key authentifiziert diesen MCP-Endpunkt nicht. Füge niemals einen API-Key in einen Milian-Dialog ein, sondern nutze die Autorisierungskarte.