Si vous souhaitez recevoir les accusés de réception en temps réel vous devrez spécifier la variable « dlr-url » avec l’URL du client où vous souhaitez être informé de l’état de l’envoi.
L’opération consiste à spécifier dans chaque requête HTTP l’URL où vous souhaitez que soit effectuée une demande à notre serveur à la réception d’une notification de l’opérateur. Pour cela, le client doit disposer d’un serveur HTTP capable de recevoir ces notifications.
Notre serveur envoie les variables par la méthode GET selon les souhaits du client, pour ce faire dans l’URL qu’il nous envoie, il doit mettre le nom de la variable suivi d’un caractère d’échappement qui contiendra la valeur, les caractères d’échappement ont la forme du caractère « % » suivi d’une lettre. L’URL suivante est un exemple :
http://my.server.com/notifica.php?remitente=%p&tel=%P&estado=%d
Les caractères d’échappement suivants sont ceux qui sont définis :
%i
Identifiant NRS transmis lors de l’envoi
%d
Valeur de l’accusé de réception
%p
Expéditeur du SMS
%P
Numéro de téléphone du destinataire du message SMS
%t
Date de l’envoi du message au format « AAAA-MM-JJ HH: MM », par exemple, « 1999-09-21 14:18 »
La valeur %d est celle que renverra l’état final de l’envoi, les valeurs possibles sont :
- 1 Le destinataire a reçu le message.
- 2 Le destinataire n’a pas pu recevoir le message.
- 4 Le SMSC a reçu le message, il s’agit d’une notification intermédiaire et non d’un résultat final
- 16 Impossible de délivrer au dernier opérateur
Exemple d’envoi de SMS
Pour mieux illustrer le processus, nous vous présentons par la suite un exemple d’envoi de SMS de réception de son accusé de réception.
Nous envoyons d’abord un SMS avec la variable dlr-url pour indiquer l’URL où nous souhaitons recevoir la notification de réception, nous ajouterons à cette URL notre identifiant d’envoi pour identifier sans ambiguïté le moment de la réception. L’URL finale de la notification est :
https://gateway.nrsgateway.comn/send.php?username=tu_user&password=tu_login&to=3465467445+34627455334+34627545454&text=Prueba+de+envio&from=TEST&coding=0&dlr-mask=8&dlr-url=http%3A%2F%2Fmi.server.com%2Fnotifica.php%3Fidenvio%3D7584remitente%3D%25p%26tel%3D%25P%26estado%3D%25d
En supposant que tous les messages peuvent être reçus, nous recevrons avec le script notifica.php trois demandes avec l’état = 1, expéditeur = ESSAI, idenvoi = 7584 et le numéro de téléphone correspondant.