> ## 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.

# Migration von Retell AI, VAPI und Synthflow

> Migriere bestehende Voice Agents und Assistenten aus Retell AI, VAPI oder Synthflow nach Famulor.

# Migration von Retell AI, VAPI und Synthflow

Mit dem Famulor-Migrationsassistenten kannst du bestehende Voice Agents aus **Retell AI**,
**VAPI** und **Synthflow** nach Famulor übertragen. Der Assistent liest deine bestehende
Konfiguration, ordnet die wichtigsten Felder einer Famulor-Konfiguration zu und erstellt daraus neue
Famulor-Assistenten.

<Note>
  Die Migration ist eine Kopie. Dein Retell-, VAPI- oder Synthflow-Account bleibt unverändert. Du
  kannst beide Systeme parallel testen und erst nach erfolgreichem Test die Telefonnummern oder SIP-
  Routen auf Famulor umstellen.
</Note>

## Wann du diese Anleitung nutzt

Nutze diese Anleitung, wenn du bereits produktive Assistenten bei einem anderen Voice-AI-Anbieter
hast und diese nicht komplett neu aufbauen möchtest.

<CardGroup cols={3}>
  <Card title="Retell AI" icon="phone-arrow-up-right" href="https://www.famulor.de/retell-migration" color="#1FD5F9">
    Für Retell-AI-Agents mit Prompts, Stimmen, Tools und Wissensquellen.
  </Card>

  <Card title="VAPI" icon="waveform-lines" href="https://www.famulor.de/vapi-migration" color="#1FD5F9">
    Für VAPI-Assistenten mit Modell-, Voice-, Transcriber- und Tool-Konfiguration.
  </Card>

  <Card title="Synthflow" icon="workflow" href="https://www.famulor.de/synthflow-migration" color="#1FD5F9">
    Für Synthflow-Assistenten, die du in Famulor weiter testen und betreiben willst.
  </Card>
</CardGroup>

## Voraussetzungen

* Ein Famulor-Account unter [app.famulor.de](https://app.famulor.de).
* Zugriff auf den Quellanbieter-Account, aus dem du migrieren willst.
* Ein API-Key des Quellanbieters mit Leserechten für Assistenten, Agents, Tools und Knowledge
  Bases.
* Mindestens ein Assistent oder Agent im Quellsystem.

<Warning>
  Füge nur API-Keys ein, die für die Migration nötig sind. Der Key wird serverseitig an den
  jeweiligen Anbieter weitergeleitet, um deine Agents zu lesen. Er wird nicht in Famulor gespeichert
  und nicht für spätere Synchronisationen behalten.
</Warning>

## Migration starten

<Steps>
  <Step title="Migrationsseite öffnen">
    Öffne die passende Migrationsseite:

    * [Retell AI zu Famulor](https://www.famulor.de/retell-migration)
    * [VAPI zu Famulor](https://www.famulor.de/vapi-migration)
    * [Synthflow zu Famulor](https://www.famulor.de/synthflow-migration)
  </Step>

  <Step title="API-Key des Quellanbieters einfügen">
    Kopiere den API-Key aus Retell AI, VAPI oder Synthflow und füge ihn im ersten Schritt des
    Migrationsassistenten ein. Famulor nutzt den Key nur, um die vorhandenen Agents und deren
    Konfiguration zu lesen.
  </Step>

  <Step title="Agents oder Assistenten auswählen">
    Wähle die Agents aus, die du nach Famulor kopieren willst. Du kannst einzelne Agents migrieren
    oder alle gefundenen Agents auswählen.
  </Step>

  <Step title="Feldzuordnung prüfen">
    Prüfe die vorgeschlagene Zuordnung für Modell, Sprache, Stimme, initiale Nachricht, System-
    Prompt, Knowledge Base und Tools. Passe die Zuordnung an, wenn Famulor keinen exakten Treffer
    für eine Stimme oder ein Modell findet.
  </Step>

  <Step title="Famulor autorisieren">
    Melde dich mit deinem Famulor-Account an. Dadurch kann der Assistent neue Famulor-Assistenten in
    deinem Account erstellen.
  </Step>

  <Step title="Migration ausführen">
    Starte die Migration und warte, bis alle ausgewählten Agents erstellt wurden. Nach Abschluss
    findest du die neuen Assistenten im Famulor-Dashboard.
  </Step>
</Steps>

## Was übernommen wird

| Bereich               | Wird migriert | Hinweise                                                                                      |
| --------------------- | ------------- | --------------------------------------------------------------------------------------------- |
| Name und Beschreibung | Ja            | Der Name kann vor der Erstellung angepasst werden.                                            |
| System-Prompt         | Ja            | Prüfe nach der Migration Variablen, Tool-Anweisungen und Eskalationslogik.                    |
| Initiale Nachricht    | Ja            | Besonders wichtig bei Inbound-Assistenten und Web-Widgets.                                    |
| Sprache               | Ja            | Wird auf die nächste passende Famulor-Sprache gemappt.                                        |
| Stimme                | Bestmöglich   | Wenn die exakte Stimme nicht existiert, wird eine passende Alternative vorgeschlagen.         |
| Modell                | Bestmöglich   | Proprietary Modellnamen werden auf verfügbare Famulor-Modelle gemappt.                        |
| Knowledge Base        | Bestmöglich   | Inhalte können je nach Quellanbieter unterschiedlich strukturiert sein.                       |
| Tools / Functions     | Teilweise     | API-Tools müssen nach der Migration getestet und ggf. als Mid-Call Action finalisiert werden. |
| Telefonnummern        | Nein          | Telefonnummern, SIP-Routen und Weiterleitungen werden separat umgestellt.                     |
| Historische Anrufe    | Nein          | Alte Call Logs bleiben im Quellsystem.                                                        |

## Nach der Migration testen

1. Öffne den migrierten Assistenten in Famulor.
2. Prüfe System-Prompt, Stimme, Sprache und Modell.
3. Teste den Assistenten mit [Test Chat](/de/ai-assistants/test-chat) und einem Testanruf.
4. Prüfe Knowledge Bases und Quellen, falls der Agent RAG nutzt.
5. Teste jede Mid-Call Action einzeln, besonders CRM-, Kalender- und Webhook-Aufrufe.
6. Verbinde erst danach eine Telefonnummer oder deinen SIP-Trunk.

<Tip>
  Migriere zuerst einen einzelnen Agent, teste ihn vollständig und stelle danach weitere Agents um.
  So erkennst du Mapping-Probleme früh, bevor du viele Assistenten auf einmal importierst.
</Tip>

## Go-Live-Checkliste

* Der Assistent beantwortet die wichtigsten Testfälle korrekt.
* Alle Tools oder Mid-Call Actions liefern echte Antworten, keine Testdaten.
* Kalender-, CRM- und Webhook-Ziele sind mit Produktivsystemen verbunden.
* Telefonnummer, SIP-Trunk oder Weiterleitung zeigt auf Famulor.
* Kampagnen- oder Inbound-Regeln wurden in Famulor neu gesetzt.
* Dein Team weiß, dass neue Call Logs ab Go-Live in Famulor liegen.

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="Der API-Key wird abgelehnt">
    Erstelle im Quellanbieter einen neuen API-Key und prüfe, ob er Zugriff auf Agents, Assistenten,
    Tools und Knowledge Bases hat. Kopiere den Key ohne Leerzeichen am Anfang oder Ende.
  </Accordion>

  <Accordion title="Es werden keine Agents gefunden">
    Prüfe, ob du im richtigen Workspace oder Projekt des Quellanbieters bist. Manche Anbieter trennen
    Produktiv- und Testumgebungen.
  </Accordion>

  <Accordion title="Eine Stimme oder ein Modell fehlt">
    Nicht jeder Anbieter hat identische Stimmen oder Modellnamen. Wähle in der Feldzuordnung die
    nächste passende Famulor-Stimme oder ein verfügbares Modell und teste die Gesprächsqualität.
  </Accordion>

  <Accordion title="Ein Tool funktioniert nach der Migration nicht">
    Prüfe URL, Methode, Header, Body-Schema und Authentifizierung. Erstelle das Tool bei Bedarf als
    Famulor [Mid-Call Action](/de/automation-platform/mid-call-tools/custom-api-integration) neu.
  </Accordion>

  <Accordion title="Kann ich nach der Migration zurück?">
    Ja. Die Migration löscht oder ändert im Quellsystem nichts. Solange deine Nummern oder SIP-
    Routen nicht umgestellt sind, läuft der alte Agent weiter.
  </Accordion>
</AccordionGroup>