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

# Telefonnummern kaufen

> Suche, kaufe und verwalte Nummern über den Plattform-Marktplatz

Die Plattform bietet einen **Nummern-Marktplatz**: Suche verfügbare Nummern nach Land und Typ, kaufe sie mit einem Klick – sie werden automatisch an die Telefonie deines Kontos weitergeleitet. Kein eigenes Carrier-Konto nötig.

## So funktioniert der Kauf

<Steps>
  <Step title="Suchen">
    Gehe zu **Settings → Numbers → Add a number → Buy a number** und wähle ein Land. Wenn mehr als ein Nummerntyp kaufbar ist oder du ein Workspace-/User-Bundle hast, erscheinen über der Liste Tabs (Local, Mobile und dein Bundle-Name). Ein einzelner Typ, der nur über eine globale Freischaltung verfügbar ist, zeigt alle verfügbaren Nummern ohne Tabs – wie bisher.
  </Step>

  <Step title="Regulatorische Anforderungen erfüllen (falls nötig)">
    Viele Länder verlangen gesetzlich eine Identitäts- oder Adressverifizierung, bevor eine Nummer aktiviert werden kann – siehe unten.
  </Step>

  <Step title="Kaufen">
    Der monatliche Preis und eine mögliche Einrichtungsgebühr werden vorab angezeigt. Schließe den sicheren Checkout ab. Die Nummer bleibt bis zur Zahlungsbestätigung ausstehend und kann in dieser Zeit keine Anrufe empfangen oder tätigen.
  </Step>

  <Step title="Aktivierung nach Zahlungsbestätigung">
    Ein bestätigtes Zahlungsereignis richtet das Routing ein und aktiviert die Nummer. Bei fehlgeschlagenen, abgelaufenen oder unbezahlten Käufen wird die reservierte Nummer automatisch wieder freigegeben – ein Anrufzugriff entsteht dann nicht.
  </Step>

  <Step title="Assistenten zuweisen">
    Weise der Nummer einen Assistenten zu – eingehende Anrufe werden ab diesem Moment beantwortet. Dieselbe Nummer kannst du auch als Anrufer-ID für ausgehende Anrufe verwenden.
  </Step>
</Steps>

## Länderverfügbarkeit und Preise

Verfügbare Länder und Nummerntypen werden im Marktplatz angezeigt. Er verkauft **Orts-, Mobil- und Nationalnummern**; **Toll-free wird derzeit nicht angeboten**. Der Checkout zeigt den monatlichen Preis und eine mögliche einmalige Einrichtungsgebühr vor dem Kauf. Die Preise unterscheiden sich je nach Land und Nummerntyp.

## Regulatorische Bundles

Manche Länder und Nummerntypen erfordern eine **Identitätsprüfung**, bevor du kaufen kannst. Die Kaufseite zeigt nur die Typen, die noch gesperrt sind. Alles andere kannst du sofort kaufen.

Nach der regulatorischen Freigabe kannst du geeignete Nummern kaufen und für Anrufe nutzen.

### So läuft die Verifizierung ab

1. Öffne **Settings → Verification** (oder **Buy a number → Custom number / Submit verification**).
2. Die Länderliste enthält Länder, die eine regulatorische Prüfung erfordern. API-Clients verwenden `GET /api/v1/phone-numbers/verifications/catalog`.
3. Wähle Land, Nummerntyp, Endkundentyp (Unternehmen oder Privatperson) und die erforderliche Vorwahl bzw. das Präfix. Nationale Ziffern wie 0831 werden für Deutschland zu +49831. Formularfelder und akzeptierte Dokumente werden **für diese Kombination** aus dem Live-Regulierungskatalog geladen.
4. Reiche den Fall ein. Statusänderungen erscheinen auf der Verification-Seite (`pending review` → `approved` / `rejected`). Bei einer Ablehnung reichst du einen **neuen** Fall mit korrigierten Angaben ein.
5. Nach der Genehmigung sind Marktplatz-Suche und -Kauf für dieses Land und diesen Typ für den Workspace freigeschaltet.

Außerdem kannst du:

* Katalog und Fälle über die öffentliche API auflisten (`/api/v1/phone-numbers/verifications`, `/api/v1/phone-numbers/verifications/catalog`)
* Die MCP-Tools `list_verification_catalog`, `list_number_verifications`, `submit_number_verification`, `get_number_verification` nutzen

<Note>
  Plane für regulierte Länder ausreichend Vorlauf ein: Die Prüfung dauert oft mehrere Werktage (abhängig von Land und Dokumentenqualität).
</Note>

## Ausgehende SMS

SMS-fähige Nummern (Marktplatz-Mobilnummern oder per Twilio importierte Nummern mit SMS-Funktion) können über die Plattform ausgehende SMS versenden, nachdem du **Allow outbound SMS** im SMS-Tab der Nummer aktiviert hast.

* **Marktplatz-Nummern:** SMS-Credits enthalten Plattformgebühr plus Carrier-Pass-through.
* **Twilio-BYOC-Import:** SMS-Credits berechnen nur die Plattformgebühr; die Twilio-Carrier-Kosten werden über dein Twilio-Konto abgerechnet. Für US-10DLC-→-US-Traffic muss die Nummer in Twilio mit einer genehmigten A2P-10DLC-Kampagne registriert sein.

Public API: `POST /api/v1/sms/send`. MCP: `send_sms`. Siehe [SMS](/de/api-reference/sms) für die Abrechnung pro Segment und die Sende-API.

## Kostenlose Nummern (im Plan enthalten)

Einige Pläne enthalten eine begrenzte Anzahl kostenloser **lokaler** Marktplatz-Nummern für ausgewählte Länder. Mobil-, National- und andere Nummerntypen bleiben kostenpflichtig. Wird der Workspace-Plan gekündigt oder bleibt eine Zahlung überfällig, werden kostenlose Nummern automatisch freigegeben. Bezahlte Marktplatz-Nummern sind davon nicht betroffen.

Die manuelle Freigabe einer kostenlosen Nummer erfolgt **sofort** und kann nicht rückgängig gemacht werden.

## Bezahlte Marktplatz-Nummer freigeben

Beim Freigeben einer bezahlten Marktplatz-Nummer:

1. Die Verlängerung wird zum Ende des aktuellen Abrechnungszeitraums gekündigt.
2. Die Nummer bleibt bis zum Periodenende **voll nutzbar** (eingehend/ausgehend).
3. Am Periodenende wird die Nummer freigegeben und kann nicht mehr genutzt werden.

Kostenlose / unbezahlte / fehlgeschlagene Käufe werden weiterhin sofort freigegeben. Es gibt **keine Erstattung** und **keine anteilige Abrechnung** – die Einrichtungsgebühr ist einmalig und wird nie zurückerstattet.

## Telefonnummern-Limit

Dein Plan bestimmt, wie viele Telefonnummern der Workspace nutzen kann.

## Carrier-Kosten pro Anruf

Neben der monatlichen Nummerngebühr kann sich der Minutenpreis je nach Zielland unterscheiden. Siehe [Wie Minuten abgerechnet werden](/de/billing/minutes).

## Wege, eine Nummer zu verbinden

Der Marktplatz ist nicht der einzige Weg, eine Nummer mit einem Assistenten zum Laufen zu bringen:

| Option                                                 | Richtung              | Was du brauchst                                                                                              |
| ------------------------------------------------------ | --------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Im Marktplatz kaufen** (diese Seite)                 | Eingehend + ausgehend | Nichts mitzubringen – suchen, kaufen, zuweisen (regulierte Länder benötigen zuerst eine Verifizierung)       |
| **[BYO-SIP-Trunk](/de/telephony/sip-trunks)**          | Eingehend + ausgehend | Eine Nummer, die du bereits bei einem SIP-kompatiblen Carrier besitzt                                        |
| **[Carrier-Import](/de/telephony/carrier-import)**     | Eingehend + ausgehend | Ein Twilio-, Telnyx- oder Vonage-Konto – das Routing wird für dich eingerichtet                              |
| **[Anrufer-ID verifizieren](/de/telephony/caller-id)** | Nur ausgehend         | Eine Telefonnummer, die du bereits besitzt, einmal verifiziert – keine Portierung oder SIP-Einrichtung nötig |

Kaufe eine Marktplatz-Nummer für eine neue Einrichtung. Bring deinen eigenen SIP-Trunk mit, wenn du bereits Carrier-Nummern hast, die du weiter nutzen willst – oder lass sie per Carrier-Import automatisch verbinden, wenn diese Nummern bei Twilio, Telnyx oder Vonage liegen. Verifiziere eine Anrufer-ID, wenn nur deine eigene Nummer bei ausgehenden Anrufen angezeigt werden soll – zum Beispiel bei einer ausgehenden Vertriebskampagne, die keine Anrufe empfangen muss.

Soll die Leitung, die du heute schon selbst annimmst, stattdessen einen Assistenten erreichen? Lass die Nummer, wo sie ist, und [leite sie an deine Famulor-Nummer weiter](/de/telephony/call-forwarding-setup).
