Zadarma Integration

PBX

## Step 1: Gather Your SIP Credentials

1. Log in to your [Zadarma Dashboard](https://my.zadarma.com)
2. Go to **My PBX** → **Extensions**

3. Find your extension and note these details:

```
Extension: e.g., 510000-100
Server address: pbx.zadarma.com
Username: Your extension username (e.g., 510000-100)
Password: Your extension password
Phone number: Your phone number (e.g., +521151900966)
```

## Step 2: Set Up External Server (for inbound calls)

To receive inbound calls, you need to configure an **External Server** in Zadarma that forwards incoming calls to the platform's SIP server.

1. In your [Zadarma Dashboard](https://my.zadarma.com), go to **Settings** → [**Virtual phone numbers**](https://my.zadarma.com/dirnum/active/)

2. Find the number you want to connect and click the **gear icon** to open its settings

3. Click **External Server** and enable the **SIP URI** checkbox

4. Enter the SIP server address using your **phone number with the `+` prefix**:

```
+YOUR_PHONE_NUMBER@5wed79aeavr.sip.livekit.cloud
```

For example, if your number is `+551151900966`:

```
+521151900966@5wed79aeavr.sip.livekit.cloud
```

5. Click **Show IP** below the server address to reveal Zadarma's IP addresses (e.g., `185.45.152.216`, `185.45.155.33`)

**Save these IPs** — you will need them in Step 3 when configuring inbound authorization in the platform.

**PBX users must use the phone number with `+`** in the External Server address. Using the PBX extension number (e.g., `533177-100`) will **not** work for inbound calls.

## Step 3: Import Numbers to the Platform

Now import the number so the platform knows how to route calls.

1. Go directly to the Phone Numbers page in your dashboard:

   **[https://app.voxlink.ai/phone-numbers](https://app.voxlink.ai/phone-numbers)**

   If it takes you to the login page, log in first — it will automatically redirect you to the Phone Numbers page.

2. Click **"Integrate SIP trunk"** (top-right corner of the page)

3. Fill in your phone number and SIP credentials:

```
Phone number: e.g., +551151900966
Username: Your PBX extension (e.g., 533100-100)
Your SIP Extension: Your phone number (e.g., +551151900966)
Password: Your PBX extension password
```

**PBX users:** The **Username** is your PBX extension (e.g., `533100-100`). The **"Your SIP Extension"** field must be your **phone number** — this must match the number you used in the External Server address in Step 2.

4. Enter the **Server address** for outbound calls:

```
pbx.zadarma.com
```

5. Select the **Authorization type**. Select **IP** and add the Zadarma IP addresses you noted earlier from **Show IP** in Step 2.

6. Select the **country** where your SIP trunk is located.

## Step 4: Verify Setup

1. Make a test call to your number
2. Check that the AI assistant answers
3. Use the test call feature to verify outbound calling

SIP Direct

## Step 1: Gather Your SIP Credentials

1. Log in to your [Zadarma Dashboard](https://my.zadarma.com)
2. Go to **Settings** → **SIP Connection**

3. Note these details:

```
Server address: sip.zadarma.com
Extension: Your SIP extension number (e.g., 247000)
Username: Your SIP username (the same as your extension e.g., 247000)
Password: Your SIP password
```

## Step 2: Set Up External Server (for inbound calls)

To receive inbound calls, you need to configure an **External Server** in Zadarma that forwards incoming calls to the platform's SIP server.

1. In your [Zadarma Dashboard](https://my.zadarma.com), go to **Settings** → [**Virtual phone numbers**](https://my.zadarma.com/dirnum/active/)

2. Find the number you want to connect and click the **gear icon** to open its settings

3. Click **External Server** and enable the **SIP URI** checkbox

4. Enter the SIP server address using your **SIP extension number**:

```
YOUR_EXTENSION@5wed79aeavr.sip.livekit.cloud
```

For example, if your extension is `247000`:

```
247000@5wed79aeavr.sip.livekit.cloud
```

5. Click **Show IP** below the server address to reveal Zadarma's IP addresses (e.g., `185.45.152.216`, `185.45.155.33`)

**Save these IPs** — you will need them in Step 3 when configuring inbound authorization in the platform.

## Step 3: Import Numbers to the Platform

Now import the number so the platform knows how to route calls.

1. Go directly to the Phone Numbers page in your dashboard:

   **[https://app.voxlink.ai/phone-numbers](https://app.voxlink.ai/phone-numbers)**

   If it takes you to the login page, log in first — it will automatically redirect you to the Phone Numbers page.

2. Click **"Integrate SIP trunk"** (top-right corner of the page)

3. Fill in your phone number and SIP credentials:

```
Phone number: e.g., +1 555 0123
Your SIP Extension: Your SIP extension number (e.g., 247000)
Username: Your SIP username (the same as your extension e.g., 247000)
Password: Your SIP password
```

4. Enter the **Server address** for outbound calls:

```
sip.zadarma.com
```

5. Select the **Authorization type**. Select **IP** and add the Zadarma IP addresses you noted earlier from **Show IP** in Step 2.

6. Select the **country** where your SIP trunk is located.

## Step 4: Verify Setup

1. Make a test call to your number
2. Check that the AI assistant answers
3. Use the test call feature to verify outbound calling