VoIP.ms SMS Integration
Before proceeding with the next steps, you need to purchase a DID on the VoIP.ms platform.
The VoIP.ms SMS service has some limitations. Please refer to this link for more details: Service Limitations.
Set an API Password in VoIP.ms
PortSIP PBX uses the VoIP.ms API Password to send and receive SMS/MMS messages. If you have not already created an API password, follow these steps.
Step 1: Enable the VoIP.ms API
Sign in to the VoIP.ms Client Portal.
Navigate to Main Menu > SOAP and REST/JSON API.
If the API is not enabled, click Enable the API
Enter a value in the API Password field.
Click Save API Password.
❗Important
The API password is shown only once when it is created.
Copy and store it securely—you will need it later when configuring SMS in PortSIP PBX.
If the password is lost, you must generate a new one.

Configure SMS with VoIP.ms Trunk in PortSIP PBX
Before configuring SMS in PortSIP PBX, ensure that a VoIP.ms SIP trunk has already been configured.
Sign in to the PortSIP PBX Web Portal
You can access the tenant configuration using one of the following methods.
Option 1: Sign in as System Administrator
Sign in to the PortSIP PBX Web Portal as a System Administrator.
Navigate to Tenants.
Select a tenant and click Manage to switch to that tenant.
Option 2: Sign in as Tenant Administrator
Sign in directly as a Tenant Administrator to manage the tenant.
❗Note For more information about roles and permissions, refer to Tenant Management.
Add an SMS Configuration in PortSIP PBX
Step 1: Create the SMS Configuration
In the PortSIP PBX Web Portal, navigate to SMS/MMS.
Click Add.
Select your configured VoIP.ms trunk.
Configure the following fields:
Username
Enter your VoIP.ms account username (usually your login email).
Password
Paste the VoIP.ms API Password created earlier.

Step 2: Copy the Webhook URL
You will be redirected to the SMS/MMS list page.
Copy the Webhook URL using one of the following methods:
Select the SMS configuration and click Copy Webhook.
Or, double-click the SMS configuration and copy the Webhook URL from the details page.
Configure SMS Settings in VoIP.ms
Step 1: Assign the Webhook URL to the DID
Sign in to the VoIP.ms Client Portal.
Navigate to DID Numbers > Manage DIDs.
Click the Edit (yellow pencil) icon next to the DID you want to use for SMS.
Scroll down to the Message Service (SMS/MMS) section.
Enable the SMS/MMS service.
In the SMS/MMS Webhook URL field, paste the Webhook URL copied from PortSIP PBX.
Step 2: Select the SMS Number Format
Choose the SMS/MMS number format:
E.164 format
Messages must include the
+sign and country codeExample:
+13322496213
NANPA format
Messages use a 10-digit number without country code
Example:
3322496213
Click Click here to apply changes to save the configuration.

Verify the Configuration
At this point, the VoIP.ms SMS/MMS integration is complete.
You can now create outbound and inbound rules in PortSIP PBX to send and receive SMS/MMS messages using the VoIP.ms trunk, just as you would configure rules for voice calls.
Last updated