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

Une personne devant un ordinateur portable dont le tableau de bord affiche un voyant rouge, à côté d'un smartphone qui reçoit un message

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.

Notre conseil

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

Une question ?
Un projet ?

01 60 04 51 65
Inscription gratuite 10 SMS offerts Sans engagement
Ils nous font
confiance
Depuis 2009, des réseaux nationaux, des PME et des indépendants de tous secteurs
s'appuient sur SMS Vert Pro pour leurs rappels, leurs confirmations et leurs campagnes SMS.
concession automobile
Concessions automobiles
garage
Garages et carrosseries
auto-école
Auto-écoles
transport
Transport et livraison
grande distribution
Grande distribution
e-commerce
E-commerce
prêt-à-porter
Prêt-à-porter
équipement de la maison
Équipement de la maison
jardinerie
Jardineries
restaurant
Restauration
hôtellerie
Hôtellerie
coiffure
Coiffure et esthétique
salle de sport
Salles de sport
cabinet médical
Cabinets médicaux
pharmacie
Pharmacies
cabinet vétérinaire
Cabinets vétérinaires
oculariste
Ocularistes
agence immobilière
Agences immobilières
menuiserie
Menuiserie et fenêtres
éditeur de logiciels
Éditeurs de logiciels
formation
Écoles et formation
collectivité
Collectivités régionales
secteur public
Secteur public
recouvrement
Recouvrement de créances