Envoyer des SMS en PHP
avec notre API

Quelques lignes de PHP suffisent pour envoyer un SMS depuis votre site ou votre logiciel, sans bibliothèque à installer.

Notre API reçoit une requête HTTP en JSON, contrôle les numéros, applique votre liste STOP et transmet le message aux opérateurs. Votre code n'a qu'à préparer le texte et les destinataires, puis à lire la réponse.

Les exemples de cette page n'utilisent que cURL et les fonctions JSON de PHP. Nous les avons exécutés de PHP 7.4 à PHP 8.4, sans aucune dépendance à ajouter à votre projet.

Vous travaillez plutôt en Python ? Le même appel est détaillé sur notre page API SMS en Python.

Avant d'écrire le code

1

Créez votre compte

L'inscription est gratuite et vous donne 10 SMS pour vos essais.

2

Récupérez votre token

Il s'affiche depuis votre espace client ou depuis la documentation de l'API. Il reste le même tant que vous ne le renouvelez pas.

3

Rangez-le hors du code

Dans une variable d'environnement, ici SMSVERTPRO_TOKEN, plutôt que dans un fichier versionné.

Envoyer un SMS en PHP

La fonction ci-dessous sert pour toutes les requêtes de l'API. Elle prend le nom de la requête et ses paramètres, puis renvoie la réponse sous forme de tableau.

function smsVertPro(string $route, array $donnees = []): array
{
    $ch = curl_init('https://www.smsvertpro.com/api/v2/' . $route);
    curl_setopt_array($ch, [
        CURLOPT_POST           => true,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_TIMEOUT        => 30,
        CURLOPT_HTTPHEADER     => [
            'Content-Type: application/json',
            'Authorization: Bearer ' . getenv('SMSVERTPRO_TOKEN'),
        ],
        CURLOPT_POSTFIELDS     => json_encode($donnees ?: new stdClass()),
    ]);
    $corps = curl_exec($ch);
    if ($corps === false) {
        return ['status' => 'CURL_ERROR', 'detail' => curl_error($ch)];
    }
    $reponse = json_decode($corps, true);
    return is_array($reponse) ? $reponse : ['status' => 'REPONSE_ILLISIBLE'];
}

$envoi = smsVertPro('send_sms', [
    'message'    => [
        'sender' => 'MonGarage',
        'text'   => 'Bonjour, votre commande est arrivée en magasin.',
    ],
    'recipients' => ['33612345678'],
]);

if (($envoi['status'] ?? '') !== 'SEND_OK') {
    exit('Envoi refusé : ' . ($envoi['status'] ?? 'réponse vide'));
}
echo 'Campagne ' . $envoi['id'] . ' : ' . $envoi['nbsms'] . ' SMS, solde ' . $envoi['credits'];

Le champ sender porte le nom affiché sur le téléphone, limité à 11 lettres ou chiffres, sans accent ni espace. Le champ recipients accepte un ou plusieurs numéros au format international.

Gardez l'identifiant renvoyé dans id, qui sert à suivre la remise. Si certains numéros sont écartés, parce qu'ils sont impossibles ou dans votre liste STOP, la réponse les liste dans rejected avec leur motif, et ils ne sont pas décomptés.

Les réponses à prévoir dans votre code

Chaque réponse porte un champ status, accompagné d'un code HTTP. Voici ceux qu'un envoi rencontre le plus souvent.

Statut Signification Que faire
SEND_OK Envoi accepté (200) Conserver l'identifiant de la campagne
NOT_ENOUGH_CREDITS Solde insuffisant (402) Recharger le compte, puis renvoyer
INVALID_USER Token absent, faux ou renouvelé (401) Vérifier la variable d'environnement
GSM_ERROR Aucun numéro envoyable (400) Lire le détail dans rejected
STOPSMS_ERROR Mention STOP manquante dans un envoi commercial (400) Ajouter STOP 36XXX à la fin du texte
EMOJI_NOT_ALLOWED Émoji dans le texte (400) Le retirer, ou demander l'option émojis
DELAY_ERROR Date d'envoi passée ou illisible (400) Utiliser le format AAAA-MM-JJ HH:MM:SS
CURL_ERROR Pas de réponse, propre à la fonction de cette page Réessayer quelques minutes plus tard

La liste complète des statuts est dans la documentation de l'API.

Suivre la remise et le solde

Avec l'identifiant de la campagne, la même fonction lit le rapport de remise, numéro par numéro. Une autre requête donne le solde du compte.

$rapport = smsVertPro('reports', ['campaign_id' => $envoi['id']]);
foreach ($rapport['campaigns'][0]['sms'] ?? [] as $sms) {
    echo $sms['gsm'] . ' : ' . $sms['status'] . PHP_EOL;
}

$solde = smsVertPro('credits');
echo 'Crédits restants : ' . $solde['credits'];

Un SMS remis passe en DELIVERED. PENDING signifie que l'accusé de réception n'est pas encore revenu, souvent parce que le téléphone est éteint. Relisez alors le rapport un peu plus tard. UNDELIVERABLE, EXPIRED et REJECTED marquent un message qui n'a pas été remis.

Les autres requêtes utiles

Programmer un envoi

Une date dans delay fait partir le message à l'heure prévue. Avec delay_cancel à true, la requête cancel peut encore l'annuler et rendre les crédits.

Envoyer un code OTP

generate_otp envoie un code à 6 chiffres, verify_otp contrôle celui que saisit l'utilisateur.

Lire les réponses

responses renvoie les SMS reçus en retour d'une campagne partie avec notre numéro court.

Notre conseil

Faites vos premiers essais vers votre propre portable, avec les 10 SMS offerts. Enregistrez ensuite chaque statut reçu dans vos journaux, pour comprendre tout de suite un refus le jour où il arrive.

Sans écrire d'appel HTTP

Un développeur devant deux écrans, à côté d'un smartphone qui reçoit un message

Votre site tourne sous WordPress ? Notre plugin WordPress fait le même travail depuis l'administration, sans une ligne de PHP.

Pour qu'un assistant IA envoie lui-même des SMS, notre serveur MCP en PHP s'installe en quelques minutes et s'appuie sur la même API.

Questions fréquentes

Non. L'extension cURL et les fonctions JSON de PHP suffisent, et elles sont présentes dans presque toutes les installations. Si votre projet utilise déjà Guzzle ou un autre client HTTP, la même requête s'écrit aussi avec lui.

Mettez tous les numéros dans le tableau recipients d'une seule requête. Chaque destinataire reçoit son propre SMS, et le rapport de l'envoi donne le statut de chacun.

Au format international sans le signe +, comme 33612345678. Un portable français écrit en 06 ou 07 est converti automatiquement. Pour un numéro local d'un autre pays, ajoutez son code pays à côté du numéro.

Oui, c'est du PHP sans dépendance. Vous pouvez placer la fonction dans un service de votre framework et lire le token dans sa configuration plutôt qu'avec getenv().

Il demande PHP 7 ou plus récent, à cause des types déclarés et de l'opérateur ??. Nous l'avons exécuté de PHP 7.4 à PHP 8.4.

Un SMS fait 160 caractères. Au-delà, le texte est découpé en parties de 153 caractères, et chaque partie compte pour un SMS. Le champ nbsms de la réponse indique le total, et notre compteur de caractères permet de le vérifier avant l'envoi.

À 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