Lorsque vous utilisez notre service d’envoi de SMS, vous pouvez recevoir 3 types de retours :
- Des Accusés de Réception (si vous utilisez le SMS Premium)
- Des Réponses à vos SMS (si vous avez activé et demandé l’option)
- Des STOPS (demandes de désabonnement)
Comment nous transmettre ces URLs ?
Les URLs doivnet être vérifiées par nos services. Nous devons vérifier que votre page ne retourne rien, ni affichage, ni tags html. Vous n’avez donc qu’à nous transmettre vos URLs pour que nous les ajoutions à votre compte.
URL des Callbacks
Ces callbacks se font par requête HTTP (ou HTTPS) POST sur une URL que vous devez nous fournir par email.
Il peut s’agir de trois URL différentes, ou d’une même URL, dans laquelle vous différenciez les traitements en fonction des champs reçus.
Exemple : selon que vous recevez answer_date, delivery_date ou stop_date, vous pouvez facilement identifier le type de callback.
Restrictions particulières
La page ciblée par l’URL que vous nous fournissez ne doit rien afficher, ni même un corps de HTML vierge.
Elle doit également répondre en moins de 2 secondes. Le traitement des données reçues doit obligatoirement être fait en asynchrone.
- Enregistrez en base les données reçues.
- Activez un script/services/cron qui s’occupera de traiter ces données.
Ceci permet d’accéder les échanges entre nos servers et le(s) votre(s) sans surcharger inutilement les connexions.
La manipulation de vérification est encore manuelle, mais elle sera bientôt automatisée par un robot, qui risquerait de désactiver toute URL dont la page n’est pas conforme avec ce qui précède.
Recommandations
- Testez votre page avant de nous la transmettre, en l’appelant avec les paramètres en GET ainsi qu’en POST.
- Désactivez l’affichage des erreurs (pour éviter toute erreur warning, notice, fatal, etc…).
- N’afficher aucun message, mais redirigez les vers un fichier de log.
- Faites un kill de votre processus, aussitôt que les données reçues sont enregistrées.
- Enfin, pour de meilleurs performances, effectuez le traitement des données reçues en asynchrone : enregistrez simplement les données quelque part (fichier ou db-table) et déléguez-en le traitement par un autre script (cron ou trigger).