Support / Voice / PBX / FusionPBX

Add a VoiceTel SIP gateway to FusionPBX.

FusionPBX uses FreeSWITCH gateways under the hood. The Gateway form maps directly to the gateway XML; same fields, same semantics as a raw FreeSWITCH gateway.

1. Create the gateway

  1. FusionPBX UI → Accounts → Gateways → Add.
  2. Fill in (Digest authentication):
    • Gateway: voicetel
    • Username: yourusername — your SIP username from VoiceTel onboarding
    • Password: yourpassword — your SIP password
    • From User: yourusername — same as Username, NOT a caller-ID number
    • Proxy: <sip-host-from-portal>
    • Realm: <sip-host-from-portal>
    • Register: True
    • Expire Seconds: 360
    • Retry Seconds: 600
    • Caller ID In From: False (do not set True — that overrides From User with the dialplan caller ID and breaks trunk auth)
    • Profile: external
    • Enabled: True

    Leave the remaining gateway fields (From Domain, Register Proxy, Outbound Proxy, Register Transport, Ping, Extension In Contact, Hostname, etc.) blank — they aren't needed for VoiceTel and inherit sensible defaults.

  3. For IP authentication: leave Username and Password blank, set Register to False. Everything else stays the same — including From User = your SIP account username.
  4. Save.

2. Apply the gateway

FusionPBX writes the XML config but FreeSWITCH won't pick it up until the external profile is rescanned:

fs_cli> sofia profile external rescan
fs_cli> sofia status
# Look for: voicetel gateway REGED expsec=360

Or click the green refresh icon in the FusionPBX Gateways list — same effect.

3. Outbound route

  1. Dialplan → Outbound Routes → Add.
  2. Fill in:
    • Gateway: voicetel (the gateway you just created)
    • Dialplan Expression: ^(\+?1?\d{10})$ (US 10/11-digit; adjust for your dialing rules)
    • Description: Outbound to VoiceTel
    • Order: 100
    • Enabled: True
  3. Save and click the green refresh icon to rescan dialplan.

4. Inbound route

  1. Dialplan → Inbound Routes → Add.
  2. Fill in:
    • Destination Number: the VoiceTel-assigned DID, e.g. +12125551234 (or a regex for multiple DIDs)
    • Action: transfer to extension / IVR / time condition / etc.
    • Context: public
    • Enabled: True
  3. Save + rescan dialplan.

Verify

fs_cli> sofia status gateway voicetel
fs_cli> sofia loglevel all 9    # SIP trace
fs_cli> show channels