The tool sms77-cli, 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.
Currently we provide compiled builds for Windows, Linux and OSX. If you need sms77-cli for another operating system, please contact us.
||Your HTTP Api key. This can be find in your login under Account > Einstellungen > HTTP Api|
||Recipient of the SMS. Possible are contact names and phone numbers in any format.|
||The text of the SMS|
||Sender of the SMS. Up to 11 alphanumeric or up to 16 numeric characters are possible.||
||SMS should be send as Flash SMS. These are shown directly in the receiver’s display.||
||Path to the log file. If the file does not exist, it will be recreated.||
||Path to the config file. If a parameter is specified as an argument on the call and in the config file, the argument is preferred.||
||Test call of the tool and the Api. There is no SMS sent.||
||Returns help for the call and the arguments.|
||Show version information of the tool.|
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 parameter 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
As feedback sms77-cli directly returns the error level. So you can e.g. continue in your batch file, depending on whether the SMS transmission was successful.
sms77-cli --apikey ...
if not errorlevel 1 goto smsSent
||SMS was sent|
||An error has occurred|
--text "This is the SMS text"
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.
Version 1.7 – 10.04.2020
– Renaming to sms77-cli
– Parameter SMS type has been removed
– Minor optimizations
Version 1.6 – 28.02.2019
– Performance optimization especially for sending bulk SMS
--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
--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
– Times for test alarm are definable
– Debug option
– Error level
Version 1.0 – 14.05.2015
Launch of the tool