> ## Documentation Index
> Fetch the complete documentation index at: https://www.vobiz.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Cartesia + Vobiz — Connect Cartesia Voice Agents to Phone Numbers

> Connect a Cartesia voice agent to a Vobiz phone number with SIP trunking. Create a Vobiz outbound and inbound trunk, import the number into Cartesia, and your agent can place and answer real phone calls.

This guide connects a [Cartesia](https://play.cartesia.ai/agents) voice agent to a Vobiz phone number, so the agent can place outbound calls and answer inbound calls on that number. Everything is done in the Cartesia and Vobiz dashboards.

## What you'll build

Two trunks on the same Vobiz number, one for each direction:

| Direction | Path |
| - | - |
| **Outbound** | Cartesia agent → Vobiz **outbound** trunk (SIP digest auth) → PSTN |
| **Inbound** | Caller → your Vobiz number → Vobiz **inbound** trunk → `sip.cartesia.ai` → Cartesia agent |

Inbound is trunk-based routing. No Vobiz [application](https://www.vobiz.ai/docs/applications.md) or answer webhook is involved.

## Prerequisites

* **Cartesia account** → [Sign in](https://play.cartesia.ai/agents)
* **Vobiz account** with active balance → [Create account](https://console.vobiz.ai/auth/signup)
* **A Cartesia agent** — start from a template or from scratch (Step 1 below)
* **A Vobiz phone number** — the caller ID for outbound calls and the number callers dial for inbound (Step 2 below)

## Step 1: Create an agent in Cartesia

**1. Open Agents**

In the [Cartesia dashboard](https://play.cartesia.ai/agents), open **Agents** and click **Create New**. Pick a template, such as **Customer Support**, or **Start from scratch**.

![Cartesia dashboard: Agents page with templates and Start from scratch](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/02-cartesia-agents.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=73b5b42e78106afec6ed58e479e07237)

**2. Check Phone Numbers**

Open **Phone Numbers** under **Deployment**. It's empty until you import your Vobiz number in Step 5.

![Cartesia dashboard: empty Phone Numbers page with Create Number button](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/01-cartesia-phone-numbers.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=a5da4b86f3ebc69575835dca3e46c7f1)

## Step 2: Get a Vobiz phone number

Skip this step if you already have a Vobiz number you want to use.

**1. Open Buy number**

Log in to the [Vobiz Console](https://console.vobiz.ai/app/dashboard) and click **Buy number** under **Quick actions**.

![Vobiz Console dashboard with the Buy number quick action](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/04-vobiz-dashboard.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=8685835ad4ed5bfedea94c73bbb7ea27)

**2. Choose a country**

Search for the country you want a number in.

![Vobiz Console: search numbers by country](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/05-vobiz-search-country.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=7937d1c34684b4db4701f68c280d685f)

**3. Pick a number**

Choose a number from the **Numbers Inventory** with **Voice** in **Supported features**, add it to the cart, and click **Proceed to checkout**.

![Vobiz Console: Numbers Inventory listing local numbers with Voice support and monthly price](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/06-vobiz-numbers-inventory.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=8d48aa3b0bb892a48b1e877c8c801d52)

**4. Confirm the purchase**

Review the cost breakdown and click **Confirm & Buy**. The setup fee and the first month's rent are charged to your balance.

![Vobiz Console: Confirm Purchase panel with cost breakdown](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/07-vobiz-confirm-purchase.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=2ee2d1e5dea05e1a2111276e25289718)

**5. Find the number in My Number**

Your new number appears under **Numbers → My Number**.

![Vobiz Console: My Number list of numbers on the account](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/08-vobiz-my-numbers.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=66873b3345d352d27715f51536949c40)

## Step 3: Create the outbound trunk in Vobiz

Cartesia sends outbound calls to this trunk, signing in with a SIP credential.

**1. Open outbound trunks**

Go to **SIP Trunk → Outbound Trunk** and click **Create trunk**.

![Vobiz Console: Outbound Trunk list with the Create trunk button](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/09-vobiz-outbound-trunks.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=7d0f04b49a5c962a4ecd815a822b4b91)

**2. Name the trunk**

Enter a **Trunk Name**, for example `Cartesia`. Call recording and transcription are optional.

![Vobiz Console: Create Outbound Trunk form](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/10-vobiz-create-outbound-trunk.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=4987088eeb11917acc9aa00064e52f50)

**3. Create a SIP credential**

Under **Authentication & Linking**, click **Create New Credential**. Enter a username and password and keep **Active** on.

![Vobiz Console: Create New Credentials List with example username cartesia and password](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/11-vobiz-create-credential.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=7365c12754623467b7340a9f843db458)

The username can't contain special characters. The password must be 5–20 characters and include at least one of `~!@#$%^&*()_+`. The values shown are an example — choose your own strong password.

**4. Select the credential and create the trunk**

Select the credential in **Credentials List** and click **Create Trunk**.

![Vobiz Console: Create Outbound Trunk form with the cartesia credential selected](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/12-vobiz-outbound-trunk-filled.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=408bba54e3b33237a15ff14ae71076fb)

**5. Copy the SIP domain**

Open the new trunk and confirm it shows **Enabled**. Copy the **SIP Domain** (for example, `abc123.sip.vobiz.ai`) — you enter it in Cartesia in Step 5.

![Vobiz Console: Cartesia outbound trunk details with SIP domain and the cartesia SIP credential](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/13-vobiz-outbound-trunk-details.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=e872a5c8813e3e4f20d255446b42cbdb)

## Step 4: Create the inbound trunk in Vobiz

The inbound trunk forwards calls on your number to Cartesia's SIP address.

**1. Create the inbound trunk**

Go to [**SIP Trunk → Inbound Trunk**](https://console.vobiz.ai/app/sip/in/trunks) and create a trunk. Name it, for example `cartesia`.

**2. Add Cartesia's origination URI**

Under **Origination URI**, click **Add New URI**:

| Field | Value |
| - | - |
| Name | A label, for example `cartesia` |
| URI | `sip.cartesia.ai` |
| Transport | **TCP** |

Cartesia accepts SIP over TCP or TLS, not UDP.

> [!WARNING]
>
> **Enter the host with no `sip:` prefix and no port.** If the console warns about the URI format, click **Save anyway**.

Select the URI and click **Create Trunk**.

![Vobiz Console: Create Inbound Trunk form with origination URI sip.cartesia.ai](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/15-vobiz-create-inbound-trunk.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=65f5f4fd9ed605497fe27445ca1913ca)

**3. Link your number**

In **Link trunk with Phone Numbers**, select the Vobiz number from Step 2 and click **Link 1 Selected Number**.

![Vobiz Console: linking the selected phone number to the cartesia inbound trunk](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/16-vobiz-link-number.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=f0303c5d771fa9f4c6fb3265ee3b73f8)

**4. Check the trunk**

The trunk shows **Linked Numbers (1)** with your number.

![Vobiz Console: cartesia inbound trunk details with one linked number](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/17-vobiz-inbound-trunk-details.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=027f0c2a0596f25d7d6cf8f7fc2b2e58)

## Step 5: Import the number into Cartesia

**1. Import from SIP Trunk**

In Cartesia, open **Phone Numbers**, click **Create Number**, and choose **Import from SIP Trunk**.

![Cartesia dashboard: Create Number menu with Import from SIP Trunk](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/03-cartesia-create-number.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=59aedbb08d5acc36536c1a9e8eb4c128)

Enter your Vobiz number in E.164 format (for example, `+14155550100`), a name, and `vobiz` as the provider name.

**2. Fill in the outbound configuration**

Under **Outbound Configuration**, enter:

| Field | Value |
| - | - |
| Address | Your Vobiz outbound trunk SIP domain from Step 3 (for example, `abc123.sip.vobiz.ai`) — no `sip:` prefix |
| Transport | **TCP** |
| SIP Trunk Username | The credential username from Step 3 |
| SIP Trunk Password | The credential password from Step 3 |

![Cartesia dashboard: Outbound Configuration with address, transport, and SIP trunk credentials](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/14-cartesia-outbound-config.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=b6e82246a4d82396327cea27fa01d14a)

Save the number.

**3. Assign the inbound agent**

Open the number. Under **Inbound Agent**, choose the agent from Step 1. Check that **Outbound** shows your Vobiz SIP domain and **TCP**.

![Cartesia dashboard: phone number details with the inbound agent, Cartesia SIP URIs, and the vobiz SIP trunk provider](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/18-cartesia-number-details.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=c32f26d092ddca1142a7ac3db08ee88b)

## Step 6: Test calls

**1. Place an outbound call**

Open your agent in Cartesia and click the phone number at the top. Under **Outbound calls**, enter a number you own in **To** and click **Place call**. Your phone rings with the Vobiz number as caller ID.

![Cartesia dashboard: Outbound calls panel with From number and Place call button](https://mintcdn.com/vobizai/ZFq1X_vwrFy2xivl/images/cartesia/19-cartesia-place-call.png?fit=max\&auto=format\&n=ZFq1X_vwrFy2xivl\&q=85\&s=156e3c7e452e24aafc8078ffc60c4dd3)

**2. Make an inbound call**

From any phone, call your Vobiz number. The Cartesia agent answers.

> [!TIP]
>
> **Your Cartesia agent is live on Vobiz.** It places calls through your outbound trunk and answers calls to your number through the inbound trunk.

Calls are billed to your Vobiz balance at your account's rates. Call only numbers you have consent to call.

## Troubleshooting

### Outbound calls fail to connect

* Check that **Address** in Cartesia is the outbound trunk's SIP domain, with no `sip:` prefix.
* Check that the username and password in Cartesia match the Vobiz credential, and that the credential is **Active**.
* Check that the outbound trunk is **Enabled** and your Vobiz balance is positive.

### Inbound calls don't reach the agent

* Check that the number is linked to the inbound trunk (**Linked Numbers (1)**).
* Check that the origination URI is `sip.cartesia.ai` with **TCP** transport.
* Check that an **Inbound Agent** is assigned to the number in Cartesia.

## Related

* [SIP trunks](https://www.vobiz.ai/docs/trunks.md)
* [Origination URIs](https://www.vobiz.ai/docs/trunks/origination-uri.md)
* [Call recording on trunks](https://www.vobiz.ai/docs/concepts/callbacks.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.