SOLUTIONS DE SMS MARKETING

Plateforme de SMS Professionnel & Réalisation de Campagne SMS Géociblée

Envoi automatisé de SMS par HTTP

Intégrez dans vos développements web l'envoi de SMS grâce à notre API HTTP !
API HTTP POST : Envoi de données XML
Important : L'encodage supporté est : ISO-8859-15 (Europe de l'Ouest)

1. Envoi de SMS en Qualité "PRO"


URL de notre serveur SMS "PRO" (pour la qualité "ECO", voir plus bas) : http://sms.capitolemobile.com/api/sendsms/xml

La chaîne de caractère constituant le SMS doit commencer par : XML= puis contenir la structure de données suivante :

<SMS>

<authentification>
<username></username>
<password></password>
</authentification>

<message>
<text></text>
<sender></sender>
<flash></flash>
<type></type>
<route></route>
<progmin></progmin>
<progmax></progmax>
</message>

<recipients>
<gsm></gsm>
<gsm></gsm>
<gsm></gsm>
</recipients>

</SMS>

Authentification


username : Votre identifiant de connexion (login)
password : Votre mot de passe de connexion

Message


text : Message du SMS
sender : (Optionnel) par défaut n° court ou bien sender personnalisé (11 caractères max.)
flash : (Optionnel) par défaut "no", si "yes" affichage "Flash, classe 0"
long : (Optionnel) par défaut "no", si "yes" concaténation de SMS possibles (jusqu'à 4 SMS)
route * : (Optionnel) "M" (envoi "Marketing"), "N" (envoi "Notification") par défaut
progmin : (Optionnel) par défaut "0", heure à partir de laquelle le SMS doit être envoyé (si progmin=9, le SMS peut être envoyé à partir de 09h00, heure France Métropolitaine)
progmax : (Optionnel) par défaut "24", heure jusqu'à laquelle le SMS doit être envoyé (si progmax=15, le SMS peut être envoyé jusqu'à 15h00, heure France Métropolitaine)

* Si vous utilisez une route Marketing "M" (trafic publicitaire), une mention "STOP" (" STOP au 36XXX", 14 caractères) est automatiquement ajoutée en fin de message (en France Métropolitaine seulement). Veillez à prendre en compte cet ajout dans votre décompte de caractères.

Recipients


gsm : Numéro de téléphone (si l'indicatif international n'est pas indiqué, le numéro est considéré comme provenant de France Métropolitaine)


2. Envoi de SMS en Qualité "ECO" (France Mét. seulement)


URL de notre serveur SMS "ECO" : http://sms.capitolemobile.com/api/sendsms/eco/xml

La chaîne de caractère constituant le SMS doit commencer par : XML= puis contenir la structure de données suivante :

<SMS>

<authentification>
<username></username>
<password></password>
</authentification>

<message>
<text></text>
<route></route>
</message>

<recipients>
<gsm></gsm>
<gsm></gsm>
<gsm></gsm>
</recipients>

</SMS>

Authentification


username : Votre identifiant de connexion (login)
password : Votre mot de passe de connexion

Message


text : Message du SMS
route * : (Optionnel) "M" (envoi "Marketing"), "N" (envoi "Notification") par défaut

* Si vous utilisez une route Marketing "M" (trafic publicitaire), une mention "STOP" (en " no-pub.fr/xxx", 14 caractères) est automatiquement ajoutée en fin de message. Veillez à prendre en compte cet ajout dans votre décompte de caractères.

Recipients


gsm : Numéro de téléphone français (France Mét.), le service "ECO" n'étant disponible qu'en France Métropolitaine.
Réponse à la requête HTTP POST
Lorsqu'un envoi est réalisé avec succès, en réponse à votre appel HTTP vous recevez un code : SENDING_OK

Dans le cas contraire vous recevez l'un des codes "erreur" suivant :

AUTH_FAILED : Erreur d'authentification (identifiant / mot de passe) ou l'option "API" désactivée
NO_RECIPIENT : Manque destinataire
NOT_ENOUGH_CREDITS : Solde insuffisant pour procéder à l'envoi
EMPTY_MESSAGE : Message vide
TOO_LONG_MESSAGE : Le message est trop long pour être envoyé (voir option "long")
_IS_BLACKLISTED : le numéro du destinatiaire apparaît dans votre blacklist
_IS_INVALID : Le numéro du destinataire est invalide
TOO_LONG_SENDER : (Avertissement) Le nom d'émetteur sélectionné est trop long (plus de 11 caractères). Il est automatiquement remplacé par un n° court.

En plus du code réponse, vous recevez l'état du solde de votre compte (ex : SENDING_OK;9542)
Exemple d'intégration PHP
Important : L'encodage supporté est : ISO-8859-15 (Europe de l'Ouest)
<?php
// CapitoleMobile POST URL
$postUrl = "http://sms.capitolemobile.com/api/sendsms/xml";
//Structure de Données XML
$xmlString = '<SMS>
<authentification>
<username>xxxxxxxxxxx</username>
<password>xxxxxxxxxxx</password>
</authentification>
<message>
<text>Hello World !</text>
<sender>Ma Marque</sender>
</message>
<recipients>
<gsm>0611223344</gsm>
<gsm>34622334455</gsm>
<gsm>633445566</gsm>
</recipients>
</SMS>';
// insertion du nom de la variable POST "XML" avant les données au format XML
$fields = "XML=" . urlencode(utf8_encode($xmlString));
// dans cet exemple, la requête POST est realisée grâce à la librairie Curl
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $postUrl);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $fields);
// Réponse de la requête POST
$response = curl_exec($ch);
curl_close($ch);
// Ecriture de la réponse
echo $response;
?>

Connectez-vous à nos serveurs d'envoi de SMS en utilisant notre API HTTP



Pour pouvoir utiliser l'API veuillez ouvrir un compte, vous connecter puis l'activer en vous rendant sur "SMS" > "Mon Api"

Enregistrement à la CNIL
Hébergement en France
Depuis 2009 dans le Marketing Digital
Inscription Gratuite et Sans Engagement !
10 SMS PRO Offerts à l'ouverture de votre compte

Fia Net
Paiement par CB
Paiement par Virement et Prélèvement
Paiement par Chèque
Quelques Références
Canal Plus
Boîte à Pizza
Saint Denis
Pro & Cie
Expert
Pulsat