1. Home
  2. Docs
  3. Gateway
  4. Batchsend77

Batchsend77

The tool Batchsend77, which is provided free of charge, allows you to send SMS directly via console/terminal without having to integrate one of the APIs. For this the tool addresses our gateway via the HTTP Api – a functioning internet connection is therefore a prerequisite.

Download the tool and call it from your command line tool to send an SMS. The tool doesn’t have to be installed, but can be executed directly after the download. Tested on Windows XP, Windows 7, MacOS Yosem ite, macOS Sierra and Ubuntu.

The tool can optionally be called completely via the command line or the parameters are specified by the config.ini.

Download

Currently we provide compiled builds for Windows, Linux and OSX. If you need Batchsend77 for another operating system, please contact us.

Linux Download
macOS Download
Windows Download
Raspberry

Required parameters

ParameterDescription
--apikeyYour HTTP Api key. This can be find in your login under Account > Einstellungen > HTTP Api
--toRecipient of the SMS. Possible are contact names and phone numbers in any format.
--textThe text of the SMS

Optional parameters

ParameterBeschreibungBeispiele
--typeThe desired SMS type. If this parameter is not set, the default SMS type from your SMS settings will be used.economy
direct
--senderSender of the SMS. Up to 11 alphanumeric or up to 16 numeric characters are possible.companyABC
001631234567890
--flashSMS should be send as Flash SMS. These are shown directly in the receiver’s display.1 = Flash SMS
0 = normal SMS (default)
--logfilePath to the log file. If the file does not exist, it will be recreated./var/log/batchsend77
c:\batchsend77\logfile
--configPath to the config file. If a parameter is specified as an argument on the call and in the config file, the argument is preferred./etc/batchsend77/config.ini
c:\batchsend77\config.ini
--debugTest call of the tool and the Api. There is no SMS sent.1 = debug on
0 = off (default)
--helpReturns help for the call and the arguments.
--versionShow version information of the tool.

Config file

Here is an example of a configuration file including all available options.

[user data]
# Please enter your user data here. Your gateway key can be found in your 
# Account under Account > Settings > HTTP API
apikey =                      # Gateway API key
logfile = logfile.txt         # name and path of the logfiles (leave empty to disable log)

[SMS]
# In this area you can specify some default parameter. These are always used 
# if the SMS77 tool does not obtain the respective paramater
smstyp =                      # default SMS type (economy oder  direct)
empfaenger =                  # default recipient or group
flash =                       # 1 = Flash / 0 = no Flash
smstext =                     # SMS text
absender =                    # sender of SMS (only available for Quality and Direct SMS)
debug = 0                     # 1 = debug on / 0 = debug off

[test alarm]
start = 22:51                 # Within this time window no SMS will be sent
ende = 23:20

Error level

As feedback Batchsend77 directly returns the error level. So you can e.g. continue in your batch file, depending on whether the SMS transmission was successful.

batchsend77 --apikey ...
if not errorlevel 1 goto smsSent

ErrorlevelBeschreibung
0SMS was sent
1 and higherAn error has occurred

Example

batchtool77.exe
--apikey YOUR_API_KEY
--to 01761234567890
--text "This is the SMS text"
--type direct
--sender companyABC

This sends a Direct SMS to 01761234567890 with the text This is the SMS text and sender companyABC. For the sake of simplicity you can save e.g. your API key in the config.ini.

Changelog

Version 1.6 – 28.02.2019

– Performance optimization especially for sending bulk SMS
– Parameter --to can now point to a text file containing the phone numbers
– SMS type Basic removed

Version 1.5 – 31.01.2019

Minor bug fixes when addressing the SMS gateway

Version 1.4 – 28.12.2018

Parameter --user no longer required for the SMS API. Please only use your API Key.

Version 1.3 – 13.01.2017

Adjustments due to the sms77.io relaunch

Version 1.2 – 16.09.2016

The config parameter has been added.

Version 1.1 – 07.09.2015

New funktions:
– Times for test alarm are definable
– Logfile
– Debug option
– Error level

Version 1.0 – 14.05.2015

Launch of the tool

Was this article helpful to you? Yes No 1
Menu