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
Créez votre compte
L'inscription est gratuite et vous donne 10 SMS pour vos essais.
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.
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.
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
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
Un projet ?
01 60 04 51 65
confiance
s'appuient sur SMS Vert Pro pour leurs rappels, leurs confirmations et leurs campagnes SMS.