Place your first call

Place a real phone call from the dashboard. The dashboard phone is a SIP client that uses the same trunk, caller ID, and destination settings as your phone system.

After the call, you can inspect its record in the dashboard or through the Voice API.

Prerequisites

Before you start, make sure you have:

A workspace with Phone under Voice. The dashboard shows it when your workspace region supports browser calling and you have Voice access at the Write level.
A phone number you own and a phone that can answer the verification and test calls.
A browser with a working microphone.

1. Open the phone

Select Voice > Phone in the dashboard. The phone opens in a floating window and remains open as you navigate.

If your workspace is not ready to place calls, the phone displays Finish setup to place calls. Its checklist identifies each missing requirement and links to the required action. Creating a call-ready trunk and verifying a caller ID completes the checklist.

2. Create a call-ready trunk

Select Create a trunk from the checklist. Enter a name, then select Create trunk.

The dashboard enables outbound calling and session credentials when it creates the trunk. The trunk also offers the MD5 digest that the browser uses. The checklist marks every trunk requirement as complete.

3. Verify your caller ID

Select Verify a number you own from the checklist. Enter a number you own in the Phone number field using E.164 format: a leading +, the country code, and the national number. Then select Send verification call.

Answer the verification call and listen for the six-digit code. Enter it in the Verification code field, then select Verify caller ID.

The dashboard displays Caller ID verified, removes the setup notice, and adds the number to the phone's From row.

for await (const call of bird.voice.list({ status: ["ringing", "in_progress"] })) {
  console.log(call.id, call.status);
}

for call in client.voice.list(status=["ringing", "in_progress"]):
    print(call.id, call.status)

for call, err := range client.Voice.List(context.Background(), bird.VoiceListParams{
	Status: []bird.VoiceCallStatus{"ringing", "in_progress"},
}) {
	if err != nil {
		log.Fatal(err)
	}
	fmt.Println(call.Id, call.Status)
}

foreach ($bird->voice->list(['status' => ['ringing', 'in_progress']]) as $call) {
    echo $call->getId(), ' ', $call->getStatus(), "\n";
}

bird voice list

curl -X GET "https://{region}.platform.bird.com/v1/voice/calls" \
  -H "Authorization: Bearer $TOKEN" \
  --url-query "limit=25"

Use the call record to investigate future call failures. A refused call stores its cause in rejection_reason. For dashboard filters, record fields, and API access, see the call log guide.

Troubleshoot the test call

The phone still displays Finish setup to place calls: Complete each unchecked requirement using the link in its checklist row.
The phone displays a rejection reason: destination_not_enabled means the destination country is disabled. caller_id_not_verified means the number in the From row is not verified. The rejected calls reference covers every reason and its resolution.
The call connects, but one side has no audio: Check your browser's microphone permission and the microphone picker in the phone. The in-call controls guide covers the device pickers.

Voice troubleshooting works through the same symptoms for any client.

Next steps

Test calls from the terminal: place the same call with bird voice tools test-call.
Set up a SIP client: connect Asterisk, FreePBX, Zoiper, or another client to the trunk.
Configure SIP trunks: review the settings enabled by the call-ready trunk and other admission methods.
Place calls: understand how the platform routes and prices calls.
Inspect the call log: filter records, review fields, retrieve calls through the API, or export CSV data.
Subscribe to voice events: send call outcomes to your systems instead of polling.