1. Home
  2. Apps
  3. sms77-cli

sms77-cli

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 SMS
0 = 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 on
0 = 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