Si vous avez souscrit une API SMTP, ce guide vous explique comment formuler le contenu de votre email pour envoyer un sms ou un message sur répondeur.
Afin d’utiliser l’API SMTP, vous devez créer des identifiants spécifiques.
Pour cela :
1. Connectez-vous à votre compte Digitaleo.
2. Rendez-vous dans Gérer mon compte > Mes applications
3. Cliquez sur ✚ Ajouter une application et choisissez « Créer une application SMTP »
4. Saisissez un nom et une description pour retrouver facilement votre API dans la liste de vos applications par la suite.
5. Cliquez sur créer
6. Une fois l’application créée, vos identifiants vous sont communiqués :
- Un Client ID, qui correspond à un nom d’utilisateur
- Un Client Secret, qui correspond à un mot de passe
7. Simulez un modèle d’email en cliquant sur « Générer un email » ou terminez en cliquant sur « J’ai bien noté le Client Secret »
L’API SMTP vous permet d’envoyer des SMS ou des messages sur répondeur à partir d’un email.
Voici les adresses à utiliser :
- Pour envoyer un sms : email@sms.digitaleo.com
- Pour envoyer un message sur répondeur : email@voicemail.digitaleo.com
Il n’est pas utile de préciser l’objet du mail.
En revanche, une nomenclature spécifique est à respecter pour le contenu du message. Nous allons la détailler ci-dessous.
S’il respecte scrupuleusement cette nomenclature, votre email sera converti en SMS ou en message sur répondeur.
L’email que vous envoyez à Digitaleo doit obligatoirement contenir certaines informations afin d’être correctement traité par nos algorithmes.
Informations obligatoires :
- Identifiants du compte : Il s’agit de la combinaison Client ID + Client Secret générée lors de l’ajout de l’application depuis votre compte Digitaleo.
- Message : Il peut s’agir du texte d’un sms ou du lien vers un fichier audio (.wav) hébergé en ligne.
- Numéro(s) de destinataire(s) : Il s’agit d’un ou plusieurs numéros de mobiles valides (pensez à vérifier les destinations autorisées de votre contrat).
Informations Optionnelles :
- Date et heure de programmation : Date et heure auxquelles le premier message sera envoyé.
- Expéditeur personnalisé : Il s’agit du nom (SMS) ou du numéro (Message répondeur) d’expéditeur personnalisé. Celui-ci doit avoir été préalablement configuré sur votre compte par notre service client.
- Champs personnalisés : Il est possible d’utiliser des champs variables par contact afin de personnaliser le message d’un SMS.
Identifiant du compte
Votre identifiant est composé d’un Client Id et d’un Client Secret.
Ils doivent être insérés dans le corps du mail, séparés par un tiret et précédés de U-
U-[Client Id de votre application]-[Client Secret de votre application]
exemple : U-55a55a5555s555fe2545c37z5722e225b8-c8ad8bbbc78bteea518a937c6542c9e7
Message
Votre message peut être le texte d’un sms ou le lien vers un fichier audio (.wav) d’un message sur répondeur.
- Le texte d’un SMS
Il est à insérer dans le corps de l’email et devra être précédé des caractères T- afin d’être identifié par Digitaleo
exemple : T-Ceci est le texte de mon sms
- Le lien d’un fichier audio d’un message sur répondeur
Il est à insérer dans le corps de l’email et devra être précédé des caractères V- afin d’être identifié par Digitaleo.
Le fichier audio doit être un .wav
exemple : V-http://lien-vers-mon-fichier-audio.com/message.wav
- Numéro(s) de destinataire(s)
– Un seul destinataire : Si votre message concerne un seul destinataire, son numéro peut être inséré dans le corps de l’email après le message (texte ou lien du fichier audio). Le numéro devra être précédé des caractères #- afin d’être identifié par Digitaleo.
exemple : #-33612345789
– Plusieurs destinataires : Les numéros des destinataires sont à insérer après le message (texte ou lien du fichier audio). Chaque numéro devra être précédé des caractères #- afin d’être identifié par Digitaleo
exemple :
#-33612345789
#-33798765432
#-33655223322
Votre message sera donc a minima constitué comme suit :
- pour envoyer un sms :
Expéditeur :
Destinataire : email@sms.digitaleo.com
U-[Client Id de votre application]-[Client Secret de votre application]
T-Ceci est le texte de mon SMS
#-33600000001
- pour envoyer un message sur répondeur :
Expéditeur :
Destinataire : email@voicemail.digitaleo.com
U-[Client Id de votre application]-[Client Secret de votre application]
V-http://lien-vers-mon-fichier-audio.com/message.wav
#-33600000001
- Date et heure de programmation
Il est possible de différer l’envoi de votre message à la date et l’heure de votre choix. Pour cela, renseigner la date et l’heure précédées des caractères D- afin qu’elles soient identifiées par Digitaleo
exemple : D-2020-06-02T15:15
Dans cet exemple votre message sera envoyé le 2 juin 2020 à 15h15.
Exemple de message :
Destinataire : email@sms.digitaleo.com
U-[Client Id de votre application]-[Client Secret de votre application]
T-Ceci est le texte de mon SMS
#-33600000001
D-2020-06-02T15:15
- Nom d’expéditeur personnalisé
Si cette option est déjà paramétrée sur votre compte Digitaleo, il est possible de personnaliser le numéro d’expéditeur du SMS (dans la limite de 11 caractères alpha-numériques). Pour cela, renseigner le nom d’expéditeur souhaité précédé des caractères S- afin qu’elles soient identifiées par Digitaleo
– Exemple de paramétrage du nom d’expéditeur pour un sms :
Destinataire : email@sms.digitaleo.com
U-[Client Id de votre application]-[Client Secret de votre application]
T-Ceci est le texte de mon SMS
#-33600000001
S-MaBoutique
– Exemple de paramétrage du N° d’expéditeur pour un message sur répondeur :
Destinataire : email@voicemail.digitaleo.com
U-[Client Id de votre application]-[Client Secret de votre application]
V-http://lien-vers-mon-fichier-audio.com/message.wav
#-33600000001
S-0120304050
- Champs personnalisés
Il est possible de personnaliser le message de votre SMS avec des champs variables.
Le texte du SMS doit contenir les champs à remplacer (%n).
Les valeurs doivent être indiquées dans l’ordre après chaque numéro de contacts #- séparé par des points-virgules
– Exemple de paramétrage de champs personnalisés :
Destinataire : email@sms.digitaleo.com
U-[Client Id de votre application]-[Client Secret de votre application]
T-Bonjour (%1) (%2), votre commande numéro (%3) est expédiée.
#-33600000001;Mme;DUPONT;30022
#-33600000002;M.;MARTIN;30023
#-33600000003;Mme;BOUVIER;30024
Les 3 destinataires recevront respectivement les messages suivants :
– “Bonjour Mme DUPONT, votre commande numéro 30022 est expédiée.”
– “Bonjour M. MARTIN, votre commande numéro 30023 est expédiée.”
– “Bonjour Mme BOUVIER, votre commande numéro 30024 est expédiée.”
Maintenant que vous savez comment rédiger votre email, vous pouvez le tester depuis votre client messagerie habituel.
Si votre message n’arrive pas correctement, nous vous invitons à vérifier chacun des points suivants :
- L’adresse de destinataire est-elle la bonne ? (email@sms.digitaleo.com pour envoyer un sms ou email@voicemail.digitaleo.com pour envoyer un message sur répondeur).
- Le corps du texte respecte-t-il scrupuleusement la nomenclature : pas d’espace en trop après les caractères obligatoires, présence de tous les points-virgules entre les champs variables, uniquement des numéros de portables correctement formatés, pas de mise en forme (gras, italique…) superflues… ?
- Avez-vous copié-collé tout ou partie du corps du mail ? Si tel est le cas, repartez d’un message vierge et assurez-vous de tout coller en texte brut.
- Le numéro ou nom d’expéditeur que vous avez choisi est-il déjà enregistré sur votre compte ? Vous pouvez le vérifier sur votre compte Digitaleo en éditant un sms ou un message sur répondeur.
Lorsque tout fonctionne correctement, il ne vous reste plus qu’à paramétrer votre message type dans le logiciel à partir duquel vous souhaitez automatiser les envois (CRM, DMS, logiciel de vie scolaire, gestion RH…).
Chaque logiciel possède ses propres paramètres auxquels vous devrez vous référer pour appeler le bon champ au bon endroit. Nous vous invitons à vous conformer au guide d’utilisation de votre fournisseur.
Voici quelques exemples d’usages les plus répandus :
- CITROEN VILLEFRANCHE (logiciel DMS : Autoline)
“Bonjour, CITROEN VILLEFRANCHE vous informe que votre véhicule est à votre disposition. Vous pouvez le récupérer dès maintenant ou avant 18h.” - CHERBOURG GARAGES MALIN (logiciel DMS : ERICAUTO)
“Confirmation du RDV Atelier du 22/11/2019 à 9H00. Vous serez reçu par Mr Legrand” - COLLEGE de Saint-Exupéry (logiciel de gestion des absences et des retards)
“Bonjour Mr Leman, nous vous informons que Nicolas ne s’est pas présenté en cours d’EPS cet après-midi à 15h.” - LACHAT IMMOBILIER (CRM Salesforce)
“Suite à votre demande, nous avons mandaté SIPHON PLOMBERIE. Vous serez contacté prochainement pour une prise de RDV.” - INTERIM LEMPLOI (logiciel de gestion du personnel intérimaire)
« Bonjour Mme Dupont, nous vous confirmons votre entretien chez La Firme le mercredi 21 janvier à 09h00. Veillez à vous munir de votre CV à jour. »
Pour vous aider à formater correctement votre email à partir des consignes de ce guide, un générateur de modèles est à votre disposition.
Sur la ligne de votre application, cliquez sur le bouton « Editer » et sélectionnez le choix « Générateur »
La page suivante vous permet de simuler le rendu de votre message :
En fonction des données que vous remplissez, votre message se met à jour.
Vous pouvez également simuler le rendu des options facultatives en utilisant le menu « paramètres avancés ».