Seven CLI

L'outil seven-cli vous fournit une solution efficace pour envoyer des SMS directement via votre console ou terminal sans détours. Cet outil puissant ne nécessite pas d'intégration API car il fonctionne en communicant directement avec notre passerelle via l'API HTTP.

Vous pouvez simplement télécharger seven-cli et l'utiliser immédiatement après le téléchargement sans installation via votre interface en ligne de commande pour envoyer des messages SMS. L'outil est compatible et a été testé avec les systèmes d'exploitation Windows XP, Windows 7, macOS, le raspberry pi et Ubuntu.

Pour une personnalisation individuelle, seven-cli offre deux modes d'utilisation : vous pouvez soit passer les paramètres requis directement comme paramètres, soit prédéfinir vos paramètres dans le fichier config.ini. Cette flexibilité fait de seven-cli un outil particulièrement convivial pour envoyer des messages SMS rapidement et facilement.

Téléchargement

Nous fournissons actuellement des builds compilés pour Windows, Linux et OSX. Si vous avez besoin de seven-cli pour un autre système d'exploitation, veuillez nous envoyer un e-mail.

Windows

Download

Raspberry PI

Download


Paramètres

Paramètres requis

--apikey Votre clé API. Créez votre clé API maintenant.

--to destinataire du SMS. Les noms de contacts et numéros de téléphone dans n'importe quel format sont possibles.

--text Le texte du SMS.

Paramètres optionnels

--sender Expéditeur du SMS. Peut contenir jusqu'à 11 caractères alphanumériques ou 16 caractères numériques.

--flash Envoie le message comme un SMS Flash. Ceux-ci sont affichés directement sur l'écran du destinataire. 1 = SMS Flash / 0 = SMS Normal (par défaut)

--delay Horodatage auquel le SMS doit être envoyé.

--udh En-tête de données unique

--ttl Période de validité en minutes (par défaut : 2880)

--label Définir optionnellement un label séparé pour chaque SMS afin que vous puissiez l'assigner à vos statistiques. Max. 100 caractères, caractères autorisés : a-z, A-Z, 0-9, .-_@.

--performance_tracking Activer le suivi des clics et de performance pour les URLs trouvées dans le texte SMS. Cela active également le raccourcisseur d'URL.

--foreign_id Entrez votre propre ID pour ce message. Vous recevrez le foreign_id en retour dans les callbacks pour les rapports de statut etc. Max. 64 caractères, caractères autorisés : a-z, A-Z, 0-9, .-_@.

--logfile Chemin vers le fichier de log. Si le fichier n'existe pas, il sera créé.

--config Chemin vers le fichier de configuration. Si un paramètre est spécifié comme argument dans l'appel et dans le fichier de config, l'argument est privilégié.

--help Affiche l'aide pour l'appel et les arguments.

--version Afficher les informations de version de l'outil.


Fichier de configuration

Ici vous pouvez voir un exemple de fichier de configuration incluant toutes les options disponibles.

Créer une clé API

[User data]
apikey = "abcdef123456...."    # Clé API de la passerelle
logfile = logfile.txt # Nom et chemin du fichier de log. Laisser vide pour désactiver le log

[SMS]
# Dans cette zone vous pouvez entrer quelques paramètres par défaut. Ceux-ci sont toujours 
# utilisés si seven-cli ne reçoit pas le paramètre respectif 
empfaenger = 49176123456789 # Destinataire ou groupe par défaut
flash = 0 # 1 = flash / 0 = pas de flash
smstext = "Hello world" # Texte SMS
sender = "Alarm" # Expéditeur du SMS

# Plus de détails sur les paramètres peuvent être trouvés ici https://docs.seven.io/fr/api-rest/points-terminaison/sms
delay = 10
udh = ""
ttl = 2880
label = "somelabel"
performance_tracking =        # 1 | 0
foreign_id = "myid"  

[Test alarm]
start = 22:51 # Aucun SMS ne sera envoyé dans cette fenêtre de temps
end = 23:20

Niveau d'erreur

seven-cli retourne le niveau d'erreur directement comme feedback. Par exemple, vous pouvez procéder dans votre fichier batch selon que la transmission SMS a été réussie.

seven-cli --apikey ... && echo "SMS a été envoyé"

Exemple

Ceci envoie un SMS au 01761234567890 avec le texte Voici le texte SMS et l'expéditeur CompanyABC. Pour simplifier, vous pouvez sauvegarder votre nom d'utilisateur et votre clé API dans config.ini, par exemple.

seven-cli \
  --apikey VOTRE_CLÉ_API \
  --to 01761234567890 \
  --text "Voici le texte SMS" \
  --sender companyABC

Journal des modifications

Version 1.8 - 11.02.2025

  • Les paramètres delay, udh, ttl, label, performance_tracking et foreign_id ont été ajoutés.

Version 1.7 - 10.04.2020

  • Renommé en seven-cli
  • Le paramètre type SMS a été supprimé
  • Optimisations mineures

Version 1.6 - 28.02.2019

  • Optimisation des performances surtout pour les SMS de masse
  • Le paramètre --to peut maintenant référer à un fichier texte contenant les numéros de téléphone
  • Type SMS Basic supprimé

Version 1.5 - 31.01.2019

  • Corrections de bugs mineurs lors de l'adressage de la passerelle SMS

Version 1.4 - 28.12.2018

  • Le paramètre --user n'est plus requis pour l'API SMS. Veuillez utiliser seulement votre clé API.

Version 1.3 - 13.01.2017

  • Ajustements dus au relancement de sms77.io

Version 1.2 - 16.09.2016

  • Le paramètre config a été ajouté.

Version 1.1 - 07.09.2015

  • Les heures d'alarme d'essai peuvent être définies
  • Fichier de log
  • Option de débogage
  • Niveau d'erreur

Version 1.0 - 14.05.2015

  • Lancement de l'outil