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
- Log in to Firetell Console and select your workspace.
- Go to Call Center → SIP Accounts.
- Click Add SIP Account, enter a friendly name, a username and a strong password.
- Copy the values shown in the Device login settings panel at the top of the page.
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.
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)
- Open Zoiper and choose Continue as a Free user (or sign in to Zoiper Pro).
- In Login, enter
[email protected]. - In Password, enter the SIP Account password and click Login.
- In Hostname or provider, keep
yourcompany.phone.firetell.appand click Next. - Skip Authentication and Outbound proxy (leave unchecked) and click Next.
- Zoiper tests the transports — select SIP TCP (or SIP UDP) and click Next.
Linphone (desktop & mobile)
- Open Assistant → Use a SIP account (or Account → Add an account → SIP account).
- Fill in:
- Username:
username - Password: SIP Account password
- Domain:
yourcompany.phone.firetell.app - Transport:
TCP(orUDP)
- Username:
- Leave Outbound proxy / SIP proxy empty and click Use / Login.
MicroSIP (Windows)
- Open the menu ▾ → Add Account.
- 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(orUDP)
- SIP Server:
- Click Save. The status bar shows Online when registered.
Bria (Windows, macOS, iOS, Android)
- Go to Account Settings (or Preferences → Accounts) → Add → SIP Account.
- Fill in:
- User ID:
username - Domain:
yourcompany.phone.firetell.app - Password: SIP Account password
- Authorization name:
username
- User ID:
- Under Domain Proxy, keep Register with domain and receive calls enabled and leave Proxy address empty.
- 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.
To connect a whole PBX with many extensions and phone numbers, use SIP Trunking instead of individual SIP Accounts.
Recommended settings
- Registration expiry:
600seconds (allowed range 60–3600). - NAT keep-alive: enable it if the device offers it (e.g.
30seconds). Firetell also sends keep-alives to devices behind NAT. - Codecs: enable
G.711 µ-law (PCMU)andG.711 A-law (PCMA);OpusandG.722are 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. |
For security, repeated failed logins or abnormal traffic from the same IP address are temporarily blocked.