Yes. The interface is the same as HTTP, so the only change will be in the protocol portion of the URL used (https:// for SSL).
We recommend that HTTP (SSL) is used where ever security and message integrity is required for an application.
Yes. When sending an email set the option for a “read receipt” (each email system has a different way of doing this so see the relevant vendor for more information).
When a message is processed with a read receipt request, Messenger waits for a few minutes and sends an email back that has the status information for each recipient. If you have login credentials you can also view this information in the Messenger Inbox.
Yes. Some languages may not display correctly on some handsets and carrier networks.
If you are using a UTF-16 language (Chinese, Cyrillic etc), your character payload per SMS message part decreases to 70 characters in the first part, and 134 characters in the second part and 201 in the third part.
This means if you send a message that is 100 characters (for example) in a UTF-16 language, you will be charged for 2 messages.
Bulletin attempts to send all messages to the carriers within seconds of receiving them, but SMS is a best effort, store and forward process which means that the carriers may have their own queuing, delivery and expiry policies.
Once Bulletin has passed the message to the carrier delivery is beyond our control, however, we will request status updates and use these to keep you informed of the of the message if these are available.
You can use the status information to decide whether you should resend the message or use an alternative communication method.
If individual (customised) messages are prepared and sent then about 3000 per minute can be sent through the Bulletin API. The speed of message delivery will also be impacted by:
- Network connection speed between your client and Bulletin.
- Method of connecting to Bulletin Connect (HTTP is faster than a SOAP connection).
- The destination carrier. Some carriers throttle message delivery based on their network requirements.
Bulletin Services must not be used for unsolicited SPAM or marketing messages. Users that do so may have the service restricted or cut off.
Download the NZ Unsolicited Electronic Messages Legislation and ensure your service and procedures adhere to this Act. Users residing in other countries or sending messages to other countries (outside of NZ) must ensure that they comply with all applicable local laws.
Yes. Any replies to messages you send out will also include a messageId that will link the reply to your original message.
The ID provided by your service is a string of up to 36 characters. If you are persisting this information to a database, that would be the field type to use.
There are two options (Polling and Pushing) to retrieve incoming messages, replies and status updates and it will depend on your network setup, resources and application requirements as to which best suits.
Polling is a client initiated connection to the Messenger API server and reduces firewall and proxy issues that can occur with the push method. More detail available about polling available here
The Push option has the Messenger Server connecting to a REST end point on your server each time a message (reply or status) is processed. More detail about Pushing via Callbacks available here
Benefits and Restrictions
Yes. The to parameter can be a SPACE Separated List of numbers in International format.. For example: to=642715414141 6178542544 12059955852
Ensure you URLencode the parameters.
Mobile Number Portability (MNP) allows mobiles to change networks while retaining their phone number. Bulletin receive a file each day which contains details of numbers that have ported. This file is provided by a third party working in association with the carriers and it generally takes 2-3 days for a ported number to appear in this file after a number has changed networks. During the short time between the handset changing networks and us being told of the change, the handset will not receive messages.
Any long term issues with ported numbers should be raised with Support.
All replies to messages sent from Messenger appear in the Inbox in the web site. Replies are attached to the original message in a ‘thread’ so you can keep track of your conversations.
If you have configured a ‘callback url’ messages will also be delivered to your own server.
If you have the Messenger app installed, messages will also be delivered to the app.
If you have ‘forward2mobile’ enabled, messages will be forwarded to your phone.
This is rare but it does occur when the there is a communication glitch between the recipient’s handset and their network, that stops the phone from acknowledging that it has received the SMS.
When this happens the carrier continues to attempt to deliver the same message (as per its store and forward procedures) until it receives an acknowledgment from the phone. This situation results in multiple messages on the handset if the handset does not acknowledge properly (if they all have the same sender number and you are not using short codes then this is probably the situation).
We have found that doing a hard restart of the phone fixes the issue. The recipient should simply pull the battery from the handset, wait a few seconds, reinsert the battery and power the handset up again.
- By default, some mobile service providers in North America block message deliveries initiated from short codes. In such cases, the recipients (i.e. the handset owners) must contact their mobile service provider directly to unlock such blockages.
- Some mobile numbers, which have been ported from one network to another, may also experience non-delivery of short codes messages. In such cases, the previous mobile service provider will reply “STOP ALL” to the sender of all the short codes messages to prevent further deliveries. In such cases, the recipients (i.e. the handset owners) must contact their current and/or their previous mobile service providers directly to unlock such blockages.
- Short codes messages cannot be delivered to recipients using Virtual Numbers, as the sender will be unable to bill the Virtual Numbers holder properly. It is recommended that the recipients to not use Virtual Numbers in such cases.
- Short codes messages will not be delivered if a recipient has previously replied to a sender with any of the following (case insensitive) keywords:
stop cancel end quit unsubscribeThe delivery of any future short codes message from that sender will be halted. The recipient must contact the sender to resume the deliveries.
Branding and Marketing
Yes. Some networks do allow you to set a word or string of words as the number recipients see as the sender of an SMS. This is done by setting the from part of the message payload To use this feature please contact Sales with details of the strings you want to use.
Source headers can be any alphanumeric with the following restrictions: + No more than 11 characters in total + Use only alphanumeric characters (eg: a-z or A-Z, or 0-9) + No symbols or spaces.
Unable to reply
When using this feature the recipient will not be able to reply to the message. Please ensure you have alternative contact instructions in the message to allow users to unsubscribe.
Bulletin SMPP is purely an enterprise service for very large volume customers who want, for example, their own instance.
The Messenger API is an enhanced version of Bulletin SMPP but is instead integrated with our Messenger product, meaning that you can access reports, messages etc online. You can signup for the Messenger API online, whereas the Bulletin SMPP service requires a business relationship to be established.
You can request a copy of the Service Rules from Support. As these are dictated by mobile network providers, they are subject to change.
Please provide an email address that they can be sent to.