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.
Download
Currently we provide compiled builds for Windows, Linux and OSX. If you need sms77-cli for another operating system, please contact us.
Linux Download
macOS Download
Windows Download
Raspberry
Required parameters
Parameter | Description |
---|---|
--apikey |
Your HTTP Api key. This can be find in your login under Account > Einstellungen > HTTP Api |
--to |
Recipient of the SMS. Possible are contact names and phone numbers in any format. |
--text |
The text of the SMS |
Optional parameters
Parameter | Beschreibung | Beispiele |
---|---|---|
--sender |
Sender of the SMS. Up to 11 alphanumeric or up to 16 numeric characters are possible. | companyABC 001631234567890 |
--flash |
SMS should be send as Flash SMS. These are shown directly in the receiver’s display. | 1 = Flash SMS0 = normal SMS (default) |
--logfile |
Path to the log file. If the file does not exist, it will be recreated. | /var/log/sms77-cli c:\sms77-cli\logfile |
--config |
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. | /etc/sms77-cli/config.ini c:\sms77-cli\config.ini |
--debug |
Test call of the tool and the Api. There is no SMS sent. | 1 = debug on0 = off (default) |
--help |
Returns help for the call and the arguments. | |
--version |
Show 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 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
Error level
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
Errorlevel | Beschreibung |
---|---|
0 |
SMS was sent |
1 and higher |
An error has occurred |
Example
sms77-cli.exe
--apikey YOUR_API_KEY
--to 01761234567890
--text "This is the SMS text"
--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.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
– 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