---
sidebar_position: 4
title: Connect SIP Devices
description: Sign in desk phones, softphones and IP-PBX extensions (Zoiper, Linphone, MicroSIP, Bria, Yealink, Grandstream, Fanvil) to your Firetell workspace with a SIP Account.
---

# Connect SIP Devices

A **SIP Account** lets any standard SIP device — desk phone, softphone or IP-PBX extension — register to your Firetell workspace to make and receive calls.

You only need three values: **username**, **password** and your workspace **SIP domain**. No outbound proxy or IP address is required.

## Before you start

1. Log in to [Firetell Console](https://console.firetell.com) and select your workspace.
2. Go to **Call Center** → **SIP Accounts**.
3. Click **Add SIP Account**, enter a friendly name, a username and a strong password.
4. Copy the values shown in the **Device login settings** panel at the top of the page.

:::tip
Enable **Allow outbound calls** and pick an **Outbound Caller ID** on the SIP Account if the device needs to call external phone numbers.
:::

## Your SIP settings

| Setting                                        | Value                                                                          |
| ---------------------------------------------- | ------------------------------------------------------------------------------ |
| **Domain / Server / Registrar**                | `{workspace_id}.phone.{regional_domain}` — e.g. `yourcompany.phone.firetell.app` |
| **Username** (User ID, Auth ID, Register Name) | Your SIP Account username                                                      |
| **Password**                                   | Your SIP Account password                                                      |
| **Port**                                       | `5060` (UDP / TCP) · `5061` (TLS)                                              |
| **Transport**                                  | UDP or TCP (TCP recommended behind NAT) · TLS for encrypted signaling          |
| **Outbound proxy**                             | Leave empty                                                                    |
| **SIP address (AOR)**                          | `username@{workspace_id}.phone.{regional_domain}`                                |

The **region domain** depends on the region your workspace was created in, for example `firetell.app` for APAC region. Always copy the exact domain from the Console — it is shown in **Device login settings** and in the **SIP Address** column of each account.

:::caution[Do not add the port to the Domain field]
Enter the domain **without** `:port`. Some devices (for example Linphone) treat `domain:port` as an IPv6 address and the login fails. If your device needs a non-default port, use its dedicated **Port** field.
:::

## Softphones

### Zoiper 5 (Windows, macOS, Linux, iOS, Android)

1. Open Zoiper and choose **Continue as a Free user** (or sign in to Zoiper Pro).
2. In **Login**, enter `username@yourcompany.phone.firetell.app`.
3. In **Password**, enter the SIP Account password and click **Login**.
4. In **Hostname or provider**, keep `yourcompany.phone.firetell.app` and click **Next**.
5. Skip **Authentication and Outbound proxy** (leave unchecked) and click **Next**.
6. Zoiper tests the transports — select **SIP TCP** (or **SIP UDP**) and click **Next**.

### Linphone (desktop & mobile)

1. Open **Assistant** → **Use a SIP account** (or **Account** → **Add an account** → **SIP account**).
2. Fill in:
   - **Username**: `username`
   - **Password**: SIP Account password
   - **Domain**: `yourcompany.phone.firetell.app`
   - **Transport**: `TCP` (or `UDP`)
3. Leave **Outbound proxy** / **SIP proxy** empty and click **Use** / **Login**.

### MicroSIP (Windows)

1. Open the menu ▾ → **Add Account**.
2. Fill in:
   - **SIP Server**: `yourcompany.phone.firetell.app`
   - **SIP Proxy**: leave empty
   - **Username**: `username`
   - **Domain**: `yourcompany.phone.firetell.app`
   - **Login**: `username`
   - **Password**: SIP Account password
   - **Transport**: `TCP` (or `UDP`)
3. Click **Save**. The status bar shows **Online** when registered.

### Bria (Windows, macOS, iOS, Android)

1. Go to **Account Settings** (or **Preferences** → **Accounts**) → **Add** → **SIP Account**.
2. Fill in:
   - **User ID**: `username`
   - **Domain**: `yourcompany.phone.firetell.app`
   - **Password**: SIP Account password
   - **Authorization name**: `username`
3. Under **Domain Proxy**, keep **Register with domain and receive calls** enabled and leave **Proxy address** empty.
4. Under **Advanced** / **Transport**, choose **TCP** (or **UDP**) and save.

## Desk phones

Open the phone's web interface by entering its IP address in a browser (shown in the phone menu under **Status** / **Network**).

### Yealink (T3x, T4x, T5x series)

**Account** → **Register** → select **Account 1**:

| Field                      | Value                            |
| -------------------------- | -------------------------------- |
| Line Active                | `Enabled`                        |
| Label / Display Name       | Any name                         |
| Register Name              | `username`                       |
| User Name                  | `username`                       |
| Password                   | SIP Account password             |
| SIP Server 1 → Server Host | `yourcompany.phone.firetell.app` |
| SIP Server 1 → Port        | `5060`                           |
| SIP Server 1 → Transport   | `TCP` (or `UDP`)                 |
| Outbound Proxy Server      | `Disabled`                       |

Click **Confirm**. **Register Status** turns to **Registered**.

### Grandstream (GXP, GRP, WP series)

**Accounts** → **Account 1** → **General Settings**:

| Field                       | Value                            |
| --------------------------- | -------------------------------- |
| Account Active              | `Yes`                            |
| SIP Server                  | `yourcompany.phone.firetell.app` |
| Outbound Proxy              | Leave empty                      |
| SIP User ID                 | `username`                       |
| SIP Authentication ID       | `username`                       |
| SIP Authentication Password | SIP Account password             |
| Name                        | Any name                         |

Then **Accounts** → **Account 1** → **SIP Settings** → **Basic Settings** → **SIP Transport**: `TCP` (or `UDP`). Click **Save and Apply**.

### Fanvil (X series)

**Line** → **SIP** → select **SIP1**:

| Field                         | Value                            |
| ----------------------------- | -------------------------------- |
| Activate                      | Checked                          |
| Username                      | `username`                       |
| Authentication User           | `username`                       |
| Authentication Password       | SIP Account password             |
| Display Name                  | Any name                         |
| SIP Proxy Server Address      | `yourcompany.phone.firetell.app` |
| SIP Proxy Server Port         | `5060`                           |
| Outbound Proxy Server Address | Leave empty                      |
| Transport Protocol            | `TCP` (or `UDP`)                 |

Click **Apply**. The line status shows **Registered**.

## IP-PBX extensions

To register an extension of your own PBX (FreePBX, 3CX, Asterisk…) as a Firetell SIP Account, create an outbound **registration / trunk** on the PBX using the same values: server `yourcompany.phone.firetell.app`, port `5060`, username and password of the SIP Account, no outbound proxy.

:::info
To connect a whole PBX with many extensions and phone numbers, use **SIP Trunking** instead of individual SIP Accounts.
:::

## Recommended settings

- **Registration expiry**: `600` seconds (allowed range 60–3600).
- **NAT keep-alive**: enable it if the device offers it (e.g. `30` seconds). Firetell also sends keep-alives to devices behind NAT.
- **Codecs**: enable `G.711 µ-law (PCMU)` and `G.711 A-law (PCMA)`; `Opus` and `G.722` are optional.
- **STUN / ICE**: not required — leave disabled unless your network team requires it.
- **Multiple devices**: one SIP Account can be registered on up to **5 devices** at the same time; incoming calls ring all of them.

## Troubleshooting

| Symptom                                         | Likely cause                                                | Fix                                                                                                                            |
| ----------------------------------------------- | ----------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `401 Unauthorized` repeats, never registers     | Wrong password, or the port was typed into the Domain field | Re-enter the password; remove `:port` from Domain. Delete and re-create the account on the device to clear cached credentials. |
| `403 Forbidden auth ID`                         | Username and Authentication ID differ                       | Set **User ID / User Name** and **Auth ID / Register Name** to the same SIP Account username.                                  |
| `403 Direct IP host is not allowed`             | Domain is an IP address                                     | Use `yourcompany.phone.firetell.app`, never an IP address.                                                                     |
| `404 Unknown domain`                            | Domain is misspelled or belongs to another workspace/region | Copy the domain again from **Device login settings** in the Console.                                                           |
| Registered, but no incoming calls after a while | NAT binding expired                                         | Use TCP transport, enable NAT keep-alive, or lower the registration expiry.                                                    |
| Call connects but one-way or no audio           | Firewall blocks RTP media                                   | Allow outbound UDP for RTP and disable SIP ALG on your router.                                                                 |
| Device is blocked / no response                 | Too many failed logins from your IP                         | Fix the credentials and wait a few minutes before retrying.                                                                    |
| `403 Account temporarily locked`                | Too many failed logins for this SIP Account (from any IP)   | Wait 15 minutes, then sign in with the correct password. Reset the password in the Console if you suspect it leaked.           |

:::note
For security, repeated failed logins or abnormal traffic from the same IP address are temporarily blocked.
:::
