Send Bulk SMS - same text
“sendsmsall” action
It allows to send a short text message with the same text to one or more recipients.
See the table of parameters for this command. To send the message to several recipients, assign the value of parameter ”number” with telephone numbers separated with semicolon. The maximum number of recipients of each request is unlimited.
API URL
https://api.bulkgate.com/http/
Send Bulk SMS with Same Text: Parameters
| PARAMETER NAME | VALUE | MANDATORY | MULTIPLE (separated by semicolon) |
|---|---|---|---|
| action | "sendsmsall" | Yes | No |
| username | Wallet username (see wallet credentials after login) | Yes | No |
| password | Wallet password (see wallet credentials after login) | Yes | No |
| number | Recipient number in international format, no leading zeros or a “+” sign, e.g. 447971796595 (For multiple recipients use semicolon as separator) | Yes | Yes |
| data | Text of SMS message (max. 612 characters, or 268 characters if Unicode is used), UTF-8 encoding | Yes | No |
| unicode | “1” for Unicode SMS | No | No |
| sender | Sender of SMS (number in international format, no leading zeros or a “+” sign, e.g. 447971796595 or text max. 11 characters, e.g. “eshop.com”). "isms" parameter is mandatory for using text sender ID. To choose the right "isms" parameter, log in to the Portal and display the price list. "isms" parameter value is displayed if you hover over the wrench icon for developers | No | Yes |
| isms | SMS gateway (default 0, value 0 – 4) – log in to the BulkGate Portal and see this parameter in the price list | No | Yes |
| datelater | Scheduled SMS – number of seconds since January 1 1970 00:00:00 GMT | No | No |
| AppID | e.g.: 123123, it allows to use one account for more applications, to receive delivery confirmations to different DELIVERY_URL or DELIVERY_EMAIL addresses | No | No |
| show_json | “1” for response in json format | No | No |
| campainID | Campaign ID for sms sorting in reports and sms history | No | No |
| coding | If “data” is not in UTF-8, e.g.: ISO-8859-1 | No | No |
| sortkey | Text key for sorting SMS history and SMS replies | No | No |
Example request for sending SMS with Text sender ID:
action=sendsmsall&username=testuser&password=test123&number=420606123456;420607123456&data=Hello&sender=testSender&isms=2
Response to this command may be:
In case of success:
<stat>1</stat><info>2556b1d0-5ced-11e3-8a4f-00000a0a0211</info>
- Where
1is status (see the table with response status) - 2556b1d0-5ced-11e3-8a4f-00000a0a0211 is unique smsID of message
In case of error:
<stat>3</stat><info>10</info>
- Where
3is status (see the table with response status) - Where
10is error reason (see the table with error reasons)
If a message was sent to several recipients, each message response is separated by:
- QQQ___QQQ
Example:
<stat>1</stat><info>6b1d01231231231</info>QQQ___QQQ<stat>3</stat><info>9</info>
Send Bulk SMS with Same Text: Response Status
| STATUS | DESCRIPTION |
|---|---|
| 1 | SMS was sent |
| 11 | SMS saved to SMS server outbox, possible connection problems between SMS server and SMS operator, the message will be sent again in one minute |
| 111 | SMS was saved, SMS will be sent in scheduled time of delivery, set by parameter “datelater” |
| 3 | Error, see the table with error reasons |
| 4 | Login error |
Send Bulk SMS with Same Text: Error Reasons
| ERROR | DESCRIPTION |
|---|---|
| 9 | Wrong number or unavailable network |
| 10 | Low credit balance |
| 15 | Unauthorized numeric sender ID |
| 22 | Unicode is not supported |
| 23 | Message duplicity |
| error | Other error – username, password, SMS text or recipient number is not present |