Régénérer ma clé Documentation Fastermessage

Présentation Mise à jour: Janvier 2023

Fastermessage est une solution simple, rapide et légère qui vous permet d'envoyer des messages en temps réel et en différé, partout dans le monde à travers plusieurs canaux : SMS, WhatsApp, Mail. Fastermessage propose également une API RESTFul que vous pouvez utiliser dans votre application (Web, mobile, etc...). Après chaque envoi de message, vous pouvez accéder à l'historique de vos messages et à vos données de facturation soit directement sur la plateforme, soit via l'API.

Inscription

Créer son compte

Pour vous inscrire et utiliser les services de Fastermessage, vous devez disposer d’un compte. Pour créer un compte, rendez-vous ICI , puis saisissez votre adresse email, votre numéro de téléphone et un mot de passe suivi de sa confirmation. Si la devise sélectionnée ne correspond pas à votre pays, veuillez la changer et modifier également le pays. Ensuite, vous devez lire et accepter les conditions d’utilisation. Validez pour lancer votre inscription.

Valider son compte

Après ça, vous recevrez instantanément un lien de confirmation à votre adresse email ou votre numéro de téléphone. Cliquez ensuite sur le lien envoyé pour activer définitivement votre compte.

Inscription terminée

Passé ces deux étapes, votre compte Fastermessage est créé avec succès. Vous pouvez maintenant utiliser les services Fastermessage (envoi de message, campagne SMS, etc.). Passons à l’étape suivante pour découvrir le tableau de bord de Fastermessage. Mais avant veuillez-vous connecter sur la page de connexion sur le lien suivant Connexion, en remplissant les champs demandés à savoir votre Email et Mot de passe.

Tableau de bord

Une fois votre inscription terminée et votre compte confirmé, vous serez redirigé sur votre tableau de bord. Bienvenue sur votre tableau de bord subdivisé en plusieurs sections.

Section 2 : Menu secondaire

Cette deuxième section vous présente le nombre de crédit SMS restant, de changer l'interface de présentation et un bouton "paramètre de compte".

Section 3 : Présentation rapide

Cette section fait une présentation rapide de certaines rubriques comme CAMPAGNES, STATISTIQUES, DEVELOPPEURS, RECHARGE DE COMPTE ...

Paramètre du compte

Sur votre tableau de bord, dans le coin supérieur droit de l’écran, vous y trouverez une image de profil par défaut. Sur clic, un menu contextuel s’affiche. Veuillez trouver ci-dessous une illustration :

Mon profil

Cette rubrique vous permet de modifier les informations relatives à votre compte. Les informations renseignées lors de la création de votre compte sont définies dans les champs par défaut. Un panel se présente avec de différents boutons <<Détails profil>> <<Entreprise>> <<Notification de solde>> <<Méthode de connexion>>, en cliquant sur chaque bouton, un message descriptif de l’action a effectuer vous est détaillé. Si vous souhaitez apporter des modifications, vous n’aurez qu’à modifier les différents champs et soumettre.

Revendeur

Fastermessage permet également à ses utilisateurs comme vous de devenir revendeur de la solution. Si vous remplissez les conditions nécessaires, vous pouvez revendre la solution sous votre propre marque et réaliser de plus-value. Les informations demandées pour devenir revendeur sont décrites dans la rubrique. Ci-dessous une capture d’écran de cette page.

Affiliés

Fastermessage permet également à ses utilisateurs comme vous de devenir revendeur de la solution. Si vous remplissez les conditions nécessaires, vous pouvez revendre la solution sous votre propre marque et réaliser de plus-value. Les informations demandées pour devenir revendeur sont décrites dans la rubrique. Ci-dessous une capture d’écran de cette page.

Tarifs SMS

Cette rubrique vous présente chaque prix de SMS par pays. Oui, FATERMESSAGE est désormais international. Vous pouvez effectuer vos envois vers l’international. Nous vous donnons la possibilité d’atteindre plus de cible.

Langue

Nous sommes multi-langues. Vous avez la possibilité de changer la langue de votre interface de présentation en cliquant sur le bouton.

Déconnexion

Vous avez terminé, vos envois ? Déconnectez-vous de votre compte en cliquant sur ce bouton.

Constituer son carnet d’adresses

Ici, vous aurez à inscrire les informations nécessaires pour contacter vos clients, vos prestataires, vos fournisseurs etc. Cliquez sur « Contacts » dans le menu latéral à votre gauche pour accéder à la page de vos contacts. Vous pouvez organiser vos contacts en créant des groupeS. Ci-dessous la page de présentation de la rubrique CONTACTS.

Vous êtes prêt pour ajouter votre premier contact ? CréeZ d’abord un groupe de contact. Il est important d’organiser votre base clientèle comme vous le savez certainement.

Groupe de contact

Fastermessage vous permet de créer et de ranger vos contacts par groupe. Cela vous facilitera la tâche lorsque vous allez, par exemple, décider de lancer une campagne SMS à l’endroit de tous vos fournisseurs.

Comment créer un groupe de contact ?
  1. Cliquez sur le bouton . Au chargement, vous verrez le nombre de groupe de contact que vous avez déjà créé et un bouton pour ajouter un nouveau groupe de contact.
  2. Cliquez ensuite sur le bouton . Une fenêtre se superposera sur la page présentant un formulaire d’ajout.
  3. Veuillez définir votre nom de groupe de contact puis cliquez sur le bouton pour enregistrer votre groupe de contact.

Info

Vous avez commis une erreur lors de l’ajout ou désirez-vous modifier un groupe de contact ? C’est facile cliquez sur l’une des icones dans la colonne Action sur le tableau disponible sur la page. Vous pouvez aussi écrire le nom de votre groupe de contact, dans le champ de recherche du tableau pour identifier un groupe de contact.


Comment ajouter un, ou plusieurs contacts dans un groupe de contact ?

Selon votre besoin plusieurs possibilité s’offrent à vous :

  1. Cliquez sur le bouton .
  2. Cliquez ensuite sur le bouton . Une fenêtre se superposera sur la page présentant un formulaire d’ajout d’un nouveau contact.
  3. Sélectionnez le groupe de contact dans lequel vous voulez inscrire le contact. Si vous n’avez pas encore un groupe de contact, cliquez-ici pour connaitre comment créer un groupe de contact.
  4. Remplissez-le ou les champ(s) en vous assurant d’y inscrire des informations correctes.

La méthode la plus utilisée et recommandée par nos clients. Elle vous permet en un clic d’importer votre base clientèle déjà créée. Plusieurs formats sont supportés : xlsx ; xls ;csv.

  1. Si vous n’avez pas encore cliqué sur le bouton nous vous invitons à le faire. Une fenêtre se superposera sur la page, vous demandant des informations.
  2. Sélectionnez un groupe de contact dans lequel vous importerez votre base clientèle. Si vous n’avez pas encore un groupe de contact, c’est par ici le tuto d’ajout d’un nouveau groupe de contact.
  3. Sélectionnez votre fichier de contact puis cliquez ensuite sur le bouton .

Info

Après votre importation, les contacts ajoutés s’afficheront dans le tableau en bas. Toutefois si vous désirez modifier un contact C’est facile cliquez sur l’une des icones dans la colonne Action sur le tableau disponible sur la page. Vous pouvez aussi écrire le nom de votre groupe de contact, dans le champ de recherche du tableau pour identifier un groupe de contact afin d’effectuer une action dessus.


Comment exporter votre base de clientèle ?
  1. Rendez-vous dans la rubrique CONTACTS;
  2. Sélectionnez votre groupe de contact que vous désirez exporter;
  3. Choisissez le format de fichier dans lequel vous désirez obtenir votre base clientèle.

Info

L’exportation démarrera automatiquement. Le fichier sera téléchargé sur votre PC ou mobile.

Expéditeur

Vous êtes prêt(e) pour effectuer votre première campagne ? Félicitation ! Mais d’abord commençons par ici. Vous devez disposer d’un expéditeur. Qu’est-ce l’expéditeur ou l’identifiant ? L’expéditeur ou l’identifiant est le nom de l’expéditeur du message qui sera délivré aux clients. Minimum de 3 et maximum de 11 caractères, il peut être le nom de votre entreprise, un service, un produit ou ...

Dans cette rubrique, vous avez une statistique générale sur tous les expéditeurs que vous disposez déjà ainsi que leur liste.

Comment créer un expéditeur ?

Pour créer un nouvel expéditeur ou identifiant, veuillez suivre la procédure ci-contre :

  1. Identifiez et cliquez sur le bouton <<Nouvel>>. Une fenêtre se superposera sur la page.
  2. Définissez votre expéditeur puis cliquez sur le bouton <<Enregistrer>> pour sauvegarder votre expéditeur.

Info

La validation des expéditeurs se fait en coopération avec les opérateurs GSM. Après la création de votre expéditeur, nous disposons de 72 h maximale pour le valider.

Campagne

Cette rubrique est celle la plus utilisée sur l’application que vous effectuez des envois par l’interface ou par API. A l’accueil de cette rubrique, vous avez 3 sections qui vous est présentée.

Section 1: Statistiques des campagnes

Elle est la première partie que vous apercevez lorsque vous vous rendez dans cette rubrique. Elle présente une statistique générale de votre compte. Vous y trouverez le nombre de campagne effectuées selon les différents statuts : programmés, En cours, suspendues et terminés. Retrouvez ci-contre une capture illustrative de cette section de la rubrique Campagne

Section 2: Historique des campagnes

Nous gardons l’historique de toutes vos campagnes effectuées sur une période de trois (03) mois. Vous verrez dans le tableau présenté, le nom de la campagne, l’expéditeur, la date d’envoi, le nombre de page de SMS, le statut, la date de création de la campagne et différentes icones pour effectuer d’autres action comme <<Voir les détails>> ou <<Supprimer la campagne>>.


Comment envoyer un message ou créer une campagne ?

Vous êtes prêt(e) pour votre premier message ou votre première campagne ? Super, Mais d’abord découvrons ensemble le dictionnaire des mots utilisés dans cette rubrique.

Nom de campagne : c’est le nom que vous décidez d’attribuer à votre campagne. Il vous permet d’avoir une organisation entre les différentes campagnes que vous effectuez sur l’application.
Expéditeur : Représente l’expéditeur du message préalablement créé.

Type de SMS :
SMS Classique : représente les messages simples que nous recevons sur nos téléphones.
SMS FLASH : ce type de message contraint le destinataire ou receveur à lire le message sans quoi il ne peut manipuler son téléphone.

Fuseau Horaire
Date et heure d’envoi : représente la date et l’heure auxquelles les SMS seront envoyés à votre client ou base clientèle.

Téléphone : c’est le numéro mobile sur lequel le client recevra son SMS.

Message : représente le contenu du SMS que le client recevra.

Aperçu du message à envoyer : c’est le format de présentation du message qui sera envoyé aux clients.

Destinataire : représente l’ensemble des contacts auxquels les SMS seront envoyés.

Modèle de message existant : les modèles de message représentent des exemples de message que vous pouvez utiliser pour effectuer une nouvelle campagne.
Paramètres : ils représentent des variables dans une base clientèle.

Exemple d'un SMS paramétré

Message :
Bonjour {param1}, votre code client est {param2}.

Le numéro de téléphone se trouvant dans la première colonne, les données dans la colonne 2 représentent le paramètre 1 (param1). Dans la troisième colonne, représentent le paramètre 2 (param2).

Message de sortie
Message reçu par le premier numéro: Bonjour Toto, votre code client est 2045.

Message reçu par le deuxième numéro: Bonjour Tata, votre code client est 5642.
Vous avez un fichier de contact contenant deux lignes et trois colonnes comme schématisé sur l’image ci-dessous :

Sur la page de création de campagne, plusieurs options vous sont présentées.

Identifiez et cliquez sur le bouton <<Envoyer un message>>. Une fenêtre se superposera sur la page présentant un formulaire que vous devez remplir afin d’envoyer votre premier message. Si vous avez de difficulté avec la signification d’un champ demandé, veuillez-vous référer au dictionnaire des mots ici. Info : Cette option vous permet d’envoyer un seul message. On peut dire que cela représente une option pour tester des envois de message sur l’application.

Ci-dessous une illustration de la fenêtre.

  1. Définissez un nom pour votre campagne ;
  2. Sélectionnez un expéditeur ;
  3. Sélectionnez la date d’envoi. Si vous désirez envoyer les messages instantanément, veuillez ne pas sélectionner une date ;
  4. Définissez votre fuseau horaire ;
  5. Sélectionnez un type de SMS ;
  6. Choisissez ou définissez vos dentinaires.

Note

Pour le choix de vos destinataires, plusieurs possibilités s’offrent à vous :

Vous avez la possibilité de sélectionner directement un groupe de contact en cliquant sur le bouton <<Groupe de contact>>. En effectuant ce choix cela signifie que vous avez préalablement déjà enregistré un groupe de contact sur la plateforme que vous pouvez sélectionner.
Vous avez un fichier Excel déjà fait ou vous n’avez pas de groupe de contact déjà sur la plateforme, pas d’inquiétude. Vous pouvez importer directement votre base clientèle en cliquant sur le bouton <<Importation>>, vous serez invité à sélectionner un fichier. Sélectionnez pour continuer.
Cette option vous permet de lister un certain nombre de numéro vers lesquels effectuer des envois. Nous vous invitons à mettre un point virgule après chaque numéro de téléphone.
A présent, vous pouvez lancer votre première campagne en cliquant sur le bouton enregistrer.
Toutefois si vous ne désirez pas encore effectuer la campagne la possibilité de la sauvegarder en brouillon s’offre à vous. Ceci vous permet d’avoir la campagne sans avoir à le publier pour le moment.

Message API

Cette rubrique vous permet de consulter l’historique de tous les messages que vous soumettez par API avec les différents statuts. Vous pouvez sélectionner une plage de date pour obtenir des historiques. Si vous êtes intéressé(e) par l’intégration de l’API, veuillez-vous référer à cette rubrique Développeur.

Messages tests

Si c’est la première fois que vous utilisez la solution, vous pouvez explorer cette rubrique pour envoyer vos premiers messages.

Statistiques

Sur cette page, vous avez le récapitulatif de tous les SMS envoyés que ça soit par campagne ou des envois par API.

Intégrations API

Nous vous permettons d’intégrer FASTERMESSAGE par API. Les lignes dessous décrivent de façon détaillée toutes les informations sur l’API.

A quoi vous sert une clé API ?

Votre clé API permet d'identifier votre compte sur Fastermessage pour établir l'interconnexion entre votre application et Fastermessage.

Régénérer ma clé

En effectuant un clic sur ce bouton, vous pouvez regénérer votre clé API. Après la régénération de votre clé API, assurez-vous d’apporter les modifications à votre code si vous avez déjà intégrer l’API.

Comment intégrer ?

L’API FASTERMESSAGE est une API RESTFUL qui vous permet d’envoyer des SMS à partir de votre application (Web, mobile, etc.). Après chaque envoi, vous avez la possibilité d’accéder à l’historique d’envoi et à vos données de facturation soit directement sur FASTERMESSAGE ou via l’API.

Pour envoyer un SMS par l’intermédiaire de l’API, il vous faut lancer une requête HTTP vers l’adresse « faster.zekin.app/api/v1/sms/send » , en spécifiant certains paramètres (texte à envoyer, numéro de téléphone, destinataire, expéditeur, etc.). L’API retournera une réponse sur l’état de la requête soumise : une confirmation de réponse si tout s’est bien passé ou une erreur si elle n’a pas les options de configuration disponibles.

Les paramètres prisent en compte pour l’envoi de SMS via l’API

x-api-key : ce paramètre est la clé d’authentification de l’API associée à votre compte. Il vous permet de vous identifier à travers la requête HTTP;

text : c’est le message à envoyer. Une page SMS est de 160 caractères. Le nombre maximum de page SMS que vous pouvez envoyer en une fois est 3 donc 480 caractères;

from : c’est l’expéditeur du message. C’est un paramètre de type alphanumérique qui peut être un nom, un numéro de téléphone, etc. Les caractères spéciaux sont interdits. Il est d’au plus 11 caractères;

to : c’est le destinataire du message. Il s’agit du numéro de téléphone de celui qui reçoit le SMS précédé de l’indicatif de son pays. Exemple : 22990909090;

dateTime : ce paramètre est spécifié pour un envoi différé. Il représente la date à laquelle le destinataire recevra le message;

messageId : c’est l'identifiant unique de chaque message envoyé;

dlr_url : c’est l’adresse HTTP à laquelle l’accusé de réception du message vous sera envoyé automatiquement. Voir la rubrique accusée de réception pour plus de détail.

Important

Les variables en badge rouge sont obligatoires. Les autres sont optionnelles.

Après l’envoi d’un SMS via l’API FASTERMESSAGE, vous obtiendrez en retour une réponse du serveur au format JSON comme ci-après.
{
"status" : true,
"from" : "senderDefault",
"to" : "+2292731",
"text" : "Hello-World!",
"messageStatus": {
"name": "sent",
"code": 13
},
"description" : "0: Accepted for delivery",
"smsCount" : 1,
"devise" : "XOF",
"unitPrice" : "12",
"messagePrice" : 12,
"messageId" : "1550226919288536"
"createdAt": "2023-01-23 09:16:28+00:00",
"sentAt": "2022-12-22 10:35:10+01:00",
"country": "Benin",
"operator": "MTN",
"mcc": "616",
"mnc": "03",
"iso": "BJ",
"cc": "229"
}


Passons en revue les informations renvoyées par le serveur à la suite de la requête d’envoi :


status : c’est l’état de soumission de la requête. Il est TRUE si tout s’est bien passé ou FALSE s’il y a un problème ;

text : c’est le contenu du SMS envoyé ;

from : c’est l’expéditeur du SMS envoyé ;

to : c’est le destinataire du SMS envoyé ;

code : c’est le code du statut du SMS. Il peut prendre les valeurs 9(rejeté) , 2 (en attente) , 0 (programmé) , 13 (envoyé) , 8 (délivré) ;

description : c’est le message descriptif du code statut du SMS;

smsCount : c’est le nombre de page du SMS envoyé ;

messageId : c’est l’identifiant du message envoyé.

createdAt : c’est la date de création du SMS FASTERMESSAGE ;

sentAt : c’est la date d'envoi du SMS ;

country : c’est le pays auquel appartient le numéro de téléphone ;

operator : c’est l'opérateur gsm auquel appartient le numéro de téléphone ;

mnc : c’est le code du réseau mobile ;

mcc : c’est le code mobile composé de trois chiffres utilisé pour identifier les réseaux GSM. ;

iso : C'est un code internationalement reconnus de lettres et/ou de chiffres utilisés pour désigner le pays auquel appartient le numéro de téléphone ;

mc : c’est le préfixe du numéro de téléphone du destinataire ;

Après chaque SMS envoyé, FASTERMESSAGE élabore un rapport détaillé sur l’accusé de réception de l’envoi. Vous pouvez consulter le rapport d’envoi sur la plateforme ou le récupérer automatiquement dans votre application en spécifiant l’argument << dlr_url >> lors de la soumission de la requête d’envoi d’un SMS. Le rapport est soumis à votre application par la méthode POST.
Les variables présents dans le rapport d’accusé de réception d’un SMS sont les suivants :
{
"messageId": "1234567890",
"from": "senderDefault",
"to": "+2292731",
"text": "Ceci est le message envoyé",
"smsCount": "1",
"devise": "XOF",
"unitPrice": "12",
"messagePrice": 12,
"messageStatusCode": "3",
"messageStatus": "Delivered",
"description": "Message delivered to handset",
"timeZone": "UTC+1",
"creationDate": "2019-03-12 15:43:14",
"sendingDate": "2019-03-12 15:40:45",
"deliveryDate": "2019-03-12 15:43:15"
}


Important

Si vous décidez de récupérer ce même rapport d’accusé de réception en différé, c’est-à-dire bien après l’envoi d’un SMS, vous envoyez votre requête vers le lien suivant par la méthode GET ou POST : « https://fastermessage.com/api/v1/sms/dlr?messageId=1234567890 » avec messageId, l’identifiant unique du SMS...

Recharge

Comment recharger mon compte ?
Pour recharger votre compte, veuillez suivre les étapes suivantes :
  1. Cliquez sur le menu <<Recharge>>
  2. Identifiez le bouton <<Mon compte>> puis cliquez dessus ;
  3. Renseignez les informations demandées et cliquez sur le bouton <<Continuer>> pour achever votre rechargement.