> ## 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.
# 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
Gehe zu **Telefonnummern → Nummer kaufen** und wähle ein Land sowie einen Nummerntyp (lokal, mobil, gebührenfrei – die Verfügbarkeit variiert je nach Land).
Viele Länder verlangen gesetzlich eine Identitäts- oder Adressverifizierung, bevor eine Nummer aktiviert werden kann – siehe unten.
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.
Sobald die Zahlung bestätigt ist, wird das Routing eingerichtet und die Nummer aktiviert. Bei fehlgeschlagenen, abgelaufenen oder unbezahlten Käufen wird die reservierte Nummer automatisch wieder freigegeben – ein Anrufzugriff entsteht dann nicht.
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.
## Länderverfügbarkeit und Preise
In welchen Ländern du kaufen kannst und der **monatliche Preis pro Nummer** werden vom Plattformbetreiber festgelegt. Die Preise unterscheiden sich je nach Land und Nummerntyp und werden deinem Konto monatlich in Rechnung gestellt.
## Regulatorische Bundles
In vielen Ländern ist für eine Nummer ein **Regulatory Bundle** erforderlich – eine verifizierte Identität und oft eine lokale Adresse –, bevor du die Nummer kaufen kannst. Die Bundle-Anforderungen sind **länder- und nummerntypspezifisch** (in Deutschland braucht zum Beispiel eine lokale Nummer meist ein Bundle, eine mobile Nummer oft nicht). Die Plattform erkennt das automatisch je Land und Nummerntyp.
**Die regulatorische Prüfung läuft über den Telefonie-Anbieter der Plattform.** Nach der Freigabe kannst du die Nummern kaufen; sie werden für SIP-Trunking/Anrufweiterleitung eingebunden.
### So läuft die Verifizierung ab
1. Öffne **Einstellungen → Verifizierung** (oder **Nummer kaufen → Benutzerdefinierte Nummer / Verifizierung einreichen**).
2. Die Länderliste enthält **alle Länder, die ein Regulatory Bundle erfordern** — auch Länder, in denen der Marketplace-Kauf aktuell nicht aktiviert ist (`GET /api/telephony/verification/catalog` oder öffentlich `GET /api/v1/phone-numbers/verifications/catalog`).
3. Wähle Land, Nummerntyp und Endkundentyp (Unternehmen oder Privatperson). Formularfelder und akzeptierte Dokumente werden für diese Kombination aus dem Live-Regulierungskatalog geladen.
4. Reiche den Fall ein. Statusänderungen erscheinen auf der Verifizierungsseite (`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
Plattform-Admins können die Bundle-Flags pro Typ unter **Admin → Telefonie** aktualisieren.
Plane für regulierte Länder ausreichend Vorlauf ein: Die Prüfung dauert oft mehrere Werktage (abhängig von Land und Dokumentenqualität).
## Ausgehende SMS
SMS-fähige Nummern (Marktplatz-Mobilnummern oder per Twilio importierte Nummern mit SMS-Capability) können nach Aktivierung von **Allow outbound SMS** im SMS-Tab über die Plattform senden.
* **Marktplatz-Nummern:** SMS-Credits enthalten Plattformgebühr plus Carrier-Pass-through.
* **Twilio-BYOC-Import:** SMS-Credits belasten nur die Plattformgebühr; die Carrier-Kosten zahlt ihr bei Twilio. Für US-10DLC → US muss die Nummer in Twilio mit einer genehmigten A2P-10DLC-Kampagne registriert sein.
Public API: `POST /api/v1/sms/send`. MCP: `send_sms`.
## Kostenlose Nummern (im Plan enthalten)
Einige Plattform-Pläne enthalten eine begrenzte Anzahl kostenloser Marktplatz-Nummern für ausgewählte Länder. Diese Nummern werden ohne Stripe-Checkout aktiviert. Wird der Workspace-Plan **gekündigt** oder schlägt die Zahlung fehl (`past_due` / Konto gesperrt), werden die kostenlosen Nummern automatisch **freigegeben**. Bezahlte Marktplatz-Nummern mit eigenem Abo sind davon nicht betroffen.
Die manuelle Freigabe einer kostenlosen Nummer ist **sofort** (Nummer kehrt zum Anbieter zurück; nicht wiederherstellbar).
## Bezahlte Marktplatz-Nummer freigeben
Bezahlte Marktplatz-Nummern haben ein eigenes Stripe-Abo. Beim Freigeben:
1. Stripe wird auf **Cancel at period end** gesetzt (keine weiteren Verlängerungen).
2. Die Nummer bleibt bis zum Periodenende **voll nutzbar** (Inbound/Outbound).
3. Am Periodenende gibt Twilio die Nummer frei und der Status wird `released`.
Kostenlose / unbezahlte / fehlgeschlagene Käufe werden weiterhin sofort freigegeben.
## Nummern-Limit
Wie viele Telefonnummern dein Konto haben kann, ist durch ein Plan-Limit begrenzt (`max_own_numbers`).
## Carrier-Kosten pro Anruf
Neben der monatlichen Nummerngebühr fällt für jede Gesprächsminute eine **Carrier-Gebühr an, die vom Zielland abhängt**, und wird zusätzlich zu den Plan-Minuten von deinem Minutenguthaben abgezogen. Siehe [Wie Minuten abgerechnet werden](/billing/minutes).
## Bring deine eigenen Nummern mit
Wenn du bereits Nummern bei einem SIP-Anbieter hast, verbinde sie über einen [BYO-SIP-Trunk](/telephony/sip-trunks) – eine Portierung ist nicht nötig.