bird voice tools test-call

bird voice tools test-call <e164> [flags]

Places a single real call through one of your trunks, to prove the trunk works before you point a PBX at it. It writes a throwaway account file into a temporary directory, runs baresip against it for --duration, and deletes the directory as soon as the call ends.

The call is carried and billed like any other, and it appears in the call log. Audio uses this machine's microphone and speakers. baresip must be on PATH (brew install baresip, apt install baresip).

On a trunk that allows session credentials, the SIP password is one this command mints for the call: it expires within minutes, so nothing long-lived is written to disk. Minting needs the voice:write scope, which a plain bird auth login does not hold. A trunk that allows none falls back to an API key's own secret, taken from BIRD_VOICE_TEST_CALL_API_KEY if set, otherwise from BIRD_API_KEY when that is how the CLI is authenticated — and that key must be allowed on the trunk, which is a dashboard step this command cannot take. So is verifying the caller ID. --dry-run prints the account file and the command without dialing; it still mints, because the line is of no use to another SIP client without a password.

By default baresip's own console output is reduced to a few status lines and a peak-audio summary, where a zero in one direction is the one-way-audio symptom. --raw prints its stream byte-for-byte instead, and --verbose adds a SIP trace to that.

--trunk and --caller-id default to the workspace's first trunk and first verified caller ID, which is what makes a bare test call one argument; both are printed when they are inferred.

bird voice tools test-call +31612345678
bird voice tools test-call +31612345678 --trunk spt_01hx... --caller-id +31201234567 --protocol udp