SMStoHTTP

Documentation

Fonctionnement

Lorsqu'un SMS contenant un de vos mots clés est reçu sur le numéro de téléphone indiqué dans votre compte, alors SMStoHTTP appelera via GET ou POST la page que vous aurez indiquée (en lui transmettant les paramètres indiqués ci-dessous). À vous ensuite de traiter ces informations.

Mon compte

Depuis mon compte vous pouvez ajouter des mots clés. Un mot clé est composé exclusivement de lettres et de chiffres. Les accents et caractères spéciaux ne sont pas autorisés. Pour chaque mot clé vous indiquez :
C'est sur mon compte que vous trouverez pour chaque mot clé le numéro de téléphone auquel le mot clé doit être envoyé.

Page appelée

Que la méthode soit GET ou POST les paramètres transmis à votre page sont les même. Il s'agit de :

Sécuritée

Pour vous assurer que c'est bien SMStoHTTP qui appelle votre page vous pouvez vérifier trois choses :

Sondages

SMStoHTTP vous permet de réaliser facilement des sondages par SMS.
Concrètement, vous louez un mot clé, par exemple SECRETSTORY. Puis vous demandez à vos clients de voter en envoyant SECRETSTORY 1 pour Flora, SECRETSTORY 2 pour Sebastien ou SECRETSTORY 3 pour Thomas au +336xxxxxxxx. Et SMStoHTTP va compter les réponses pour vous et vous afficher un graphique.

Mise en place

  1. Allez sur Mon compte,
  2. Louez le mot clé de votre choix,
  3. Puis dans la partie Sondages, créez un nouveau sondage :
  4. C'est bon, vous pouvez consulter les réponses en cliquant sur le lien Résultats.

Remarques

API

Historique des SMS reçus

Récupérer la liste de tous les SMS reçus sur un mot clé :
http://api.smstohttp.fr/keyword/votre-mot-cle/sms/la-cle-du-mot-cle
où :
Format de retour : json. Exemple de retour :
{
"keyword":"votre-mot-cle",
"sms":[
 {"message":"le message après le mot clé dans le cas d'un mot clé étendu",
 "tel":"le numéro de téléphone qui a envoyé le message, au format international +336xxxxxxxx",
 "date":"la date de réception du message au format Y-m-d H:i:s"}
]
}

Résultats d'un sondage

Récupérer le nombre de votes par réponse pour un sondage :
Retrouvez l'adresse directement sur la page Résultats de votre sondage, accessible depuis Mon compte.

Format de retour : json. Exemple de retour :
{
"title":"le nom de votre sondage",
"responses":[
 {"name":"la signification de la réponse",
 "number":le nombre de votes}
]
}