SMS Gateway Instructions

Support
2019-03-11 21:26

Hero offer an SMS gateway for customers who wish to send SMS messages either by using our email to SMS gateway or web service API.  Below are instructions on how to use this service.

Email to SMS gateway

1. First you need to setup which email addresses are allowed to send SMS on your account or phone number.  To do this login to the Hero portal.  Click on the  Voice tab and select the phone number you wish to bill your SMS messages against.  Next click on Other Settings  and then select the 'SMS Features' sub-menu option

2. You can list one or many email addresses that are permitted to send SMS through the email gateway, putting each email address on a new line.  You can also optionally enter a passphrase to increase security.  This passphrase needs to be included in the subject line when sending your SMS emails and will automatically be removed from the SMS when it is sent out.

3. Once you have defined the email addresses allowed to send SMS messages and optionally set a passphrase you can simply send an email from one of those allowed email addresses to a mobile phone number of your choice.  The Subject line and Body of the email will be added together to make up the complete SMS message.  If you do not want the subject line to be included in the SMS message then leave this blank.  You need to send your email message as follows:

To: phonenumber@sms.hero.co.nz

The Phone number needs to be in full country code + number format for overseas.  By default if you exclude the country code and send as 0211234567 for example then we will assume that the NZ is the destination for your SMS message.  Outside NZ however you will always need to include the country code.  To avoid confusion it is best to always include the country code anyway.

For example if you wanted to send and SMS saying "Hello there how are you today?" to a NZ mobile number 0211234567 then you would send your email as follows:

From: youremailaddress@yourdomain.com

To: 0211234567@sms.hero.co.nz

Subject: Hello there

Body: how are you today?

SMS messages are restricted in length to 160 characters so you need to ensure the length is less than this limit or it will be trimmed.  To send more characters you will need to split up your message into multiple email messages (just like Twitter!)

SMS messages will be automatically billed against your account at the appropriate rates.  See our rates page for details on the cost of SMS messages.

SMS API Instructions

Alternatively if you do not wish to use our email gateway to send SMS messages then you can use our SMS API.  This is more useful for web developers who wish to build this logic in their own code.

URL: https://hero.co.nz/sms.php

POST Variables (GET is also supported):

username:  <Hero Phone Number>  (e.g. 092420000)

password:  <Hero Phone Password>  (e.g. Test1234)

destination:  <Destination Phone Number>  (e.g. 092420000)

message:  <Text you wish to trasmit as SMS body>

 

Success RETURN Values:

0:1 SMS successfully queued


Failure RETURN Values:

2:0 Authentication error
3:0 Destination number(s) error
4:0 Message error

If you have any questions about our SMS API then please contact our support team.

Average rating: 5 (1 Vote)

You cannot comment on this entry