BulkGate Helpdesk
  • Languages iconEnglish
    • Czech

›Promotional SMS

HTTP low level API

  • Low Level API Descritpion

API administration

  • API administration

HTTP request info

  • HTTP request info

Transactional SMS

  • Send SMS notification

Promotional SMS

  • Send Bulk SMS - same text
  • Send Bulk SMS - different text

Check credit balance

  • Check credit balance

Check SMS price

  • Check SMS price

Examples of implementation

  • Transactional SMS examples
  • Promotional SMS examples

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 NAMEVALUEMANDATORYMULTIPLE (separated by semicolon)
action"sendsmsall"YesNo
usernameWallet username (see wallet credentials after login)YesNo
passwordWallet password (see wallet credentials after login)YesNo
numberRecipient number in international format, no leading zeros or a “+” sign, e.g. 447971796595 (For multiple recipients use semicolon as separator)YesYes
dataText of SMS message (max. 612 characters, or 268 characters if Unicode is used), UTF-8 encondingYesNo
unicode“1” for Unicode SMSNoNo
flash“1” for flash SMSNoNo
senderSender 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 developersNoYes
ismsSMS gateway (default 0, value 0 – 4) – log in to the BulkGate Portal and see this parameter in the price listNoYes
datelaterScheduled SMS – number of seconds since January 1 1970 00:00:00 GMTNoNo
AppIDe.g.: 123123, it allows to use one account for more applications, to receive delivery confirmations to different DELIVERY_URL or DELIVERY_EMAIL addressesNoNo
show_json“1” for response in json formatNoNo
campainIDCampaign ID for sms sorting in reports and sms historyNoNo
codingIf “data” is not in UTF-8, e.g.: ISO-8859-1NoNo
sortkeyText key for sorting SMS history and SMS repliesNoNo

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 1 is 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 3 is status (see the table with response status)
  • Where 10 is 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

STATUSDESCRIPTION
1SMS was sent
11SMS saved to SMS server outbox, possible connection problems between SMS server and SMS operator, the message will be sent again in one minute
111SMS was saved, SMS will be sent in scheduled time of delivery, set by parameter “datelater”
3Error, see the table with error reasons
4Login error

Send Bulk SMS with Same Text: Error Reasons

ERRORDESCRIPTION
9Wrong number or unavailable network
10Low credit balance
15Unauthorized numeric sender ID
22Unicode is not supported
23Message duplicity
errorOther error – username, password, SMS text or recipient number is not present
← PreviousNext →
  • “sendsmsall” action
  • API URL
    • Send Bulk SMS with Same Text: Parameters
    • Send Bulk SMS with Same Text: Response Status
    • Send Bulk SMS with Same Text: Error Reasons
SMS Gateway
TOPefekt s.r.o.
© 2019
ContactPrivacyTerms and Conditions
YouTubeFacebookLinkedInTwitterGitHub