Envoyer un SMS en Python
en quelques lignes
Un rappel, une alerte ou un envoi à toute une liste partent d'un simple script Python, grâce à notre API.
Notre API REST reçoit vos messages en JSON, vérifie les numéros, applique votre liste STOP et les transmet aux opérateurs. Côté Python, une seule fonction suffit pour toutes les requêtes, de l'envoi au rapport de remise.
Les exemples s'appuient sur la bibliothèque requests, la plus répandue pour les appels HTTP. Pour les essayer, il vous faut un compte, gratuit et livré avec 10 SMS, et le token affiché dans votre espace client.
Envoyer un SMS en Python
Le token est lu dans la variable d'environnement SMSVERTPRO_TOKEN, pour ne jamais l'écrire dans le code. Le paramètre json de requests encode le corps et pose l'en-tête attendu par l'API.
import os
import requests
API = "https://www.smsvertpro.com/api/v2/"
def sms_vert_pro(route, donnees=None):
reponse = requests.post(
API + route,
json=donnees or {},
headers={"Authorization": "Bearer " + os.environ["SMSVERTPRO_TOKEN"]},
timeout=30,
)
try:
return reponse.json()
except ValueError:
return {"status": "REPONSE_ILLISIBLE", "http": reponse.status_code}
envoi = sms_vert_pro("send_sms", {
"message": {
"sender": "MonCabinet",
"text": "Rappel : votre rendez-vous est demain à 10h.",
},
"recipients": ["33612345678"],
})
if envoi.get("status") != "SEND_OK":
raise SystemExit("Envoi refusé : " + str(envoi.get("status")))
print(f"Campagne {envoi['id']} : {envoi['nbsms']} SMS, solde {envoi['credits']}")
Le nom placé dans sender s'affiche sur le téléphone du destinataire. Chaque numéro se note en format international, sans le +, mais un 06 ou un 07 français passe aussi, l'API le convertit.
Lire la réponse de l'API
La réponse arrive sous forme de dictionnaire. Son champ status dit tout de suite si l'envoi est parti.
Un envoi accepté
SEND_OK, avec id pour suivre la campagne, nbsms pour le nombre de SMS décomptés et credits pour le solde restant.
Des numéros écartés
Le champ rejected n'apparaît que si des numéros impossibles ou inscrits en liste STOP ont été mis de côté. Si aucun ne reste, le statut devient GSM_ERROR.
Un solde trop bas
NOT_ENOUGH_CREDITS signale que le solde ne couvre pas l'envoi. Rien n'est parti, et rien n'est décompté.
Un token refusé
INVALID_USER arrive quand le token manque, est faux ou a été renouvelé depuis votre espace client.
Un envoi commercial sans mention STOP 36XXX peut aussi revenir en STOPSMS_ERROR. Les autres statuts, avec leur code HTTP, sont listés dans la documentation de l'API.
Envoyer à une liste tirée d'un fichier CSV
Pour prévenir tous vos clients d'une fermeture, il suffit de lire leurs numéros dans un export de votre logiciel, ici un fichier séparé par des points-virgules avec une colonne telephone.
import csv
with open("clients.csv", newline="", encoding="utf-8") as fichier:
numeros = [ligne["telephone"] for ligne in csv.DictReader(fichier, delimiter=";")]
envoi = sms_vert_pro("send_sms", {
"message": {
"sender": "MonCabinet",
"text": "Le cabinet sera fermé ce samedi. Réouverture lundi à 9h.",
},
"recipients": numeros,
})
print(envoi.get("status"), "-", len(envoi.get("rejected", [])), "numéro(s) écarté(s)")
Pas besoin de nettoyer la colonne avant l'envoi. L'API retire les espaces et les points des numéros, convertit les 06 et 07, et met de côté ceux qui sont impossibles ou inscrits dans votre liste STOP, sans les décompter.
Chaque destinataire reçoit son propre SMS, sans voir les numéros des autres. Pour un message commercial, n'oubliez pas la mention STOP 36XXX en fin de texte.
Un script d'alerte qui tourne tout seul
Python sert souvent à surveiller l'espace disque d'un serveur, une sauvegarde de la nuit ou la température d'une chambre froide. Lancé toutes les cinq minutes par cron ou par le planificateur de tâches de Windows, un script appelle la fonction dès qu'une valeur sort des bornes.
Pensez à n'envoyer qu'au changement d'état, pour éviter un SMS toutes les cinq minutes pendant la panne. Si vos alertes doivent partir la nuit ou le week-end, demandez à passer votre compte sur notre route alerte, ouverte 24 h sur 24.
Dans un script qui tourne sans surveillance, entourez l'appel d'un try et d'un except requests.RequestException. Une coupure réseau sera alors notée dans vos journaux au lieu d'arrêter le traitement en cours.
Questions fréquentes
Non, mais elle simplifie le code. Sans elle, le module urllib.request de la bibliothèque standard fait la même requête, à condition d'ajouter vous-même l'en-tête Content-Type: application/json et d'encoder le corps en JSON.
Python 3.6 ou plus récent, pour les f-strings de l'exemple. Nous avons exécuté le code de cette page avec Python 3.12.
Appelez la requête reports avec l'identifiant de la campagne, par exemple sms_vert_pro("reports", {"campaign_id": envoi["id"]}). Elle renvoie le statut de chaque numéro, comme DELIVERED pour un SMS remis ou PENDING tant que l'accusé n'est pas revenu.
Oui. La fonction ne dépend d'aucun framework. Placez-la dans un module de votre projet et lisez le token dans vos réglages. Dans une vue qui doit répondre vite, lancez l'envoi en tâche de fond.
À découvrir également
Un projet ?
01 60 04 51 65
confiance
s'appuient sur SMS Vert Pro pour leurs rappels, leurs confirmations et leurs campagnes SMS.