Installation
npm install -g @trunkbeam/cli
Alternativ ohne Installation mit npx @trunkbeam/cli <befehl>. Voraussetzung ist Node.js 22 oder neuer.
Anmelden
Lege im Dashboard unter API, CLI & MCP einen API-Schlüssel an. Dann:
trunkbeam login
Die CLI fragt den Schlüssel verdeckt ab, prüft ihn und speichert ihn in ~/.config/trunkbeam/config.json, nur für deinen Benutzer lesbar. trunkbeam logout löscht ihn wieder.
Auf Servern und in CI setzt du stattdessen die Umgebungsvariable:
export TRUNKBEAM_API_KEY=tb_live_…
Reihenfolge: --key vor TRUNKBEAM_API_KEY vor der gespeicherten Datei.
Globale Optionen
| Option | Wirkung |
|---|---|
--json | Rohdaten der API als JSON, für Skripte |
--yes, -y | Kostenpflichtige Aktionen ohne Rückfrage ausführen |
--key <schlüssel> | Anderen API-Schlüssel für diesen Aufruf verwenden |
--help, -h | Hilfe, auch je Befehl: trunkbeam numbers --help |
Befehle
| Befehl | Was er macht |
|---|---|
login, logout | CLI anmelden oder abmelden |
account | Konto, Prüfstatus, Tarif und Rechte des Schlüssels |
sites | Standorte mit ID; nur geprüfte bekommen Ortsnetznummern |
onkz <ort oder vorwahl> | Ortsnetz suchen, zum Beispiel onkz Schramberg |
numbers ls | Deine Nummern mit ID, Status und Ziel |
numbers order --site <id> | Ortsnetznummer am Standort bestellen, zeigt erst den Preis |
numbers order --032 | 032-Nummer ohne Ortsbezug bestellen |
numbers connect <id> --elevenlabs | Nummer in einem Schritt mit ElevenLabs verbinden |
numbers connect <id> --sip-uri <uri> | Nummer an eine beliebige SIP-Adresse leiten |
numbers fallback <id> <nummer> | Ersatznummer, wenn der Agent nicht erreichbar ist |
numbers release <id> | Nummer kündigen, fragt vorher nach |
requests ls, requests rm <id> | Bestellungen ansehen, offene zurückziehen |
connections ls, connections add, connections rm <id> | Agent-Anbindungen (SIP-Ziele) verwalten |
guide <anbieter> --number <id> | Einrichtungsanleitung mit deinen echten Werten |
transfer get, transfer set, transfer reset | Weiterleitung an Menschen, als Standard oder je Nummer |
hold-music | Wartemusik mit Beschreibung |
calls ls | Letzte Anrufe mit Dauer, Status und Kosten |
usage --month <JJJJ-MM> | Nutzung und Kosten eines Monats |
prices | Tarife und Preise |
Anbieter für guide und connections add --provider: elevenlabs, livekit, livekit_self, vapi, retell, ultravox, openai, deepgram, sip.
In Skripten
Mit --json und --yes läuft alles ohne Rückfrage. Beispiel: für einen neuen Kunden eine Nummer am Standort 3 holen und an seinen Agenten leiten.
id=$(trunkbeam numbers order --site 3 --yes --json | jq -r '.assigned.id')
trunkbeam numbers connect "$id" --sip-uri "sip:kunde-42@voice.example" --json
Ist gerade keine Nummer sofort verfügbar, steht in assigned der Wert null und die Bestellung bleibt offen. Den Stand zeigt trunkbeam requests ls.
Rückgabewerte
| Code | Bedeutung |
|---|---|
0 | Erfolgreich |
1 | Fehler oder abgebrochen |
2 | Falscher Aufruf |