FSPBX
From VoIP.ms Wiki
(Difference between revisions)
| [checked revision] | [checked revision] |
(→Create or Edit a Gateway) |
|||
| (4 intermediate revisions not shown) | |||
| Line 14: | Line 14: | ||
::* A selected VoIP.ms PoP for your DID ''(ex: montreal.voip.ms)'' | ::* A selected VoIP.ms PoP for your DID ''(ex: montreal.voip.ms)'' | ||
| - | = Create or Edit | + | = Create or Edit a Gateway = |
Access your FSPBX web interface: | Access your FSPBX web interface: | ||
: 1) Go to '''Accounts''' | : 1) Go to '''Accounts''' | ||
| Line 20: | Line 20: | ||
:: [[File:FSPBX_Account_Gateway.png|500px|none|VoIP.ms Gateway configuration screen]] | :: [[File:FSPBX_Account_Gateway.png|500px|none|VoIP.ms Gateway configuration screen]] | ||
: 3) Click '''Create''' to create a new gateway | : 3) Click '''Create''' to create a new gateway | ||
| - | :: [[File:FSPBX_Account_Gateway_create.png| | + | :: [[File:FSPBX_Account_Gateway_create.png|650px|none|VoIP.ms Gateway configuration screen]] |
| - | + | ==Settings tab== | |
: 4) Click on the '''Settings''' tab | : 4) Click on the '''Settings''' tab | ||
:* '''Proxy''': Enter the your Preferred PoPServer. '' Eg: montreal1.voip.ms'' | :* '''Proxy''': Enter the your Preferred PoPServer. '' Eg: montreal1.voip.ms'' | ||
| Line 32: | Line 32: | ||
:* '''Retry Seconds''': 30 | :* '''Retry Seconds''': 30 | ||
:* '''Description''': Enter a description for your note | :* '''Description''': Enter a description for your note | ||
| - | :: [[File:FSPBX_Account_Gateway_settings.png| | + | :: [[File:FSPBX_Account_Gateway_settings.png|600px|none|VoIP.ms Gateway configuration screen]] |
| - | + | ||
| + | ==Advanced tab== | ||
: 5) Click on the '''Advanced''' tab | : 5) Click on the '''Advanced''' tab | ||
:* '''From User''': Enter your Sub-Account username ######_SubAccount | :* '''From User''': Enter your Sub-Account username ######_SubAccount | ||
| Line 45: | Line 45: | ||
:* '''Domain''': Select your domain | :* '''Domain''': Select your domain | ||
:* '''Enabled''': YES | :* '''Enabled''': YES | ||
| - | :: [[File:FSPBX_Account_Gateway_advanced.png| | + | :: [[File:FSPBX_Account_Gateway_advanced.png|600px|none|VoIP.ms Gateway configuration screen]] |
| + | ==Provider IPs tab== | ||
: 6) Click on the '''Provider IPs''' tab | : 6) Click on the '''Provider IPs''' tab | ||
| + | ::'''Note''': Adding the VoIP.ms IP ranges here automatically updates the gateway's access control list (ACL). No additional ACL configuration is required. | ||
:* Click '''[Add item]''' | :* Click '''[Add item]''' | ||
:* Type: 208.100.60.0/24 | :* Type: 208.100.60.0/24 | ||
| - | |||
| - | |||
:: [[File:FSPBX_Account_Gateway_ProviderIPs.png|600px|none|VoIP.ms Gateway configuration screen]] | :: [[File:FSPBX_Account_Gateway_ProviderIPs.png|600px|none|VoIP.ms Gateway configuration screen]] | ||
| + | |||
| + | : Click '''[Save]''' | ||
'''Note''': Verify registration status under '''Status''' → '''Gateways / Registrations''' | '''Note''': Verify registration status under '''Status''' → '''Gateways / Registrations''' | ||
The gateway should show Registered | The gateway should show Registered | ||
| - | <------------------- | + | <!--------------------------- |
= Access Control (ACL) = | = Access Control (ACL) = | ||
For enhanced security, we strongly recommend restricting SIP access to VoIP.ms IP ranges only. | For enhanced security, we strongly recommend restricting SIP access to VoIP.ms IP ranges only. | ||
| Line 82: | Line 84: | ||
: Make sure to add all required CIDR blocks for the PoP(s) you are using. | : Make sure to add all required CIDR blocks for the PoP(s) you are using. | ||
:: [[File:FSPBX_Advanced_AccessControl_editProviders_ipRules.png|600px|none|Access Control – VoIP.ms IP ranges allowed]] | :: [[File:FSPBX_Advanced_AccessControl_editProviders_ipRules.png|600px|none|Access Control – VoIP.ms IP ranges allowed]] | ||
| - | + | -----------------> | |
| - | + | = Notes and Troubleshooting = | |
| - | + | ||
If the gateway does not register: | If the gateway does not register: | ||
* Double-check Username / Password / Proxy (PoP) | * Double-check Username / Password / Proxy (PoP) | ||
Latest revision as of 21:00, 14 October 2026
This guide explains how to configure a VoIP.ms SIP Gateway in FSPBX.
Contents |
Requirements
Before starting, make sure you have:
- An active VoIP.ms account
- A Sub Account (SIP) created in the VoIP.ms portal
- SIP Username (ex: ######_SubAccount)
- SIP Password
- Device Type: Asterisk, IP PBX, Gateway or VoIP Switch
- CallerID Number: I use a system capable of passing its own CallerID
- A selected VoIP.ms PoP for your DID (ex: montreal.voip.ms)
Create or Edit a Gateway
Access your FSPBX web interface:
- 1) Go to Accounts
- 2) Select Gateways
-
- 3) Click Create to create a new gateway
-
Settings tab
- 4) Click on the Settings tab
- Proxy: Enter the your Preferred PoPServer. Eg: montreal1.voip.ms
- Profile: Select your profile
- Context: Enter your context
- Register: Select True
- Username: Enter your Sub-Account username ######_SubAccount
- Password: Enter your Sub-Account password
- Expire Seconds: 120
- Retry Seconds: 30
- Description: Enter a description for your note
Advanced tab
- 5) Click on the Advanced tab
- From User: Enter your Sub-Account username ######_SubAccount
- Realm: Enter "voip.ms"
- Auth Username: Enter your Sub-Account username ######_SubAccount
- Register Transport: UDP or TCP
- SIP CID Type: Select "rpid"
- Codec Preferences: This must reflect your Sub-account, ensure you have the proper codec selected. 1
- Ping: 20
- Domain: Select your domain
- Enabled: YES
Provider IPs tab
- 6) Click on the Provider IPs tab
- Note: Adding the VoIP.ms IP ranges here automatically updates the gateway's access control list (ACL). No additional ACL configuration is required.
- Click [Add item]
- Type: 208.100.60.0/24
- Click [Save]
Note: Verify registration status under Status → Gateways / Registrations The gateway should show Registered
Notes and Troubleshooting
If the gateway does not register:
- Double-check Username / Password / Proxy (PoP)
- Ensure firewall and NAT allow UDP 5060 and RTP traffic
- Confirm your ACL includes the correct VoIP.ms IP ranges
Inbound and outbound call routing is configured separately using:
- Dialplans
- Inbound Routes
- Outbound Routes
FSPBX SMS and MMS configuration
The following steps describe how to use your VoIP.ms account to deliver two-way SMS and MMS through FSPBX, including inbound message handling, outbound delivery, and provider authentication. It assumes you have access to the FSPBX web interface and can edit the application environment on the server.
Required environment variables
On the FSPBX host, add the following variables to your .env file:
Variable description
- VOIPMS_API_USERNAME – Your API username for authenticating to VoIP.ms from FSPBX. This is the same value as the email address associated with your VoIP.ms account.
- VOIPMS_API_PASSWORD – Your API password, used together with the username for secure provider access.
Make sure you allowed your FSPBX IP address too.
Apply configuration changes
After saving your .env file, run the following on the FSPBX server so the application loads the new settings:
php artisan config:cache
Webhook configuration
VoIP.ms delivers inbound SMS and MMS to FSPBX through a webhook. You must set the URL in the VoIP.ms customer portal so messages reach your FSPBX instance.
- 1) Log in to your VoIP.ms account.
- 2) Go to DID Numbers → Manage DIDs, then click Edit (the pencil icon) on the DID number that will receive SMS/MMS.
- 3) Enable SMS/MMS on that DID if it is not already enabled.
- 4) Set the inbound webhook URL to use POST with a JSON body. The path expected by FSPBX is:
-
https://your-domain/webhook/voipms/sms - Replace
your-domainwith the public hostname (or FQDN) of your FSPBX installation.
-
- 5) Save your changes in the portal.
Enable SMS on a DID number in FSPBX
After credentials and the webhook are in place:
- 1) In FSPBX, go to Advanced → Message Settings.
- 2) Add or edit a number that is enabled for SMS.
- 3) Select VoIP.ms as the provider.
- 4) Assign the extension that should receive and send messages for that DID number.
- 5) Optionally set an email address for read-only notifications.
- 6) Save the configuration.
Resulting flow:
- Inbound SMS/MMS → VoIP.ms → FSPBX → assigned extension
- Replies → FSPBX → VoIP.ms → original sender
MMS support
If your DID number supports MMS, FSPBX can process media attachments through the same messaging flow. Storing MMS media in FSPBX typically requires S3-compatible storage to be configured in the system; refer to the FSPBX documentation for message storage and MMS options.
