INTERFACE WEB API ENVOI DE SMS EN MASSE NOTICE D UTILISATION MAJ : 22/06/2007

Transcription

1 INTERFACE WEB API ENVOI DE SMS EN MASSE NOTICE D UTILISATION MAJ : 22/06/2007 Ce document est destiné aux professionnels, qui ont choisi d utiliser notre API, via l interface WEB mise à leur disposition, pour l envoi de messages SMS en masse, immédiats ou différés, classiques ou personnalisés. I INSCRIPTION Rendez-vous en page d accueil, à l adresse et cliquez sur la rubrique «Créer un compte» ; vous allez procéder à la saisie de votre fiche. a) Saisie de vos données professionnelles et personnelles Description des champs composant le formulaire ; Raison Sociale : Adresse : Code Postal : Ville : Numéro TVA : Numéro SIREN : Nom : Prénom : Téléphone : Nom de votre société, composé de lettres et chiffres (les espaces, apostrophes et tirets sont autorisés). Adresse postale de votre société, composée de lettres et chiffres (les espaces, apostrophes, virgules et tirets sont autorisés). Code postal, composé de 5 chiffres. Nom de la ville, composé de lettres (les espaces, apostrophes et tirets sont autorisés). Numéro de TVA intracommunautaire, composé des lettres «FR» (en majuscules), suivi de 11 chiffres. Numéro SIREN (ou RCS) constitué automatiquement lors de la saisie du numéro de TVA intracommunautaire. Votre nom de famille, composé de lettres (les espaces, apostrophes et tirets sont autorisés). Votre prénom, composé de lettres (les tirets sont autorisés). Numéro de téléphone fixe, composé de 10 chiffres (commençant par 01, 02, 03, 04, ou 05). TELEMAQUE - 80, Route des Lucioles SOPHIA ANTIPOLIS 1/8

2 Mobile : Numéro de téléphone mobile (facultatif), composé de 10 chiffres (commençant par 06). Login : Pass : Adresse , composée de lettres sans accent et chiffres (les espaces, points, underscores et tirets sont autorisés). Login de votre choix, composé de lettres sans accent et chiffres (4 caractères au minimum). Mot de passe de votre choix, composé de lettres sans accent et chiffres (6 caractères au minimum). Après avoir complété le formulaire, cliquez sur le bouton «Valider». Pour chaque donnée invalide que vous aurez saisie, un message d erreur sera affiché ; vous aurez l obligation d effectuer les corrections nécessaires. Dès la validation de votre formulaire, en moins de 72 heures, votre fiche sera vérifiée par un administrateur, votre compte sera créé, puis activé ; vous recevrez un mail de confirmation, contenant les identifiants que vous avez choisis (votre login et votre mot de passe). b) Formulaire pré-rempli Si vous êtes un partenaire TELEMAQUE, vous pouvez bénéficier de l inscription par formulaire pré-rempli : rendez-vous dans votre interface à l adresse une fois connecté, cliquez sur l onglet «API», puis allez dans la rubrique «Inscription». Vous accédez au formulaire décrit ci-dessus, avec les champs suivants pré-remplis ; - Raison Sociale - Téléphone - - Login - Pass II ACCES A L INTERFACE Rendez-vous de nouveau en page d accueil, à l adresse et saisissez vos identifiants dans la section «Identification», ensuite, cliquez sur le bouton «Valider». Une fois identifié, le nom de votre société apparaît en haut à gauche de l interface, et de nouvelles rubriques ont fait leur apparition ; Historique : Campagne SMS : Récapitulatif général pour toutes les campagnes SMS éditées, avec la possibilité d effacer celles qui sont programmées ou annulées (il est également possible d obtenir un récapitulatif détaillé sur chaque campagne). Edition de campagnes SMS en 4 étapes ; chargement du fichier de contacts, paramétrage, envoi d un message de test (facultatif), et confirmation d enregistrement. TELEMAQUE - 80, Route des Lucioles SOPHIA ANTIPOLIS 2/8

3 Rechargement : Facturation : Renseignements : Achat de SMS en 3 étapes ; sélection de la quantité en fonction du besoin, demande de confirmation, paiement en ligne (exclusivement par carte bancaire). Récapitulatif des factures générées après chaque achat. Affichage de vos informations personnelles et professionnelles. Déconnection : Permet la fermeture de votre session en toute sécurité. a) Historique Le récapitulatif général des campagnes SMS éditées, est présenté sous la forme d un tableau. Pour chaque campagne, on observe ; - Numéro d identification unique - Nom - Type (toujours «SMS») - Nombre d envois prévus - Nombre d envois effectifs (SMS débités sur votre compte) - Statut («Programmée», «Envoyée», «Annulée») - Date prévue pour l envoi - Date de création Chaque campagne qui n a pas encore été «Envoyée» est ; «Programmée» ou «Annulée». Pour ces deux derniers cas, il est possible de procéder à une suppression, en cliquant sur le logo [ ] (par sécurité, vous aurez l obligation de répondre à un message de confirmation). Enfin, pour obtenir un récapitulatif plus détaillé pour chaque campagne, il suffit de cliquer sur le logo [ ]. Une fiche est affichée, reprenant les données énoncées ci-dessus, avec des informations supplémentaires ; - Sujet (toujours vide) - Contenu du message b) Campagne SMS L édition d une campagne SMS est organisée en 4 étapes. 1) Chargement du fichier de contacts a) Description Description des champs composant la première page du formulaire ; TELEMAQUE - 80, Route des Lucioles SOPHIA ANTIPOLIS 3/8

4 Nom de campagne : Fichier CSV : Nom de votre choix permettant d identifier facilement la campagne que vous allez éditer (par exemple : «Relance Clients JUIN 2007»), composé de lettres et chiffres (les espaces sont autorisés). Sélection d un fichier au format CSV, contenant les numéros de vos contacts, et éventuellement pour chacun, des caractéristiques rattachées (par exemple : un prénom). b) Création d un fichier au format CSV Il est fréquent de disposer d une liste de numéros, dans un fichier au format texte (.TXT). Pour créer un fichier au format CSV (.CSV), à partir de votre fichier texte, vous pouvez utiliser le logiciel gratuit «OPEN OFFICE CALC» qui est l équivalent du logiciel «MICROSOFT EXCEL» (vous pouvez télécharger la suite de logiciels «OPEN OFFICE», à l adresse suivante : Une fois le logiciel «OPEN OFFICE CALC» installé, lancez-le, et faites un «glisser-déposer» de votre fichier texte, directement sur la feuille de calcul. Une boite de dialogue apparaît ; Décochez la case «Tabulation», et cochez la case «Point-virgule», ensuite, dans «Séparateur de texe», passez le guillemet double en surbrillance, et supprimez-le (touche «SUPPR» de votre clavier). Enfin, cliquez sur le bouton «OK» pour valider. TELEMAQUE - 80, Route des Lucioles SOPHIA ANTIPOLIS 4/8

5 Votre fichier texte a été converti en fichier CSV, mais il vous faut maintenant l enregistrer sur votre ordinateur ; cliquez sur «Fichier» (en haut à gauche, au dessus de la feuille de calcul), puis «Enregistrer sous». c) Structure du fichier CSV pour un envoi de messages identiques Pour prévoir l envoi de messages identiques, quelque soit le destinataire, votre fichier CSV doit être composé d une seule colonne, contenant les numéros de vos contacts ; d) Structure du fichier CSV pour un envoi de messages personnalisés Pour prévoir l envoi de messages personnalisés en fonction du destinataire, votre fichier CSV doit être composé, comme ci-dessus, d une première colonne contenant les numéros, et peut compter jusqu à 8 colonnes de caractéristiques. Toutes les colonnes doivent être nommées ; TELEMAQUE - 80, Route des Lucioles SOPHIA ANTIPOLIS 5/8

6 Pour l envoi de messages personnalisés, on va utiliser ce qu on appelle un «template» (insertion de variables dans le message). Nous allons nous baser sur l exemple suivant ; Bonjour {PRENOM}, fait-il beau à {VILLE} aujourd hui? Le premier de vos contacts recevra le message suivant ; Bonjour Albert, fait-il beau à Marseille aujourd hui? Le deuxième de vos contacts recevra ; Bonjour Maurice, fait-il beau à Paris aujourd hui? Vos messages ont beaucoup plus d impact, car chaque destinataire à l impression de recevoir un message, qui aurait été écrit exclusivement pour lui. 2) Paramétrage Description des champs composant la deuxième page du formulaire ; Destinataires : Envoi : Libellé : Message : Variables : Affichage du nombre d enregistrements retenus, après vérification et dédoublonnage des numéros de vos contacts (après chaque chargement de fichier, vous recevrez un «Rapport de traitement de fichier» par mail, contenant la liste des numéros inexploitables). Type d envoi, immédiat ou différé. Pour ce dernier, il est possible de paramétrer un jour et une heure d envoi. Pour des raisons légales, il est obligatoire d identifier l émetteur de chaque message, envoyé par l intermédiaire de notre API (par exemple, si le nom de votre société est «TEST», tous les messages que vous enverrez commenceront par «TEST:»). Permet la saisie du message à envoyer, composé de lettres et chiffres (les espaces, apostrophes, virgules, points, underscores et tirets sont autorisés). Lors de la composition du message, le nombre de caractères restants est affiché en temps réel. Affichage des variables utilisables dans votre message (l affichage des variables à lieu, uniquement si vous avez défini des caractéristiques dans votre fichier CSV). 3) Envoi d un message de test Description des champs composant la troisième page du formulaire ; Numéro de mobile : Affichage de votre numéro de téléphone mobile, composé de 10 chiffres (commençant par 06). Si lors de la création de votre compte, vous n avez pas fourni de numéro de téléphone mobile, ce champ sera à remplir si vous désirez effectuer un test ; dans le cas contraire, vous aurez seulement à cocher la case «Ne pas envoyer le message de test». TELEMAQUE - 80, Route des Lucioles SOPHIA ANTIPOLIS 6/8

7 4) Confirmation d enregistrement Sur la quatrième et dernière page du formulaire, si toutes les étapes précédentes se sont déroulées correctement, vous obtenez le message de confirmation suivant : «Votre campagne a été enregistrée avec succès». Après chaque envoi, immédiat ou différé, vous recevrez un «Rapport d envoi», contenant la liste des numéros, sur lesquels aucun message n a pu être envoyé. c) Rechargement Le rechargement en crédit SMS est organisé en 3 étapes. 1) Sélection de la quantité Description des champs composant la première page du formulaire ; Type rechargement : Choix de la quantité de SMS à acheter en fonction de votre besoin. 2) Demande de confirmation Description des champs composant la deuxième page du formulaire ; Type rechargement : Affichage de la quantité de SMS sélectionnée. Prix HT : TVA : Prix TTC : Affichage du prix hors taxe correspondant à la quantité de SMS sélectionnée. Affichage du taux de TVA en vigueur. Affichage du prix toutes taxes comprises. 3) Paiement en ligne a) Description Description des champs composant la troisième et dernière page du formulaire ; Numéro commande : Affichage du numéro de la commande. Montant à payer : Affichage du prix toutes taxes comprises à payer. b) Paiement en ligne par carte bancaire Après avoir cliqué sur le bouton «Payer», vous entrez sur notre serveur sécurisé, sur lequel vous allez pouvoir effectuer votre paiement. Sur la page affichée, vous retrouvez les informations suivantes ; - Montant de la transaction (prix toutes taxes comprises à payer) - Référence de la transaction (numéro de la commande) - Description de la commande (toujours «RECHARGEMENT») TELEMAQUE - 80, Route des Lucioles SOPHIA ANTIPOLIS 7/8

8 Il ne vous reste plus qu à saisir vos coordonnées bancaires et à valider votre commande. Si nécessaire, vous pouvez stopper la transaction, en cliquant sur le lien «Annuler votre commande» ; vous serez redirigé vers la page «Accueil» de l interface WEB. Si la transaction s est déroulée avec succès, vous êtes redirigé vers la page «Renseignements» (que nous décrirons plus loin dans ce document) de l interface WEB. Vous remarquerez que la quantité de SMS achetée, a été ajoutée à votre crédit. d) Facturation Le récapitulatif des factures générées après chaque achat, est présenté sous la forme d un tableau. Pour chaque facture, on observe ; - Numéro - Date de création Pour visualiser chaque facture, il suffit de cliquer sur le logo [ ]. Une nouvelle fenêtre s ouvre, et la facture au format PDF s affiche automatiquement. Pour afficher les fichiers au format PDF (.PDF), vous devez utiliser le logiciel gratuit «ADOBE READER» (vous pouvez télécharger le logiciel «ADOBE READER» à l adresse : e) Renseignements La fiche de renseignements contient les informations personnelles et professionnelles, que vous avez fournies lors de la création de votre compte. Conformément à la loi n du 6 Janvier 1978, relative à l'informatique, vous pouvez faire modifier ces informations, en envoyant un mail à l adresse ; support-api@telemaque.fr. Sur cette fiche, vous trouverez également des informations sur votre crédit SMS ; - Crédit SMS - Nombre de SMS à envoyer (nombre de SMS bloqués par des campagnes programmées) - Nombre de SMS à utiliser f) Déconnection Une fois votre travail terminé sur l interface WEB, avant de fermer votre navigateur, pour plus de sécurité, nous vous conseillons de procéder à la fermeture de votre session. TELEMAQUE - 80, Route des Lucioles SOPHIA ANTIPOLIS 8/8