Inbound Call Routing in Sparkforge: Where Calls Actually Go
Sparkforge routes inbound calls in three priority layers: a number assigned to a user routes there first, then any phone-page forwarding number, and finally the company phone on the business profile.
When a contact calls a Sparkforge phone number, the call follows a fixed priority chain. Knowing the order saves hours of “why did the call go there?” debugging.
Routing priority
- Number assigned to a user. If the dialed phone number is assigned to a specific user, the call always rings that user’s phone, web app, and/or mobile app — even if the contact is assigned to a different user.
- Phone-page forwarding number. If no user owns the number but a Call Forwarding Number is set on the phone-number config, the call goes there.
- Company / business phone. If neither of the above is set, the call falls back to the Company Phone on the Business Profile.
- No forwarding configured. The call drops immediately.
Routing matrix
Combinations of user assignment, web/mobile app enablement, and forwarding number determine the final route:
| Web app | Mobile app | User phone | Phone-page fwd | Business phone | Result |
|---|---|---|---|---|---|
| Yes | Yes | Yes | any | any | Web + mobile + user phone |
| Yes | Yes | No | No | No | Web + mobile app |
| Yes | No | No | No | No | Web app only |
| No | Yes | No | No | No | Mobile app only |
| Yes | Yes | No | Yes | any | Web + mobile + forwarding number |
| No | No | Yes | any | any | User phone |
| No | No | No | Yes | any | Phone-page forwarding number |
| No | No | No | No | Yes | Business phone |
| No | No | No | No | No | Call drops immediately |
Where to set each layer
Company phone (fallback)
- Click Settings > Company.
- Update the Company Phone field.
- Click Update Company.
Call Forwarding Number
- Click Settings > Phone Numbers.
- Edit the default outbound number.
- Set Call Forwarding Number and save.
User phone
- Click Settings > Team Management.
- Click Edit on the user.
- Update the Phone field and save.
Common debug scenarios
Number is assigned to a user but I don’t know which one
Open Settings > My Staff, edit each user, expand Call & Voicemail Settings, and check Select Phone Number. The currently-assigned user is the one whose dropdown shows the number.
Call disconnects immediately
Two common causes: a broken Custom Value in the whisper message, or the number is not voice-capable. Edit the number, clear the whisper, and check Twilio logs for capability flags.
I want every call to ring one specific number, always
Create a user, set their Phone field to that number, and assign the Sparkforge number to that user. The user-priority rule guarantees every inbound call routes there.
Send a number directly to voicemail
Either configure the per-user or per-company voicemail in Sparkforge, or set the inbound call timeout to 1 second so the call rolls to voicemail almost immediately.
Call forwarding with an extension
Extensions are supported only when the number is assigned to a user — the user record has an extension field next to the phone number.
Frequently Asked Questions
Which Sparkforge number did a contact actually call?
If a contact is assigned to user A but the number is assigned to user B, who gets the call?
Why does the call still forward when I haven’t set a forwarding number?
Can I send a number straight to voicemail?
Do extensions work on inbound calls?
Was this article helpful?
Thanks for the feedback.