Seven CLI

The seven-cli tool provides you with an efficient solution for sending SMS directly via your console or terminal without any detours. This powerful tool does not require API integration as it works by communicating directly with our gateway via the HTTP API.

You can simply download seven-cli and use it immediately after the download without installation via your command line interface to send SMS messages. The tool is compatible and has been tested with the operating systems Windows XP, Windows 7, macOS, the raspberry pi and Ubuntu.

For individual customization, seven-cli offers two usage modes: you can either pass the required parameters directly as parameters or predefine your settings in the config.ini file. This flexibility makes seven-cli a particularly user-friendly tool for sending SMS messages quickly and easily.

Download

We currently provide compiled builds for Windows, Linux and OSX. If you need seven-cli for another operating system, please send us an e-mail.

Parameter

Required parameters

--apikey Your API key. Create your API key now.

--to recipient of the SMS. Contact names and phone numbers in any format are possible.

--text The text of the SMS.

Optional parameters

--sender Sender of the SMS. This can contain up to 11 alphanumeric or 16 numeric characters.

--flash Sends message as a Flash SMS. These are shown directly on the recipient's display. 1 = Flash SMS / 0 = Normal SMS (default)

--logfile Path to the log file. If the file does not exist, it will be created.

--config Path to the config file. If a parameter is specified as an argument in the call and in the config file, the argument is preferred.

--help Outputs help for the call and the arguments.

--version Display version information of the tool.

Configuration file

Here you can see an example of a configuration file including all available options.

Create API key

[User data]
apikey = "abcdef123456...."    # Gateway API key
logfile = logfile.txt # Name and path of the logfile. Leave empty to deactivate log

[SMS]
# In this area you can enter some default parameters. These are always 
# used if seven-cli is not given the respective parameter 
empfaenger = 49176123456789 # Default recipient or group
flash = 0 # 1 = flash / 0 = no flash
smstext = "Hello world" # SMS text
sender = "Alarm" # Sender of the SMS

[Test alarm]
start = 22:51 # No SMS will be sent within this time window
end = 23:20

Errorlevel

seven-cli returns the error level directly as feedback. For example, you can proceed in your batch file depending on whether the SMS transmission was successful.

seven-cli --apikey ... && echo "SMS was sent"

Example

This sends an SMS to 01761234567890 with the text Here is the SMS text and sender CompanyABC. For the sake of simplicity, you can save your user name and your API key in config.ini, for example.

seven-cli \
  --apikey YOUR_API_KEY \
  --to 01761234567890 \
  --text "Here is the SMS text" \
  --sender companyABC

Changelog

Version 1.7 - 10.04.2020

Renamed to seven-cli
Parameter SMS type was removed
Minor optimizations

Version 1.6 - 28.02.2019

Performance optimization especially for mass SMS
Parameter --to can now refer 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 was added.

Version 1.1 - 07.09.2015

Trial alarm times can be set
Logfile
Debug option
Error level

Version 1.0 - 14.05.2015

Launch of the tool