# Konto und Prüfung

Konto anlegen, Unternehmensangaben prüfen lassen und Rufnummern freischalten.

> Early Access: Die Schnittstellen sind als Entwurf dokumentiert. Befehle, Pakete und Endpunkte vor der Nutzung mit uns abstimmen.

Quelle: https://trunkbeam.com/docs/account

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

```bash
trunkbeam signup
```

Die 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

```bash
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

```bash
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:

```bash
trunkbeam verify --docs ./nachweis.pdf
```

## Weitere Adressen

Für Nummern in weiteren Ortsnetzen hinterlegst du dort je eine Adresse. Jede neue Adresse prüfen wir einzeln.

```bash
trunkbeam addresses add "Beispielweg 5, 20095 Hamburg" --docs ./nachweis-hamburg.pdf
trunkbeam addresses list
```

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

```bash
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_8f2a
```

Für Agenten empfehlen wir einen eigenen Schlüssel mit eingeschränkten Rechten und Ausgabelimit in Euro pro Monat.