Installation
npm install -g @trunkbeam/cliAlternativ ohne Installation mit npx @trunkbeam/cli. Voraussetzung ist Node.js 20 oder neuer.
Anmelden
trunkbeam loginlogin öffnet den Browser zur Bestätigung. Auf Servern ohne Browser setzt du stattdessen die Umgebungsvariable:
export TRUNKBEAM_API_KEY=tb_live_…Mehrere Konten trennst du mit Profilen, zum Beispiel trunkbeam login --profile kunde-a und danach --profile kunde-a bei jedem Befehl.
Globale Optionen
| Option | Wirkung |
|---|---|
--json | Ausgabe als JSON, für Skripte |
--yes | Rückfragen überspringen, etwa beim Kauf |
--profile <name> | Anderes Konto verwenden |
--help | Hilfe zu jedem Befehl |
Befehle
| Befehl | Was er macht |
|---|---|
signup | Konto anlegen |
login, logout | CLI anmelden oder abmelden |
status | Prüfstatus deines Kontos |
verify --docs <datei> | Unterlagen einreichen |
addresses list, addresses add | Adressen für weitere Ortsnetze |
numbers search --area <vorwahl> | Freie Nummern suchen |
numbers buy <nummer> --sip <uri> | Nummer kaufen und verbinden |
numbers list | Deine Nummern mit Status |
numbers update <nummer> --sip <uri> | Ziel ändern |
numbers release <nummer> | Nummer zum Monatsende kündigen |
transfer allow <nummer> --to <ziele> | Erlaubte Ziele für SIP REFER |
trunks create --name <name> | Zugangsdaten für ausgehende Anrufe |
calls list | Letzte Anrufe mit Dauer und Kosten |
prices | Aktuelle Preisliste |
usage --month <JJJJ-MM> | Verbrauch und Kosten eines Monats |
keys create, keys list, keys revoke | API-Schlüssel verwalten |
In Skripten
Mit --json und --yes läuft alles ohne Rückfrage. Beispiel: für jeden neuen Kunden eine Nummer im passenden Ortsnetz holen.
nummer=$(trunkbeam numbers search --area 089 --json | jq -r '.[0].number')
trunkbeam numbers buy "$nummer" --sip "sip:kunde-42@voice.example" --yes --jsonRückgabewerte
| Code | Bedeutung |
|---|---|
0 | Erfolgreich |
1 | Allgemeiner Fehler |
2 | Falsche Eingabe |
3 | Nicht angemeldet oder Schlüssel ungültig |
4 | Konto noch nicht freigegeben |
5 | Ausgabelimit erreicht |