Skip to main content
LLM ReadyRaw Markdown for AI agents:sip-devices.mdFull index:llms.txtllms-full.txt

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 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​

SettingValue
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
PasswordYour SIP Account password
Port5060 (UDP / TCP) · 5061 (TLS)
TransportUDP or TCP (TCP recommended behind NAT) · TLS for encrypted signaling
Outbound proxyLeave 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.

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 [email protected].
  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).

Account → Register → select Account 1:

FieldValue
Line ActiveEnabled
Label / Display NameAny name
Register Nameusername
User Nameusername
PasswordSIP Account password
SIP Server 1 → Server Hostyourcompany.phone.firetell.app
SIP Server 1 → Port5060
SIP Server 1 → TransportTCP (or UDP)
Outbound Proxy ServerDisabled

Click Confirm. Register Status turns to Registered.

Grandstream (GXP, GRP, WP series)​

Accounts → Account 1 → General Settings:

FieldValue
Account ActiveYes
SIP Serveryourcompany.phone.firetell.app
Outbound ProxyLeave empty
SIP User IDusername
SIP Authentication IDusername
SIP Authentication PasswordSIP Account password
NameAny 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:

FieldValue
ActivateChecked
Usernameusername
Authentication Userusername
Authentication PasswordSIP Account password
Display NameAny name
SIP Proxy Server Addressyourcompany.phone.firetell.app
SIP Proxy Server Port5060
Outbound Proxy Server AddressLeave empty
Transport ProtocolTCP (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.

  • 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​

SymptomLikely causeFix
401 Unauthorized repeats, never registersWrong password, or the port was typed into the Domain fieldRe-enter the password; remove :port from Domain. Delete and re-create the account on the device to clear cached credentials.
403 Forbidden auth IDUsername and Authentication ID differSet User ID / User Name and Auth ID / Register Name to the same SIP Account username.
403 Direct IP host is not allowedDomain is an IP addressUse yourcompany.phone.firetell.app, never an IP address.
404 Unknown domainDomain is misspelled or belongs to another workspace/regionCopy the domain again from Device login settings in the Console.
Registered, but no incoming calls after a whileNAT binding expiredUse TCP transport, enable NAT keep-alive, or lower the registration expiry.
Call connects but one-way or no audioFirewall blocks RTP mediaAllow outbound UDP for RTP and disable SIP ALG on your router.
Device is blocked / no responseToo many failed logins from your IPFix the credentials and wait a few minutes before retrying.
403 Account temporarily lockedToo 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.