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

# Vonage Integration

> Vonage-Telefonnummer per Elastic SIP Trunking mit Famulor verbinden

<Warning>
  **„Done for you“ — jede Region, jedes Land (unser EU-Partner-Carrier)**

  Wenn du **keinen** SIP-Trunk in Famulor einrichten und **keine** Nummern selbst importieren möchtest, kann unser **EU-Partner-Carrier** **lokale Rufnummern in beliebiger Region und jedem Land** bereitstellen, den **SIP-Trunk** aufsetzen und die **Anbindung direkt in Famulor importieren**. Die Einrichtung läuft **Ende-zu-Ende über den Partner** (Carrier-seitig) — **ohne** dass du Trunk und Nummernimport in Famulor selbst erledigen musst.

  * **Gewünschte Region / Komplettservice:** [Anfrageformular Partner - Famulor Custom Number Region form](https://tally.so/r/w4bN2Y)
  * **Rückfragen oder individuelle Optionen:** [support@famulor.de](mailto:support@famulor.de)
</Warning>

# Vonage-Nummer mit Famulor verbinden

In dieser Anleitung verbindest du eine **Vonage**-Telefonnummer über **Elastic SIP Trunking** mit Famulor.

<Note>
  Famulor hat **kein** spezielles Vonage-Import-Feature. Du richtest in Vonage einen **Elastic SIP Trunk** ein und verbindest ihn über **SIP-Trunk integrieren** in Famulor.

  Der Trunk hat zwei Richtungen:

  * **Termination** (ausgehende Anrufe): Vonage gibt dir eine SIP-Domain + Zugangsdaten, an die Famulor ausgehende Anrufe sendet.
  * **Origination** (eingehende Anrufe): Vonage leitet Anrufe an die **SIP-Adresse von Famulor** weiter.
</Note>

## Funktionsweise

```mermaid theme={null} theme={null}
sequenceDiagram
    participant K as Anrufer
    participant V as Vonage
    participant FA as Famulor
    participant A as KI-Assistent

    Note over V,FA: Eingehend – Origination an „Unsere SIP-Adresse"
    K->>V: Anruf an deine Vonage-Nummer
    V->>FA: SIP-Anruf an „Unsere SIP-Adresse"
    FA->>A: Anruf an zugewiesenen Assistenten
    A->>FA: Sprachantwort (Echtzeit)
    FA->>K: Gespräch mit KI-Assistent
    Note over FA,V: Ausgehend – Termination an <prefix>.sip.vonage.com
```

* **Eingehend:** Famulor **registriert sich nicht** per SIP REGISTER. Vonage schickt Anrufe über die **Origination** an „Unsere SIP-Adresse".
* **Ausgehend:** Famulor sendet Anrufe an die **Termination**-SIP-Domain von Vonage und authentifiziert sich mit Benutzername und Passwort.

## Voraussetzungen

* Aktives **Vonage**-Konto mit Zugriff auf **Programmable SIP / Elastic SIP Trunking**
* Mindestens eine Vonage-Telefonnummer (oder eine neue Nummer zum Kaufen)
* Famulor-Konto

***

## Schritt 1: Elastic SIP Trunk in Vonage erstellen

1. Öffne das **Vonage-Dashboard** und navigiere zum Bereich **SIP**.

<img src="https://mintcdn.com/famulor/ZDI5dfPWanhnn7vp/images/vonage/vonage-sip-section.png?fit=max&auto=format&n=ZDI5dfPWanhnn7vp&q=85&s=111c159cdd3b8e0a0933c13aa37a533f" alt="Vonage-Dashboard: Navigation zum SIP-Bereich" width="257" height="411" data-path="images/vonage/vonage-sip-section.png" />

2. Lege einen neuen SIP-Trunk an und wähle als Anbieter **„Something else"** (also keinen vordefinierten Anbieter).

<img src="https://mintcdn.com/famulor/ZDI5dfPWanhnn7vp/images/vonage/vonage-choose-provider.png?fit=max&auto=format&n=ZDI5dfPWanhnn7vp&q=85&s=b0de4a09d4ad01cea4a9f862383e9302" alt="Vonage: Anbieterauswahl mit Option „Something else“" width="1303" height="489" data-path="images/vonage/vonage-choose-provider.png" />

***

## Schritt 2: Termination einrichten (ausgehende Anrufe)

Die **Termination** liefert die SIP-Domain und die Zugangsdaten, mit denen Famulor ausgehende Anrufe sendet.

1. Folge in Vonage der Einrichtung der **Termination**.
2. Notiere dir die angezeigten Werte:

| Feld                         | Beispiel / Bedeutung                                 |
| ---------------------------- | ---------------------------------------------------- |
| **SIP-Domain**               | `<dein-prefix>.sip.vonage.com` (Termination SIP URI) |
| **Benutzername (User name)** | Zugangsdaten für ausgehende Anrufe                   |
| **Passwort (Password)**      | Zugangsdaten für ausgehende Anrufe                   |

<img src="https://mintcdn.com/famulor/ZDI5dfPWanhnn7vp/images/vonage/vonage-termination.png?fit=max&auto=format&n=ZDI5dfPWanhnn7vp&q=85&s=a706b561b3cee89a245c3410f820fc8c" alt="Vonage: Termination mit SIP-Domain (.sip.vonage.com), Benutzername und Passwort" width="1452" height="694" data-path="images/vonage/vonage-termination.png" />

<Note>
  Speichere **SIP-Domain**, **Benutzername** und **Passwort** sicher. Du brauchst sie in **Schritt 5** für die Famulor-Einrichtung.
</Note>

***

## Schritt 3: Origination einrichten (eingehende Anrufe)

Bei der **Origination** legst du fest, wohin Vonage eingehende Anrufe weiterleitet – nämlich an die **SIP-Adresse von Famulor**.

1. Öffne in einem zweiten Tab Famulor unter [app.famulor.de/phone-numbers?lang=de](https://app.famulor.de/phone-numbers?lang=de) → **Deine Telefonnummern → + SIP-Trunk integrieren** und kopiere unter **Einstellungen für eingehende Anrufe** den Wert **Unsere SIP-Adresse** (z. B. `xxxxxx.eu.sip.livekit.cloud`).
2. Füge diese Adresse in Vonage unter **Origination** als **SIP-URI** ein.

<img src="https://mintcdn.com/famulor/ZDI5dfPWanhnn7vp/images/vonage/vonage-origination.png?fit=max&auto=format&n=ZDI5dfPWanhnn7vp&q=85&s=8b5c1e2dd33578890182889c48afa59c" alt="Vonage: Origination – SIP-URI von Famulor (z. B. xxxxxx.sip.livekit.cloud) einfügen" width="1498" height="667" data-path="images/vonage/vonage-origination.png" />

<Note>
  Übernimm die **genaue** „Unsere SIP-Adresse" aus Famulor – ohne Leerzeichen.
</Note>

***

## Schritt 4: Nummer dem Trunk zuordnen

Verknüpfe eine Telefonnummer mit deinem Elastic SIP Trunk – entweder eine **bestehende Nummer** oder eine **neu gekaufte**.

<img src="https://mintcdn.com/famulor/ZDI5dfPWanhnn7vp/images/vonage/vonage-add-number.png?fit=max&auto=format&n=ZDI5dfPWanhnn7vp&q=85&s=bfd28a98f5d0399f276f7d39a3f57ea4" alt="Vonage: Nummer dem Elastic SIP Trunk zuordnen" width="1325" height="505" data-path="images/vonage/vonage-add-number.png" />

<Note>
  Notiere dir die Vonage-Nummer im **E.164-Format** mit Landesvorwahl (z. B. `+12025550123`). Du brauchst sie in Schritt 5.
</Note>

***

## Schritt 5: SIP-Trunk in Famulor einrichten

1. Gehe in Famulor zu **Deine Telefonnummern** und klicke auf **+ SIP-Trunk integrieren**.
2. Trage die Daten wie folgt ein:

| Feld                                     | Wert                                                                                      |
| ---------------------------------------- | ----------------------------------------------------------------------------------------- |
| **SIP-Trunk-Typ**                        | **Telefonnummer (DID)**                                                                   |
| **Telefonnummer**                        | Deine Vonage-Nummer im E.164-Format (z. B. `+12025550123`)                                |
| **Benutzername**                         | Der **Termination**-Benutzername aus Schritt 2                                            |
| **Passwort**                             | Das **Termination**-Passwort aus Schritt 2                                                |
| **SIP-Adresse** (ausgehend)              | Die Vonage-**SIP-Domain** aus Schritt 2 (z. B. `<dein-prefix>.sip.vonage.com`, ohne Port) |
| **Format der ausgehenden Telefonnummer** | **International (mit + vorne)**                                                           |
| **Land**                                 | Das Land deines Vonage-Trunks                                                             |

3. Unter **Einstellungen für eingehende Anrufe** steht **Unsere SIP-Adresse** – dieselbe Adresse, die du in **Schritt 3** als Vonage-Origination eingetragen hast.
4. Klicke auf **SIP-Nummer hinzufügen**.

<img src="https://mintcdn.com/famulor/wnlYvSCGGEycwCA5/images/vonage/famulor-sip-trunk-vonage.png?fit=max&auto=format&n=wnlYvSCGGEycwCA5&q=85&s=c7f220b3e2faf3210d1899a24aa847d1" alt="Famulor: Dialog „SIP-Trunk integrieren“ mit Trunk-Typ „Telefonnummer (DID)“, ausgehender SIP-Adresse (sip-eu.vonage.com) und „Unsere SIP-Adresse“ für eingehende Anrufe" width="694" height="739" data-path="images/vonage/famulor-sip-trunk-vonage.png" />

***

## Schritt 6: Assistenten zuweisen und testen

1. Öffne in Famulor den Bereich **Assistenten** und bearbeite den gewünschten Assistenten.
2. Wähle den passenden **Empfangstyp** (eingehende Anrufe).
3. Wähle deine verbundene Vonage-Telefonnummer aus der Liste.
4. Klicke auf **Assistent speichern**.
5. Führe einen **Testanruf** auf deine Vonage-Nummer durch und prüfe, ob der KI-Assistent antwortet.

***

## Anrufweiterleitung an einen Menschen (Warmweiterleitung)

Famulor kann ein laufendes Gespräch an einen echten Ansprechpartner übergeben. **Bei Vonage nutzt du dafür ausschließlich die Warmweiterleitung** – die Kaltweiterleitung funktioniert über den Vonage-Trunk nicht (siehe Hinweis). Die allgemeine Einrichtung findest du unter [Anrufsweiterleitung](/de/platform/anrufsweiterleitung).

<Warning>
  **Vonage unterstützt kein SIP REFER.** Famulor führt **Kaltweiterleitungen** über **SIP REFER** durch – der Carrier verbindet den Anrufer dabei direkt weiter. Da Vonage-SIP-Trunks REFER **nicht** unterstützen, funktioniert die **Kaltweiterleitung über den Vonage-Trunk nicht zuverlässig**.

  **Empfehlung für Vonage:** Nutze die **Warmweiterleitung**. Dabei erstellt Famulor ein **neues SIP INVITE** (einen separaten ausgehenden Anruf über den Vonage-Trunk) und **führt die beiden Gespräche zusammen** – das benötigt **kein** REFER und funktioniert daher auch mit SIP-Trunks ohne REFER-Unterstützung wie Vonage.
</Warning>

### Weiterleitungsziel: Telefonnummer oder Custom SIP

Das Ziel der Warmweiterleitung gibst du auf eine von zwei Arten an:

* **Supervisor-Telefonnummer:** Die Rufnummer des Ansprechpartners (z. B. `+49 1512 3456789`).
* **(Advanced) Custom SIP/Extension:** Aktiviere diese Option, um statt einer Telefonnummer eine **eigene SIP-Adresse oder interne Nebenstelle** anzugeben (Feld **Custom SIP transfer**, z. B. `sip:number@sip-server`).

<img src="https://mintcdn.com/famulor/35Jj5ynoYtXU-KMH/images/vonage/famulor-warm-transfer.png?fit=max&auto=format&n=35Jj5ynoYtXU-KMH&q=85&s=23eb03f88c333ec5b715669dc62deef8" alt="Famulor: Warmweiterleitung mit Supervisor-Telefonnummer (Custom SIP/Extension deaktiviert)" width="1281" height="2313" data-path="images/vonage/famulor-warm-transfer.png" />

<img src="https://mintcdn.com/famulor/35Jj5ynoYtXU-KMH/images/vonage/famulor-warm-transfer-custom-sip.png?fit=max&auto=format&n=35Jj5ynoYtXU-KMH&q=85&s=a9db1f0c675086acb1bd96e33e9cc3e6" alt="Famulor: Warmweiterleitung mit aktiviertem „(Advanced) Custom SIP/Extension“ und Feld „Custom SIP transfer“" width="1283" height="2327" data-path="images/vonage/famulor-warm-transfer-custom-sip.png" />

### Einstellungen der Warmweiterleitung

| Feld                                                  | Bedeutung                                                                                                            |
| ----------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------- |
| **Supervisor phone number** / **Custom SIP transfer** | Ziel des Transfers: Telefonnummer **oder** – bei aktiviertem **Custom SIP/Extension** – SIP-Adresse bzw. Nebenstelle |
| **Outbound phone number**                             | Nummer, über die der Supervisor angerufen wird (benötigt einen ausgehenden Trunk)                                    |
| **Caller ID shown to supervisor**                     | Welche Nummer der Supervisor beim Anruf sieht (z. B. die ausgehende Nummer)                                          |
| **Hold music** / **Hold music volume**                | Wartemusik für den Anrufer und Lautstärke (0–100)                                                                    |
| **When to transfer**                                  | Beschreibung, wann die KI die Warmweiterleitung auslösen soll                                                        |
| **Hold message**                                      | Was die KI dem Anrufer sagt, bevor er in die Warteschleife kommt                                                     |
| **Summary instructions**                              | Wie die KI den Supervisor briefen soll (wer ruft an, warum, warum ein Mensch nötig ist)                              |
| **Briefing initial message**                          | Erster Satz, den der Supervisor hört                                                                                 |
| **Connected message**                                 | Was der Anrufer hört, sobald der Supervisor verbunden ist                                                            |

<Note>
  In **Summary instructions**, **Briefing initial message** und ähnlichen Feldern kannst du Variablen verwenden: `{customer_phone}` (Rufnummer des Anrufers) sowie Lead-Variablen wie `{name}` oder `{email}`.
</Note>

***

## Häufige Probleme

<AccordionGroup>
  <Accordion title="Eingehende Anrufe kommen nicht an" icon="phone-slash">
    Prüfe die **Origination** in Vonage (Schritt 3): Dort muss die **genaue** „Unsere SIP-Adresse" aus Famulor stehen. Stelle außerdem sicher, dass die **Nummer dem Trunk zugeordnet** ist (Schritt 4).
  </Accordion>

  <Accordion title="Ausgehende Anrufe schlagen fehl" icon="arrow-up-right-from-square">
    Prüfe in Famulor die **Termination**-Werte aus Schritt 2: **SIP-Adresse** (`<dein-prefix>.sip.vonage.com`), **Benutzername** und **Passwort**. Wähle als Rufnummernformat **International (mit + vorne)**.
  </Accordion>

  <Accordion title="Falsche oder unbekannte SIP-Adresse" icon="server">
    Verwende immer die **exakte** „Unsere SIP-Adresse" aus Famulor (Telefonnummern → SIP-Trunk integrieren → Einstellungen für eingehende Anrufe).
  </Accordion>

  <Accordion title="Kaltweiterleitung funktioniert nicht" icon="phone-arrow-up-right">
    **Vonage unterstützt kein SIP REFER**, das Famulor für die Kaltweiterleitung nutzt. Verwende stattdessen die **Warmweiterleitung** – sie erstellt ein neues SIP INVITE und führt die Gespräche zusammen (kein REFER), funktioniert also mit Vonage. Details: [Anrufsweiterleitung](/de/platform/anrufsweiterleitung).
  </Accordion>
</AccordionGroup>

***

## Hilfe

<Tip>
  Bei Problemen kontaktiere unser Support-Team unter [support@famulor.io](mailto:support@famulor.io). Allgemeine Hinweise findest du auch unter [SIP-Integration](/de/provisioning/sip-ai/sip-integration) und [SIP-Integrationsprobleme](/de/troubleshooting/sip-integration-issues).
</Tip>