So funktioniert der Kauf
1
Suchen
Gehe zu Telefonnummern → Nummer kaufen und wähle ein Land sowie einen Nummerntyp (lokal, mobil, gebührenfrei – die Verfügbarkeit variiert je nach Land).
2
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.
3
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.
4
Aktivierung nach Zahlungsbestätigung
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.
5
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.
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
- Öffne Einstellungen → Verifizierung (oder Nummer kaufen → Benutzerdefinierte Nummer / Verifizierung einreichen).
- 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/catalogoder öffentlichGET /api/v1/phone-numbers/verifications/catalog). - Wähle Land, Nummerntyp und Endkundentyp (Unternehmen oder Privatperson). Formularfelder und akzeptierte Dokumente werden für diese Kombination aus dem Live-Regulierungskatalog geladen.
- 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. - Nach der Genehmigung sind Marktplatz-Suche und -Kauf für dieses Land und diesen Typ für den Workspace freigeschaltet.
- 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_verificationnutzen
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.
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:- Stripe wird auf Cancel at period end gesetzt (keine weiteren Verlängerungen).
- Die Nummer bleibt bis zum Periodenende voll nutzbar (Inbound/Outbound).
- Am Periodenende gibt Twilio die Nummer frei und der Status wird
released.
Nummern-Limit
Wie viele Telefonnummern dein Konto haben kann, ist durch ein Plan-Limit begrenzt (max_own_numbers).