> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Von Famulor 1.0 migrieren
> Assistenten, Tools, Wissensdatenbank-Hüllen, Kampagnen und Automatisierungen sicher prüfen und importieren
Ö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.