Integration User Guide

Verier|SMS allows you to integrate the power of our SS7 SMS gateway directly into your application. We provide several different methods of connecting to our gateway.

Web Site
XML Soap
HTTP Get

Web Site

Our website allows you to send messages from the members area. You can send a message to multiple people or just a single person. We also offer an address book function where you can store lists of people you frequently send messages to - such as a membership list for a club, or prospects for gym membership.

XML Soap

We have an XML SOAP service available at http://sms.verier.co.uk/services/SMS.asmx.

SendSMS

This is the method to use to send your text messages.

username	string	Your Verier\|SMS username
password	string	Your Verier\|SMS password
from	string	The number or name you wish the message to appear from. Numbers should be entered in international format. Numbers entered with a leading 0 such as 07712345678 will be assumed to be UK and converted into 447771245678. You may also use letters instead of numbers. The maximum length of the string when using letters is 11 characters. Any letter combination more than 11 characters will be truncated. e.g. If you try to send a message with the from address of "FantasticBarAndClub" this would be automatically shortened to "FantasticBa". Note that the case is preserved.
flashMessage	boolean	A Flash SMS is a message which opens automatically on the handset. Note that this message will not be saved on the handset, and on most handsets the user can not action the message, e.g. reply on ring the number provided. This function is suitable for quick updates, such as taxi driver pickups.
message	string	The body of your message. This is limited to 160 characters to prevent accidently sending multiple messages. Any message of more than 160 characters will automatically be truncated. We will offer an alternative method for sending long SMS.
destinationTel	string	The number you wish to send the message to. This should be entered in international format. Any number with a leading 0 will be converted into a UK international number.
filter	boolean	Enabling this function will first check the number to ensure the number is valid. If the number is valid, a second message will automatically be generated by the system to actually deliver the message. This helps you save costs on lists that may be out-of-date.

Method returns one of the following results

Unknown	An unknown error occured
InvalidUserNamePassword	The username and/or password were invalid
InsufficientCredit	There is not enough credit on the account to send the message requested. Please note, if you are requesting to filter, only the cost of the filter is deducted from your balance. Therefore if you are filtering on a message to a large number of recipients please ensure you have sufficient credit to cover the expected live numbers.
Accepted	Your message has been accepted

GetBalance

This is the method to check the balance of your account.

username	string	Your Verier\|SMS username
password	string	Your Verier\|SMS password

This method will return your balance, or throw an exception if your username or password are invalid.

HTTP GET

We offer our XML SOAP method SendSMS via a simple HTTP get also. You simply call the page

http://sms.verier.co.uk/services/SMS_Get.aspx

With the parameters as the query. e.g.

http://sms.verier.co.uk/services/SMS_Get.aspx?Username=user&Password=pass&From=JoeBloggs&DestinationTel=447712345678&Message=Hello+Joe

Parameter names are not case sensitive, but case is preserved on both the Message and From Address. Please remember to escape your message. For example in .NET you would use