Early Access: Dashboard, CLI, MCP-Server und REST-API sind nutzbar. Die Einrichtung für deinen Voice-Stack klären wir gern direkt mit dir.

CLI

Installation, Anmeldung und alle Befehle der Kommandozeile.

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

OptionWirkung
--jsonRohdaten der API als JSON, für Skripte
--yes, -yKostenpflichtige Aktionen ohne Rückfrage ausführen
--key <schlüssel>Anderen API-Schlüssel für diesen Aufruf verwenden
--help, -hHilfe, auch je Befehl: trunkbeam numbers --help

Befehle

BefehlWas er macht
login, logoutCLI anmelden oder abmelden
accountKonto, Prüfstatus, Tarif und Rechte des Schlüssels
sitesStandorte mit ID; nur geprüfte bekommen Ortsnetznummern
onkz <ort oder vorwahl>Ortsnetz suchen, zum Beispiel onkz Schramberg
numbers lsDeine Nummern mit ID, Status und Ziel
numbers order --site <id>Ortsnetznummer am Standort bestellen, zeigt erst den Preis
numbers order --032032-Nummer ohne Ortsbezug bestellen
numbers connect <id> --elevenlabsNummer 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 resetWeiterleitung an Menschen, als Standard oder je Nummer
hold-musicWartemusik mit Beschreibung
calls lsLetzte Anrufe mit Dauer, Status und Kosten
usage --month <JJJJ-MM>Nutzung und Kosten eines Monats
pricesTarife 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

CodeBedeutung
0Erfolgreich
1Fehler oder abgebrochen
2Falscher Aufruf
Deinen Stack mit TrunkBeam verbinden