How to Connect a VoIP Deskphone to Sparkforge

By Sparkforge Support Team ·Last reviewed May 3, 2026

Open Sub-Account Settings > Phone Numbers > Advanced > VoIP Deskphone (SIP), generate a SIP user, assign to a staff member, and enter the credentials in the phone. Test calls confirm registration.

Connect a physical SIP deskphone directly to Sparkforge for inbound and outbound calls. CRM features — call recording, transcription, transfers, contact logging — keep working; you just place and receive calls on a handset instead of the web dialer.

Permissions

  • Agency admins: Provision devices in any location.
  • Sub-account admins: Provision devices inside their own location.
  • Other users: Read-only. They see a tooltip pointing them to an admin.

Network and protocol requirements

  • SIP over UDP, TCP, or TLS
  • Outbound ports 5060 and 5061 open for SIP signaling
  • UDP 10000-20000 open for RTP audio
  • PoE switch or external power adaptor

Recommended hardware

Look for SIP and PoE on the spec sheet, at least two programmable line keys, and avoid carrier-locked or proprietary-provisioning devices.

Tested models

  • Yealink T54W / T58W
  • Poly VVX 450
  • Grandstream GXP 2170
  • Snom D785
  • Cisco 7841

Connect a deskphone

Step 1: Open the wizard

Go to Sub-Account Settings > Phone Numbers > Advanced Settings > VoIP Deskphone (SIP) > Get Started.

Step 2: SIP server configuration

Confirm or edit the SIP domain. A suggested domain like <LocationName>.sip.ashburn.twilio.com appears. You can change it once before saving.

Step 3: SIP user

Pick an extension (number or text) and a strong password. Save them somewhere safe — you'll need both on the handset.

Step 4: Assign user

Each deskphone connects to one Sparkforge user. Pick the user from Assign to User, then open Settings > My Staff > [user] > Edit > Call & Voicemail Settings and enable Deskphone for the call paths you want — Forward Calls to, Ring all, and the IVR default channel as needed.

Step 5: Configure the phone

Enter the SIP Domain, Username, and Password into the phone's Registrar / Server / Proxy fields. Field names vary by manufacturer.

Step 6: Run test calls (optional)

Open VoIP Deskphone (SIP) > Test Calls > Simulate Calls.

  • Outbound: Dial the displayed number. A successful call plays "This is a test call" three times.
  • Inbound: Click Inbound Test Call. The deskphone should ring.

Manage devices

From Settings > Phone Numbers > Advanced Settings > VoIP Deskphone (SIP) > Manage Devices:

  • Pencil icon resets the SIP user password.
  • Trash icon deletes the device. Deletion immediately unregisters the handset.

Deskphone-to-deskphone calls

Dial a teammate's extension to call them directly — no external numbers, no IVR routing. Works between any two configured deskphones.

IVR call transfer between deskphones

During an active IVR call, initiate a transfer and dial the teammate's extension. The call routes to their handset. Only blind transfers are supported today; warm transfers aren't available.

Troubleshooting

SymptomLikely causeFix
401 / 403 UnauthorizedWrong username or password (case-sensitive)Re-enter credentials
No audioFirewall blocking RTP (UDP 10000-20000)Open ports or disable SIP ALG
Phone rings but won't answerNAT or SIP ALG interfering with RTPDisable SIP ALG on the router
Can't save SIP domainDomain name already takenEdit the domain or accept the suggested increment
Inbound calls fail, outbound worksKeep Alive not configuredSet Keep Alive Type to Options under Account > Advanced

Frequently Asked Questions

Which VoIP deskphones are compatible?
Most open-SIP models. Tested examples include Yealink T54W/T58W, Poly VVX 450, Grandstream GXP 2170, Snom D785, and Cisco 7841.
Are calls on deskphones recorded and transcribed?
Yes. Once recording and transcription are enabled on the sub-account, deskphone calls are captured the same way as web and mobile calls.
Is there an extra charge for using a deskphone?
No. Deskphone calls share the same per-minute rates as web and mobile. Transfers to a deskphone don't add cost.
Can two deskphones share one Sparkforge user?
No. Each deskphone connects to a single user. To use multiple handsets, create additional users.
Why aren't inbound calls reaching my deskphone?
Check Keep Alive in the phone's settings. Set Keep Alive Type to Options under Account > Advanced. This resolves most one-way inbound issues.

Was this article helpful?