API SMS

Votre username, transmis à l'inscription

Votre password, transmis à l'inscription

Numéro du destinataire avec indicatif (+33...) ou au format international (0033...). Vous pouvez ajouter jusqu'à 500 msisdn séparés d'une virgule : +336xxxx1,+336xxxx2,+336xxxx3

Contenu du message.

Le contenu du message est limité à 160 caractères pour un SMS standard (qui utilise l'alphabet GSM – attention aux caractères comptant double, comme €). Nous autorisons avec l'option "messages longs" un envoi de 7 SMS de 153 caractères (la concaténation des SMS utilise 7 caractères par message). Si vos besoins impliquent une taille de message supérieure à 7 x 153 caractères, merci de contacter le support pour demander une analyse du besoin et un paramétrage spécifique. Des limitations imposées par l'opérateur peuvent s'imposer.

Votre username, transmis à l'inscription

Votre password, transmis à l'inscription

Numéro du destinataire avec indicatif (+33...) ou au format international (0033...). Vous pouvez ajouter jusqu'à 500 msisdn séparés d'une virgule : +336xxxx1,+336xxxx2,+336xxxx3

Contenu du message.

Le contenu du message est ici limité à 70 caractères - l'encoding utilisé en "messages Unicode" est l'UCS-2. Nous autorisons avec l'option "messages longs" un envoi de 7 SMS de 67 caractères (la concaténation des SMS utilise 3 caractères par message). Si vos besoins impliquent une taille de message supérieure à 7 x 67 caractères, merci de contacter le support pour demander une analyse du besoin et un paramétrage spécifique. Des limitations imposées par l'opérateur peuvent s'imposer.

Permet l'utilisation de l'Unicode.

Si le contenu du SMS l'impose (présence de caractères NON GSM 03.38) alors le SMS est envoyé en unicode.

Sans ce paramètre, votre message sera converti pour être envoyé au format alphabet GSM (GSM 03.38 ) après transformation des caractères dans des équivalents proches.

Votre username, transmis à l'inscription

Votre password, transmis à l'inscription

Numéro du destinataire avec indicatif (+33...) ou au format international (0033...). Vous pouvez ajouter jusqu'à 500 msisdn séparés d'une virgule : +336xxxx1,+336xxxx2,+336xxxx3

Contenu du message.

Le contenu du message est limité à 160 caractères pour un SMS standard (qui utilise l'alphabet GSM – attention aux caractères comptant double, comme €). Nous autorisons avec l'option "messages longs" un envoi de 7 SMS de 153 caractères (la concaténation des SMS utilise 7 caractères par message). Si vos besoins impliquent une taille de message supérieure à 7 x 153 caractères, merci de contacter le support pour demander une analyse du besoin et un paramétrage spécifique. Des limitations imposées par l'opérateur peuvent s'imposer.

Date et heure de l'émission du message (format : yyyy-MM-dd HH:mm:ss ex : 2038-01-19 04:14:08). Le timetosend ne peut pas être utilisé pour un envoi différé de plus de 24h dans le futur, des délais plus importants doivent être gérés dans votre application. Même programmé en avance, il est impossible d'annuler un message. Le fuseau horaire est celui de la France. Si entre-temps un destinataire fait part de sa volonté de ne plus recevoir de SMS (STOP), vous ne pourrez pas agir sur un envoi préprogrammé.

Les SMS programmés dans le passé partent immédiatement.

Personnalisation de l'émetteur : 11 caractères alphanumériques, par exemple "Magasin" (la valeur par défaut diffère selon les pays et opérateurs). Certains opérateurs refuseront la personnalisation de l'émetteur (par exemple en France NRJ Mobile ou Transatel).

Dans certains pays, l'émetteur devra être autorisé par les opérateurs. Contactez-nous pour plus de précisions.

Votre username, transmis à l'inscription

Votre password, transmis à l'inscription

Numéro du destinataire avec indicatif (+33...) ou au format international (0033...). Vous pouvez ajouter jusqu'à 500 msisdn séparés d'une virgule : +336xxxx1,+336xxxx2,+336xxxx3

Contenu du message.

Limité à 160 caractères de l'alphabet GSM si les paramètres allowunicode et dcs ne sont pas utilisés. Nous autorisons avec l'option "messages longs" un envoi de 7 SMS de 153 caractères (la concaténation des SMS utilise 7 caractères par message). Si vos besoins impliquent une taille de message supérieure à 7 x 153 caractères, merci de contacter le support pour demander une analyse du besoin et un paramétrage spécifique. Des limitations imposées par l'opérateur peuvent s'imposer.

Permet l'utilisation de l'Unicode.

Sans ce paramètre, votre message sera converti pour être envoyé en utilisant l'alphabet GSM

Permet de gérer plusieurs offres différentes sur un compte unique (par exemple : une offre pour des messages Alerting et une offre pour des messages Marketing en France).

Personnalisation de l'émetteur : 11 caractères alphanumériques, par exemple "Magasin" (la valeur par défaut diffère selon les pays et opérateurs). Certains opérateurs refuseront la personnalisation de l'émetteur (par exemple en France NRJ Mobile ou Transatel)

Date et heure de l'émission du message (format : yyyy-MM-dd HH:mm:ss ex : 2038-01-19 04:14:08). Le timetosend ne peut pas à plus de 24h dans le futur, des délais plus grands doivent être gérés de votre côté. Même programmé en avance, il n'est pas possible d'annuler un message. Le fuseau horaire est celui de la France. Si entre-temps un destinataire fait part de sa volonté de ne plus recevoir de SMS (STOP), vous n'êtes plus en capacité de le gérer sur ces envois préprogrammés.

L'encoding que vous utilisez pour nous envoyer le message (de vos serveurs à nos serveurs). Si ce champ n’est pas renseigné, nous regarderons les headers http, et s’ils ne sont pas renseignés, nous considérerons que le message est encodé en UTF-8.

Champ libre limité à 250 caractères alphanumériques, vous permet de nous donner un identifiant métier que nous vous renverrons dans les accusés de réception et réponses. Pour les envois multiples, vous pouvez envoyer soit un remoteid pour tout le push, soit un remoteid par msisdn.

Avec le msisdn, crée un couple unique qui permettra de garantir que le même message n'est pas envoyé plusieurs fois, même en cas de réitération d'un envoi (par exemple consécutif à une non-réponse). Attention, compte tenu du mécanisme mis en place, un impact négatif sur les performances est possible. Lors de la réception d’un doublon, nous vous renverrons le même ticket correspondant à l’envoi correspondant (et le smscount en réponse sera de 0 étant donné que nous n’enverrons pas de message supplémentaire). Etant donné que l’unicité est garantie par le couple uniqueid-msisdn, vous avez ici aussi le choix pour les envois multiples d’envoyer un seul uniqueid ou un uniqueid par msisdn. Contrairement au remoteid, nous ne vous renverrons pas cet uniqueid lors des notifications. Il est limité à 35 caractères. Nous vérifions l'unicité du code sur le mois courant.

Concernant l’implémentation très particulière de ce champ, contactez nous.

Data Coding Scheme, permet de changer la classe du message. Cette option est destinée à un usage averti et n'est pas applicable dans tous les contextes. Merci de contacter le support si vous avez besoin de l'utiliser.

Protocol Identifier, permet entre autre de remplacer des SMS envoyés précédemment. Cette option est destinée à un usage averti et n'est pas applicable dans tous les contextes. Merci de contacter le support si vous avez besoin de l'utiliser.

User Data Header, permet de créer, par exemple des SMS enrichis. Vous n’avez pas à le gérer pour les SMS longs. Cette option est destinée à un usage averti et n'est pas applicable dans tous les contextes. Merci de contacter le support si vous avez besoin de l'utiliser.

Identifiant unique d'un message, envoyé dans la réponse synchrone sous le nom de ticket

Représente, avec StatusText, l'état du SMS

Représente, avec Status, l'état du SMS.

Les états possibles sont :

0 – waiting      : En attente

1 – in progress  : En cours d'envoi

2 – sent         : Envoyé à l'opérateur

3 – delivered    : Délivré 

4 – refused      : Refusé par l'opérateur  

6 – not delivered : Non délivré

Le numéro du destinataire avec indicatif (+33...)

Soit 00000, soit l'émetteur précisé dans sender

Heure de création (formaté yyyy-MM-dd HH:mm:ss)

Heure de l'acquittement opérateur (formaté yyyy-MM-dd HH:mm:ss)

Heure de réception de l'acquittement mobile (formaté yyyy-MM-dd HH:mm:ss)

Retour spécifique à l'opérateur

Code de résultat de l'envoi du message

Nombre de SMS envoyés

Champ libre limité à 250 caractères alphanumériques, identifiant métier que vous nous fournissez lors de la soumission d'un SMS et qui est retourné dans les accusés de réception pour un suivi interne au client.

Identifiant unique d'un message (identifie le MO)

Status est toujours 5 pour les réponses

StatusText est toujours SMSMO-received pour les réponses

Le numéro de l'expéditeur avec indicatif (+33...)

Le numéro court sur lequel nous avons reçu le message

Heure à laquelle nous avons reçu le message (formaté yyyy-MM-dd HH:mm:ss)

Le ServiceId correspondant à l'échange – par défaut vous n'en aurez qu'un

Le SubServiceId correspondant, par défaut, ce sera 0

Le ticket auquel ce message répond

Le contenu du message reçu

Éventuellement un mot clé, sera Default par défaut. Sera Stop si le MO a été identifié de notre côté comme une demande d'opt-out. Attention, la responsabilité de la qualification du MO comme une demande d'opt-out reste du ressort du client. Le champ Keyword est donné à titre purement indicatif.

Permet de récupérer la valeur du champ remoteid présent lors de l'envoi du MT. Attention à la casse de ce champ qui est différente entre les deux fonctions.

Votre username, transmis à l'inscription.

Votre password, transmis à l'inscription.