Bird Voice

Build calls around your customers.

Connect your phone system, build a calling workflow or bring an AI agent to the phone network. Manage numbers, routing and call records in one workspace, with the context to follow each conversation.

Cursor

Voice workspace

Example
01

Your number

An incoming customer call

02

Your application

Route the conversation to the right place

FIELDNOTES · CUSTOMER CARE

A better conversation.

Customer connected

Your number. Your application.

02:14

03

Follow the outcome

Call events, sessions and recorded evidence.

Illustrative call journey and duration. Your application defines the conversation.

Trusted every day by teams that build world-class software

Read more customer stories

Programmable voice

Give the caller a useful next step.

Build a greeting, offer a choice and route the response. Call sequences connect spoken prompts and keypad input to the workflow your customer needs.

01

Design the conversation

Combine prompts, menu choices and named branches in a versioned sequence.

02

Test before you publish

Try the paths with a number you control. Ongoing calls keep the version they started with.

A menu with a purpose

Example

Service information

“Press 1 for opening hours, or 2 for directions.”

Read the opening hours

The hours sequence speaks the opening times and ends the call.

Published version · calls keep the version they start with

Interactive workflow example. Selections change this illustration only.

Every call, on the record.

Read every call from the language you already use.

Follow the call behind a customer interaction. List a workspace’s calls or retrieve one record to inspect its status, duration and rated cost. Use the same operational view across your phone system, browser calls and programmable workflows.

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

PagerDuty

“Our business is built on trust”

Leeor Engel, Senior Engineering Manager at PagerDuty

Customer story

When the call matters, the connection matters.

PagerDuty relies on Bird’s telecommunications infrastructure to deliver critical notifications worldwide, helping its customers respond when their digital services need attention.

Read the PagerDuty story

Planning your calling infrastructure?

Contact sales

From connection to outcome

The call is one part of the customer journey.

A ringing phone is the start. Confirm an appointment, collect a useful response, resolve a question or connect the caller to the right person. Design the successful path and the next step when the call cannot complete it.

Bring the call or session identity into the application that owns the outcome. A connected call and a confirmed booking answer different questions; keeping them together makes the experience easier to improve.

Behind the conversation

Find the call behind the customer’s question.

Read one call to inspect its status and direction. Once it ends, follow its duration, billable time and rated cost. Bring the call identity into your application so the next person has the context they need.

read-call.ts
GET
const call = await bird.voice.get("vcl_01k0p3v9wera3v6q6xw3e9y2mh");
// A call still ringing or connected carries no economics yet.
call.status; // "answered" | "no_answer" | "ringing" | …

Follow the call through its events.

Each one carries the same call identity fields, so a consumer can follow a call from the first ring to its outcome.

POST /webhooks/bird
signed
{
  "type": "voice_call.ended",
  "timestamp": "2026-06-10T14:31:22Z",
  "data": {
    "call_id": "vcl_01krdgeqcxet5s7t44vh8rt9mg",
    "session_id": null,
    "workspace_id": "wsp_01jz8w1yfhe7xt4m0q9v3n5c2r",
    "direction": "outbound",
    "from": "+14155550199",
    "to": "+442071838750",
    "status": "answered"
  }
}

Verify signatures and deduplicate deliveries on webhook-id. Events can arrive out of order; reconcile the final outcome with the call record.

  • voice_call.initiatedBird received the INVITE and began routing.
  • voice_call.answeredThe recipient answered and billable time started. An unanswered call does not emit this event.
  • voice_call.endedThe call is over, and the payload adds how it ended: answered, no_answer, failed, rejected or unknown.

Per-minute, country-dependent.

Review current destination rates and the components relevant to your call. Forwarding can create separately rated inbound and outbound legs.

Send your first request before you write any code.

The whole public API is a Postman collection, converted from the same OpenAPI specification the SDKs are generated from, with an example request and response on every endpoint. Fork it into your own workspace, set an API key, and send a live request.

Questions about Bird Voice

What can I build with Bird Voice?
Connect a PBX over SIP, route incoming calls, place browser calls and build programmable menus or notifications with call sequences. Connect a compatible conversational runtime for AI voice, then follow call records, sessions and available artifacts.
Should I start with SIP trunking or programmable calls?
Use SIP when your existing phone system or application already controls call behavior. Use call sequences when you want Bird to execute defined prompts, keypad choices and recording steps. AI conversations add a runtime that manages live speech and business decisions.
Can I bring my own AI voice application?
Yes, when the application supports the SIP and media connection it needs. Bird provides the telephone connection; your application chooses its speech, model, tools and handoff behavior.
Should I sign up or speak to sales?
Start with a workspace for a controlled SIP or browser call. Talk to a Voice specialist when planning an AI integration, number migration, complex routing or a larger production rollout.
How do I know whether a call worked?
Use the call record and events to establish whether it connected and how it ended. Confirm a booking, resolved case or other task in the business application that performed it.

Put it into practice.

Continue with the documentation, guides and examples for this topic. Resources are in English.

Get an implementation brief

Talk to our Voice team

Start with one useful call.

Choose a SIP connection, browser phone or calling workflow. Test with a number you control, then plan the destinations and capacity your customers need.

Your details

All contact fields are required.

So our team can reach you about your demo.

Products of interest

Optional

We’ll contact you to arrange your demo.
Privacy policy

Start with one channel.
Add the others when you're ready.

A test API key is yours immediately. Production unlocks when you add a payment method and verify a sender.

Using Claude Code, Cursor, or Codex? Copy a setup prompt and your agent installs the Bird CLI and skills for you. Pick yours:

Cursor