From VoIP.ms Wiki
|Article en Français||Artículo en Español|
What is SMS or MMS
SMS means Short Message Service (SMS). With the addition of Multimedia Message Service (MMS) to the service, users are now capable of sending and receiving media files (photos, videos, and audio) as well as sending text messages with more than 160 characters (which is the limit for an SMS). The MMS service also allows the user to send a message to multiple recipients at the same time.
Using the SMS/MMS
Identifying a DID Number SMS/MMS capable
The first thing you need to know is that this feature is only available for local US and Canadian numbers at this time. You will note that some numbers have a little icon, this indicates that the number supports this feature.
You can start ordering a DID Number from your portal >> DID Numbers >> Order DID >> Local Numbers >> (US or Canada) Numbers and you will be able to purchase your desired number, just make sure it supports the MMS feature.
Configuring the SMS/MMS service
Once purchased the SMS/MMS Service needs to be activated on the DID settings, from your portal >> DID Numbers >> Manage DID >> Edit Selection >> SMS/MMS configuration section.
In that section, you can activate and configure some forward options for the SMS/MMS service.
- Message Service (SMS/MMS): Check the box to enable the service.
- VoIP.ms SMS/MMS Portal: This is enabled by default and it can't be modified, that means that you will be able to create and send messages from the SMS Message Center.
- SMS/MMS Email Address: By activating this option all the SMS Messages will be sent to the email address you configure in this field. The advantage of this option is that you will receive your SMS Messages directly to your email and you will be able to Reply to these messages from your email too. You just need to click on reply to the email. Please note that e-mail responses are as well limited to 160 characters and if they exceed this limit, they'll be split in two (or more messages if applies) when sent.
- SMS/MMS Forward: You can have your SMS Messages forwarded to your cellphone or any other number that supports SMS, with this option you will receive the SMS Messages from our system to the configured phone number.
- SMS/MMS SIP Account: You can have your SMS Messages forwarded to your selected SIP account. They will be sent through our SMS/SIP gateway as a SIP MESSAGE.
- SMS/MMS URL Callback: By enabling this option you will be able to send the messages to another destination e.g. your own server. If selected SMS Messages received by your DID will Send a GET request to the URL Callback provided. Available variables for your URL:
- URL Callback Retry: When selected, we will be expecting an "ok" output (without quotes) from your URL callback page as an indicator that you have received the message correctly. If we don't received the "ok" (without quotes) from your callback page, we will keep sending you the same message every 30 minutes.
Once you configure the desired option, click on Apply Changes.
Sending a SMS/MMS (Web Interface)
- Click the "send New Message" button to get a list of contacts displayed or directly type in the number into the contact text field. If this number is registered in the phonebook, it will display its name instead.
- Click to display the list of available DID numbers. Choose the number to send the message from.
- Write your message on the text field and click the red arrow to send it. Text messages up to 160 characters will be considered SMS. Media messages or text messages over 160 characters will be considered MMS and you will see the icon turning from SMS to MMS indicating of this.
- In order to send a media file over an MMS, click the clip button to browse and choose a media file.
- Click the browse button to search for the media file in your computer or drag and drop the file directly into the box.
- The attached files will show below the text box.
- Once the message is sent, a new conversation will be opened on the left. Selecting this conversation will show the messages history on the box.
Receiving an SMS/MMS (Web Interface)
- While SMS messages can be received directly in an App through the SIP Protocol and correct configuration, at the moment, receiving and reading MMS is only possible through the message center.
- You can access the communication center from your customer portal at DID numbers > SMS/MMS Message Center. Any message received will appear here on the left side of the panel.
- Use the DID Filter to choose and display messages for a specific DID number or for all DID numbers. You can also filter the messages by date and time zone.
- Choose a conversation from the left panel. An option to delete the conversation is also available. Choose the DID number from the text box to reply.
You can now also gain access to a general history of SMS/MMS that was sent and received for all of your DIDs, or for a specific one by going to Customer Portal >> DID Numbers >> SMS/MMS Message Center >> History.
SMS using a SMPP Server
An SMPP server, short of Short Message Peer to Peer is a method designed to send and receive high volumes of SMS messages through a dedicated server.
In other words, this allows you to better control the quantity of messages that will be sent to your target audience while avoiding to pass via a softphone application or your VoIP.ms portal to send/receive these SMS, thus eliminating multiple repetitive tasks and saving you time.
For example, if you have a promotion for your business that offers a discount for a certain lapse of time and that your customers have provided their agreement to receive these types of promotions via SMS, you could send your promotion to your customers in a faster manner than if you would do it from your customer portal, thus increasing efficiency.
- This will require you to have your own SMPP server.
- Once configured properly, you will then be able to send and receive SMS messages to your own server.
Configuration on your SMPP Server
- In order for your server to communicate and authenticate accordingly with VoIP.ms SMPP server, you will need to configure the following:
- A username and password of your choice in order for VoIP.ms SMPP server to authenticate you.
- Have all your communications be sent to smpp.voip.ms via port 2775, for regular SMPP, or port 3550 which is our encrypted SMPP port.
- Open a connection using the bind_transceiver command. You can keep this connection open for as long as you need to and inquire about it using the enquire_link command.
- Send your messages with either deliver_sm or submit_sm commands. Make sure to include your PDU's source_addr as one of your SMS enabled DIDs from your account. Your destination SMS number should be set as destination_addr while your text message will be included in short_message.
Configuration SMPP on your VoIP.ms Portal
Once you have set up the above on your server, you will need to enable and specify which username and password will be used by VoIP.ms to authenticate your SMPP requests. In order to do so, head into your VoIP.ms portal, DID Numbers, Manage DIDs, edit your DID that supports SMS messages and by heading down the page, you will see the following options:
- SMPP Enabled: If selected, SMS Messages will be allowed to be sent and received using SMPP.
- You may specify the URL to be used to send a copy of inbound messages to your SMPP server. Leave empty if you only wish to send messages. See the example below. The scheme part is mandatory and must be set to either of smpp for unencrypted SMPP, or ssmpp for encrypted SMPP using TLS. The user:[email protected] part is optional and will default to the same username and password defined for authentication on our side as defined below. The :port part is also optional and will default to 2775 for smpp and to 3550 for ssmpp.
- SMPP Username: The username that you will use to authenticate to our SMPP server for sending messages
- SMPP Password: The password that you will use to authenticate to our SMPP server for sending messages
Enable the option SMPP Enabled, fill the username and password per what was configured on your SMPP server and once done, apply the changes by pressing Click here to apply changes.
You may now start sending and receiving SMS messages from your SMPP server.
Send and Receive Text Messages (Web Interface)
SMS Message Center for mobile
To start using the service you will need to use the SMS Message Center, from your portal >> DID Numbers >> SMS Message Center.
For Mobile Devices please use sms.voip.ms as a complete all in one solution.
From the SMS Message Center you can check your SMS History, send and receive SMS messages.
- Search Range: Select a Date Range of your SMS History. You can select a time period by marking the "Show Details" field and the text messages will be displayed.
- Search Filter: You can filter your Search by DID, Contact and Type (Sent, Received and Both).
- Send New SMS Messages: Another window will open by clicking here in order to create a new SMS Message.
- Delete Selected Messages: This action will delete any messages that you have selected, by clicking on the box next to them. This action cannot be undone.
- Delete All Messages: Delete ALL your SMS Messages, both sent and received. This action cannot be undone.
- Checking a Message: To check a received SMS Message just click it directly in order to display the information.
Create a New SMS Message (Legacy)
You can create a new SMS Message we will explain you all the parameters you can find on this section:
- DID: If you have more than one DID Number you can select any of the numbers available to send your message.
- Contact: The destination phone number or if you have a Phone book entry start typing the name and the system will display the information if available.
- Message: You can create your message on that field, please note that you have up to 160 characters.
Then click on 'Send Message' to send the SMS.
Send and Receive Messages (via SIP MESSAGE Protocol)
- DID must have the "Short Message Service (SMS)" service option enabled. This option can be enabled from the Manage DIDs > Edit DID page.
- To send an SMS from your SIP account, it is required that you set your Caller ID number to one of your SMS enabled DIDs. This will be the number you will be sending the message from. You can configure the Caller ID number from your customer portal for the specific subaccount if you are using a softphone or directly from your extension or trunk if you are using an Asterisk or PBX server.
- It's important to note that if you configure your caller ID name in your SIP client to be a 10 digits number, this will override your caller ID number. If the caller ID name is anything different than a 10 digits number this will be discarded and the Caller ID number will be used.
- If you are an asterisk or PBX user, please make sure to use the latest version of Asterisk (v12 or higher) and use chan_pjsip for the trunk. This is an asterisk limitation.
- The Desktop version of Zoiper requires the user to have the PRO version activated to be able to send SMS messages as well as to enable SIP Presence. Please contact Technical Support to request SIP presence to be enabled for your account for the VoIP.ms POP you are using. While normally not required, there may be other cases not documented of softphones or apps requiring SIP Presence to be enabled. Please contact technical support if you encounter any issue with your specific software.
- The free Desktop version of Zoiper cannot send SMS messages and is only capable of receiving SMS.
- The mobile version of Zoiper is completely free of these limitations. Free version already works for sending and receiving without the need of SIP presence.
- When sending an SMS message, the recipient number must be 10 digits. Avoid using the prefix '"1"' since is not supported at the moment. The system will recognize the numbers as in 10 digits.
- The current characters limit for a single SMS is 160. If a message is bigger than 160 characters it will be split into blocks of up to 160 characters each and be sent as independent messages. The maximum total message length for SMS via SIP is 2000 characters.
- DID must have the "Message Service (SMS/MMS)" service option enabled. This option can be enabled from the Manage DIDs > Edit DID page.
- Enable the option "SMS SIP Account" and select the account destination for your SMS messages to this number.
- The account receiving SMS must be registered successfully in any of our POPs.
- To ensure the best results receiving the SMS messages, do not register the same SIP account on more than one softphone or app at the same time, this can lead to unexpected results.
- For SIP devices that require this information, such as a trunk or PBX, we encode the original destination number in a custom SIP header field named "X-SMS-To".
- 3CX softphone currently does not support any third party SMS service. It will only work by having a direct connection to the 3CX PBX system. Please contact 3CX for more details.
Send SIP/SMS with FreePBX
Yes, it is possible to configure a FreePBX system to send SMS, please refer here for detailed instructions.
SMS/MMS using the Reseller Interface
The feature is available for your client through the Reseller interface. You must enable this feature in your package in order to give your customers the ability to leverage this.
Go under the navigation bar on [Reseller] then click on [Manage Rates & Packages]
Click on the Edit button to edit your package, or click on [Create a new package] to create a new one.
Go under the [Reseller System Configuration] Tab, and on the section "Type of configuration" select: [Package Configuration],
Then scroll down and find the feature "’’’SMS/MMS’’’", and enable it.
Enabling/Disabling SMS/MMS on a DID via the client's interface
For your client to enable or disable SMS/MMS from his portal, your customer will need to head under Services, My Services.
Then proceed by heading into ‘’’DID Lists’’’ tab and edit DID.
You will then be able to enable SMS/MMS, receive via email and more.
Accessing their SMS/MMS via the clients interface
1) To gain access to their SMS/MMS messages, head under Services and then SMS/MMS.