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.
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.
[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
etforeign_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