In addition to sending an individual Office Message to the recipient via SMS/TXT Message you can also send a bulk Office Message to selected User Account Names via SMS/TXT Message , for example an SMS/TXT Message to all the sales staff informing them of a new sales promotion or update.
To enter and send a new bulk Office Message via SMS/TXT Message to your selected User Account names:
1. Go to the Data Manager Home Screen.
2. Click the Office Messages button.
3. Any Office Messages that have your User Account Name and have NOT been marked as Dealt With appear by default in the List. If there are No Messages that have your User Account Name and have NOT been marked as Dealt With you will see blank screen with an alert as follows
4. Click the Bulk Message SMS button to create a new bulk Office Message:
This is where you enter the bulk Office Message and select which recipients you wish to send the Message to. Enter your Message into the SMS Message field (all recipients will receive the same Message). At the bottom of the screen is a list of all the User Accounts in your copy of Data Manager. By default all User Accounts are marked Yes to receive the bulk Office Message, so you need to deselect any User Accounts that you do NOT wish to receive the Message by selecting No in the Include in SMS? column to the right of their User Account Name. Once you have entered your bulk Office Message and selected/deselected the User Accounts you wish to receive this bulk Office Message click the Send Bulk SMS button to send the bulk Office Message to all selected User Accounts to the Clickatell SMS Gateway.
Each SMS/TXT Message usually takes a few seconds to send and a progress bar will appear on the screen whilst Data Manager is trying to submit the Email Messages to your SMTP Mail Server indicating the sending status:
Data Manager will attempt to submit each message to Clickatell for 15 seconds, after which it will timeout and cancel the operation and return an error result before attempting to send the next bulk Office Message.
You will receive a confirmation that the bulk Office Message SMS has been sent and you will then view a summary list of the bulk Office Messages that you have sent as follows:
For each bulk Office Message that you have sent you will receive a response from the Clickatell SMS Gateway which will appear in the SMS Send Result field. If your SMS/TXT Message was successfully submitted to the Clickatell SMS Gateway you will get a response in the following format:
ID: (Number)
For example ID: cbe87b795e12d4c46eed5500459a6cee indicates the SMS/TXT Message was successfully submitted, where cbe87b795e12d4c46eed5500459a6cee is the unique ID allocated to your message by Clickatell. There is no way to check the delivery status of Office Messages sent via SMS.
You can use the following SMS Send Result Codes field to compare the response to see if the message was successfully submitted or not
The possible responses from the Clickatell SMS Gateway are:
|
SMS Send Result (Clickatell SMS Gateway Response) |
Description |
|
ID: (Number) |
Message successfully submitted (displays Clickatell Gateway Message ID) |
|
001 |
Authentication failed |
|
002 |
Unknown username or password |
|
003 |
Session ID expired |
|
004 |
Account frozen |
|
005 |
Missing session ID |
|
007 |
IP Lockdown violation You have locked down the API instance to a specific IP address and then sent from an IP address different to the one you set |
|
101 |
Invalid or missing parameters |
|
102 |
Invalid user data header |
|
103 |
Unknown API message ID |
|
104 |
Unknown client message ID |
|
105 |
Invalid destination address |
|
106 |
Invalid source address |
|
107 |
Empty message |
|
108 |
Invalid or missing API ID |
|
109 |
Missing message ID This can be either a client message ID or API message ID. For example when using the del_msg command |
|
110 |
Error with email message |
|
111 |
Invalid protocol |
|
112 |
Invalid message type |
|
113 |
Maximum message parts exceeded. The text message component of the message is greater than the permitted 160 characters (70 Unicode characters). Select concat equal to 1,2,3-N to overcome this by splitting the message across multiple messages |
|
114 |
Cannot route message This implies that the gateway is not currently routing messages to this network prefix. Please email support@clickatell.com with the mobile number in question |
|
115 |
Message expired |
|
116 |
Invalid Unicode data |
|
120 |
Invalid delivery time |
|
201 |
Invalid batch ID |
|
202 |
No batch template |
|
301 |
No credit left |
|
302 |
Max allowed credit |
In addition to these responses above from the Clickatell SMS Gateway Data Manager can also return an internal error that beings with $$ if there was a problem sending the SMS/TXT Message to the Clickatell SMS Gateway (for example if you were not connected to the Internet or your Internet connection was unavailble):
|
SMS Send Result (Data Manager Internal Error) |
Description |
|
$$-1 |
User cancelled |
|
$$12002 |
The request has timed out. (ERROR_INTERNET_TIMEOUT) |
|
$$-4230 |
The connection timed out |
|
$$-3242 |
This protocol is not supported (use only http and https) |
|
$$-30776 |
Authentication error, you need to supply a correct user name and password |
|
$$-92 |
Servername part of the url is too long |
|
$$-2110 |
Path part of the url is too long |
Other errors may be returned, specifically errors in the range 300 to 599, which are HTTP Status Codes.
When you have finished reviewing your bulk Email Message click the green Close button at the top of the screen to close the Bulk SMS window to return to the Office Messages database.