3CX SMS setup guide
This document explains how you can configure your 3CX in order to send and receive SMS and MMS messages with Wavix
Register a Sender ID

Before sending an SMS or MMS message, you need to activate a Sender ID on the Wavix platform. A Sender ID is the message sender details recipients will see on their devices. Sender IDs can be either numeric or alphanumeric presenting your brand or service name.

Important

You must use Numeric Sender IDs, if you want to enable 2-way messaging service. For one-way SMS you can use both Numeric and Alphanumeric Sender IDs.

The below steps are only mandatory if you’re planning to send messages using a US or Canadian phone number as Sender ID. In case you will be using a mobile number from other countries or an alphanumeric Sender ID, please scroll down to the Create a Sender ID on the Wavix platform section.

Purchase a number

Before sending or receiving an SMS, you need to have an active, SMS-enabled number on your Wavix account. If you already have it, the below steps are optional.

To purchase a number on your Wavix account:

1.

Log in to your account

2.

Select Numbers & trunks in the top menu and click Buy

3.

Select US or Canadian area code you wish to purchase a number in

4.

Choose a specific number or numbers and click the Buy now button

buy-number buy-number buy-number buy-number buy-number buy-number
Fig. 1 Search and buy a number

You will be redirected to the Cart where you can confirm your choice and proceed with checkout.

SMS-enable your number

Inbound SMS can be enabled on US and Canadian phone numbers only. To activate support of inbound SMS and MMS:

1.

Select Numbers & trunks in the top menu and click My DIDs

2.

Select a number you want to activate inbound SMS on

3.

Click on the down arrow to see additional details

4.

Click Activate next to Inbound SMS

activate activate activate activate activate activate
Fig. 2 Activate inbound SMS

In case of any questions, please raise a ticket in the support tab or email support@wavix.com

Create a Sender ID on the Wavix platform

To create a Sender ID:

1.

Select SMS in the top menu and click on Sender IDs

2.

Then click add new Sender ID and select the Sender ID type, i.e. Alphanumeric or Numeric

sender sender sender sender sender sender
Fig. 3 Sender ID name and type

Alphanumeric Sender ID can be up to 11 characters long and can only include upper- and lower-case letters and the digits from 0 through 9, and spaces. A numeric Sender ID can be associated with an SMS-enabled number on your account only.

Important

If you have chosen the Numeric Sender ID type, but do not see any of your numbers in the Sender ID drop-down list, make sure the number you are looking for is actually SMS-enabled.

Select country(-ies) you will be sending SMS to. Depending on the destination countries, additional restrictions for Sender IDs may apply. Hover over i icon next to the country name to see the details. If the Sender ID Type you’ve selected is not supported for the destination, the country will be greyed out.

Note:

Alphanumeric Sender IDs are not supported in a variety of countries, including the US and Canada, and may require pre-registration by local carriers in some others.

destination destination destination destination destination destination
Fig. 4 Destination countries
3.

Review your Sender ID and the list of destinations. Your Sender ID will be automatically allow listed in countries that do not require additional paperwork. A member of the Wavix provisioning team will reach out to you with additional information regarding the process of Sender ID registration in countries that do.

Configure SMS Sender ID on your 3CX SIP trunk
add-sms add-sms add-sms add-sms add-sms add-sms
Fig. 5 Add SMS Sender ID to 3CX SIP Trunk

In order to send and receive SMS and MMS messages you must have a 3CX SIP trunk connected to Wavix. Please check the 3CX SIP trunk setup guide for more details.

Important

When adding a new SIP Trunk in 3CX you need to specify the previously created Sender ID in the field labeled Main Trunk No.

Enable SMS on your 3CX SIP Trunk

In order for your 3CX instance to be able to send and receive messages, you need to add your Wavix account API key in the field labeled API key and set up Default SMS endpoint in your Wavix account. Click on the registered SIP Trunk in 3CX and then on the SMS tab.

sip-trunk sip-trunk sip-trunk sip-trunk sip-trunk sip-trunk
Fig. 6 SIP Trunk SMS settings
1.

Log in to your Wavix account at app.wavix.com

2.

Click on the ‘My account’ icon in the top-right corner and then click API keys.

3.

Copy an active Wavix API key and paste it into the field ‘Api Key’ in your 3CX.

api-key api-key api-key api-key api-key api-key
Fig. 7 Wavix API keys
endpoint endpoint endpoint endpoint endpoint endpoint
Fig. 8 Wavix Default SMS endpoint
4.

Go back to ‘My account’ page. Copy Webhook URL from 3CX and paste it into the field ‘Default SMS endpoint’ field in your Wavix account. Click Save all.

5.

Click OK to save 3CX SIP Trunk configuration.

After enabling SMS on your 3CX SIP Trunk, all your users will have the ability to send outbound messages

Set up inbound messaging

To receive incoming messages, you must have at least one SMS-enabled phone number. You can browse through our inventory in the portal's Buy section and find the number you like. Please be advised that you can enable inbound messaging on any US or Canadian number available in our stock. The associated process is explained in the section titled 'SMS-enable your number' above.

To purchase a mobile phone number:

1.

Log in to your Wavix account at app.wavix.com

2.

Select “Numbers & trunks” in the top menu and click “Buy”

3.

Select a country you want to buy a number in

4.

Select Mobile. The Inbound SMS column indicates whether a phone number can receive messages or not. ‘Supported’ means that the number is already SMS-enabled. ‘Not supported’ shows that the number cannot receive inbound messages.

5.

Choose a specific number or numbers with Inbound SMS ’Supported’ and click the “Buy now” button

You will be redirected to the Cart where you can confirm your choice and proceed with checkout.

verify verify verify verify verify verify
Fig. 9 Wavix SMS-enabled numbers

Once you have identified your SMS-enabled numbers on the Wavix platform, you need to allocate them to the SIP trunk on the 3CX side.

1.

Log in to 3CX Management Console

2.

Select SIP Trunk in the left-hand menu

3.

Click on the Trunk to open its configuration

4.

Switch to ‘DIDs’ tab and add all of your SMS-enabled DIDs to the list.

verify verify verify verify verify verify
Fig.10 Wavix DIDs with built-in SMS support

Keep in mind that the phone numbers must be in the international E.164 format.

Verify configuration

To test your 3CX setup send an SMS to your mobile phone number. Go to Users in the left-hand side menu, click on the default 100 extension and download a mobile application by scanning the QR code on the page. Log in to the app, go to the Chat tab and send an SMS.

verify verify verify verify verify verify
Fig. 11 3CX extension

If outbound SMS fails check the following:

  • You’ve completed all the steps in this guide
  • The destination phone number in the international E.164 format
  • The Sender ID you’re using is allow listed for the country you’re sending the message to