Rufnummern dürfen in Deutschland nur an echte Firmen oder Personen mit passender Adresse vergeben werden. Das schreibt die Bundesnetzagentur vor. Deshalb prüfen wir jedes Konto, bevor du die erste Nummer kaufen kannst. Ein Mensch prüft die Angaben. Den Zeitrahmen klären wir beim Onboarding.
Konto anlegen
trunkbeam signupDie CLI fragt ab:
- Firmenname und Rechtsform
- Geschäftsadresse
- Ansprechpartner mit Name, E-Mail und Telefonnummer
- kurz, wofür du die Nummern nutzt, zum Beispiel „KI-Telefonassistent für Terminvereinbarung in Arztpraxen“
Danach bekommst du einen Bestätigungslink per E-Mail. Mit trunkbeam login meldest du die CLI an deinem Konto an.
Was wir prüfen
| Angabe | Nachweis |
|---|---|
| Firma | Handelsregisterauszug oder Gewerbeanmeldung |
| Adresse im Ortsnetz | Steht im Nachweis oder als eigener Beleg, zum Beispiel Mietvertrag oder Rechnung eines Versorgers |
| Ansprechpartner | Name und erreichbare Telefonnummer |
| Nutzung | Ein Satz zum Anwendungsfall |
Für nationale Rufnummern ohne Ortsbezug reicht die Geschäftsadresse in Deutschland.
Unterlagen einreichen
trunkbeam verify --docs ./handelsregister.pdf
trunkbeam verify --docs ./mietvertrag-berlin.pdf --address "Beispielstraße 1, 10115 Berlin"Erlaubt sind PDF, PNG und JPG bis 10 MB pro Datei.
Status abfragen
trunkbeam status
trunkbeam status --json| Status | Bedeutung |
|---|---|
pending | Konto angelegt, Unterlagen fehlen noch |
in_review | Unterlagen liegen vor, wir prüfen |
approved | Freigegeben, du kannst Nummern kaufen |
rejected | Abgelehnt, im Feld reason steht, was fehlt |
Wenn wir ablehnen
Eine Ablehnung ist kein Endpunkt. In reason steht, was fehlt, zum Beispiel „Adresse liegt nicht im Ortsnetz 089“. Reiche den fehlenden Nachweis nach, dann prüfen wir erneut:
trunkbeam verify --docs ./nachweis.pdfWeitere Adressen
Für Nummern in weiteren Ortsnetzen hinterlegst du dort je eine Adresse. Jede neue Adresse prüfen wir einzeln.
trunkbeam addresses add "Beispielweg 5, 20095 Hamburg" --docs ./nachweis-hamburg.pdf
trunkbeam addresses listAPI-Schlüssel
Nach der Freigabe legst du Schlüssel für Skripte, CI und Agenten an. Der Schlüssel beginnt mit tb_live_ und wird nur einmal angezeigt.
trunkbeam keys create --name production
trunkbeam keys create --name agent --scope numbers:read,numbers:write --spend-limit 20
trunkbeam keys list
trunkbeam keys revoke key_8f2aFür Agenten empfehlen wir einen eigenen Schlüssel mit eingeschränkten Rechten und Ausgabelimit in Euro pro Monat.