YellowBox SMSing

YellowBox Store #

Objet #

Le plugin YellowBox SMSing permet l’envoi en masse de messages texte (SMS). Il peut être mis en œuvre dans le cadre des opérations commerciales et campagnes associées.
En règle générale le bon fonctionnement d’une campagne marketing nécessite l’utilisation des tables suivantes :

• Campagne : regroupe l’ensemble des destinataires ciblés par la campagne
• Destinataires : ensemble des destinataires
• Evènements : consigne les éléments de réception, retours
• Statistiques : synthétise, pour chaque destinataires, les évènements survenus sur la campagne

Ce plugin propose deux instances :

• Une première instance qui génère un identifiant unique et active un webhook permettant d’obtenir en temps réel les statistiques suite à un envoi de sms.
• Une seconde instance qui réalise les envois de sms sur des numéros de mobiles français dans le cadre d’une campagne.
• Une première instance,‘YellowBox SMSing - Tracking (Webhook), qui génère un identifiant unique et active un webhook permettant d’obtenir en temps réel les statistiques suite à un envoi de sms.
• Une seconde instance, ‘YellowBox SMSing - Envoi (fonction)’, qui réalise les envois de sms sur des numéros de mobiles français dans le cadre d’une campagne.

Installation #

Téléchargement à partir du YellowBox Store #

Le plugin est téléchargeable par l’administrateur depuis le YellowBox Store accessible via le bouton de la barre de notification.

• Cliquer sur le pavé du plugin pour voir le descriptif et accéder aux fonctions d’installation et de mise à jour.

• Cliquer sur le bouton [Installer] pour l’ajouter à la liste des plugins paramétrables dans votre YellowBox CRM.

• Sélectionner un pack de crédits et cliquer sur [Commander] pour recevoir un email de validation de commande et ainsi activer le pack (Détail des packs de crédits disponible sur le YellowBox Store).

Pré requis : YellowBox CRM Version 9.16 ou supérieure

A tout moment, le nombre de crédits disponibles est visible directement au niveau du YellowBox Store et dans l’onglet ‘Reporting administrateur’ du menu Maintenance.

Paramétrage du plugin #

Le plugin YellowBox SMSing peut faire l’objet de plusieurs utilisations dans la base YellowBox CRM. Pour chaque cas d’usage, il convient d’ajouter un paramétrage particulier.

Pour ce faire, aller dans le menu paramétrage sur Automatismes/Traitements, onglet ‘Traitements’, sous-onglet ‘Plugins’.

Cliquer sur le bouton [+ Ajouter].

Le paramétrage d’un plugin nécessite la réalisation des opérations suivantes

• Donner un nom unique qui vous permettra de le repérer facilement par la suite

• Sélectionner le plugin désiré dans la listes des plugins téléchargés

• Sélectionner l’instance désirée

• Entrer les différents paramètres demandés

Le paramétrage d’un plugin nécessite la réalisation des opérations suivantes :

• Créer les tables et champs nécessaires au paramétrage du plugin
• Donner un nom unique qui vous permettra de le repérer facilement par la suite
• Sélectionner le plugin désiré dans la listes des plugins téléchargés
• Sélectionner l’instance désirée
• Entrer les différents paramètres demandés

Les instances disponibles #

Deux instances sont disponibles avec ce plugin.

YellowBox SMSing - Tracking (Webhook) #

Cette instance permet de générer un identifiant unique et d’activer un webhook permettant d’obtenir en temps réel les statistiques suite à un envoi de sms. Cette instance doit être paramétrée en premier car le webhook généré devra être copié/collé au niveau du paramétrage de l’instance d’envoi.

Bien penser à valider le plugin dès lors qu’un nouveau webhook est généré via clic sur le bouton de génération.
Aucune planification n’est nécessaire pour obtenir en temps réel toutes les informations de réception du sms et de retours STOP : le webhook permet la mise à jour des statistiques de manière automatique et ce pendant la durée définie lors de l’envoi de la campagne de sms correspondante (Cf. instance YellowBox SMSing - Envoi)

Pour chacun des paramètres suivants, une table ou un champ doivent être sélectionnés. Il convient donc de vérifier en amont leur existence dans la structure de la base, ou de les créer en respectant le type indiqué.

Ces champs seront utilisés ou alimentés automatiquement par le plugin.

Seules les correspondances non explicites ou demandant un complément d’informations sont ci-dessous développées.

Table campagne #

Table destinataires #

Champ désabonnement du destinataire - Type booléen

Tous les champs suivant seront mis à jour par le plugin. Seules les correspondances non explicites ou demandant un complément d’information sont ci-dessous développées.

Table campagne #

Table destinataires #

Champ désabonnement du destinataire : #

Permet d’automatiser la mise à jour de la fiche du destinataire dès lors qu’il a émis un STOP en retour de campagne.

Nombre total de SMS générés (campagne) - Type numérique (saisie libre)

Nombre total de SMS en erreur (campagne) - Type numérique (saisie libre)

Nombre total de STOP (campagne) - Type numérique (saisie libre)

Table de statistiques #

ID Campagne-Destinataire (statistiques) - Type alphanumérique (saisie libre)

Statut du SMS (statistiques) - Type alphanumérique (saisie libre)

Désabonnement (statistiques) - Type booléen

ID du destinataire (statistiques) - Type table ‘destinataires’

Table évènement #

Date de l’évènement (évènement) - Type Date complète (jj/mm/aaaa)

Type d’évènement (évènement) - Type alphanumérique (saisie libre)

ID campagne (évènement) - Type table ‘campagne’

ID destinataire (évènement) - Type table ‘destinataires’

Référence de la campagne avec tracking (campagne) : #

Référence générée par le plugin lors de l’envoi, elle sert d’identifiant pour la récupération des retours

Nombre total de SMS reçus par les destinataires (campagne) #

Nombre total de SMS en erreur (campagne) #

Nombre total de STOP (campagne) #

Table de statistiques #

ID Campagne-Destinataire (statistiques) #

Statut du SMS (statistiques) #

Désabonnement (statistiques) #

ID du destinataire (statistiques) #

Table évènement #

Date de l’évènement (évènement) : #

Le champ doit être créé en type ‘Date complète + heure’

Type d’évènement (évènement) #

ID campagne (évènement) #

ID destinataire (évènement) #

YellowBox SMSing - Envoi (Fonction) #

Cette instance permet de réaliser les envois de sms sur les destinataires ciblés par une campagne. Il est nécessaire de bien renseigner le webhook généré au préalable dans l’instance précédente afin de mettre à jour automatiquement la base des évènements d’envoi et de stop. Cette instance permet de réaliser les envois de sms vers les destinataires ciblés par une campagne. Il est nécessaire de bien renseigner le webhook généré au préalable dans l’instance précédente afin de mettre à jour automatiquement les évènements de réception et de stop.

Paramètres entrants : #

Sont listés ici les paramètres nécessaires à la réalisation de la campagne par le routeur.

Token du webhook associé au tracking :

Permet d’activer l’écoute et la prise en compte des retours potentiels (réception/STOP)

ID_Element de la fiche campagne

Message à envoyer - Type zone de texte (non html)

Nom de l’émetteur - Type alphanumérique (saisie libre)

Seuls les 11 premiers caractères sont pris en compte.

Durée de vie du tracking (en heures) - Type numérique (saisie libre) Cocher la case ‘dans le contexte d’une fiche’ et sélectionner la table correspondant à ‘campagne’ dans le paramètre qui suit.

> Paramètres entrants
#

Sont listés ici les paramètres nécessaires à la réalisation de la campagne par le routeur. Sélectionner pour chaque paramètre la table ou le champ correspondant.

Token du webhook associé au tracking : #

Permet d’activer l’écoute et la prise en compte des retours potentiels (réception/STOP).

Valeur à copier depuis l’instance ‘YellowBox SMSing - Tracking (Webhook)’ créée précédemment.

ID_Element de la fiche campagne #

Message à envoyer : #

Champ à créer en texte brut

Nom de l’émetteur : #

C’est la valeur saisie dans ce champ qui apparaitra en tant qu’expéditeur à la réception des sms

Durée de vie du tracking (en heures) : #

Indiquer une durée assez longue par rapport à la lecture du sms (exemple pour 90 jours : 2160 heures). Dans le cas où la valeur est laissée à 0 (zéro), le webhook a une durée illimitée.

Table des destinataires #

Téléphone des destinataires - Type téléphone

Nom des destinataires - Type alphanumérique (saisie libre)

Demande de désabonnement du contact - Type booléen

Permet une sécurité en bloquant l’envoi vers un destinataire si un désabonnement est indiqué au niveau de sa fiche.

Table des destinataires : #

Téléphone des destinataires #

Nom des destinataires #

Demande de désabonnement du contact : #

Le champ sélectionné doit être de type booléen. L’envoi vers le destinataire est bloqué si la valeur du champ est à 1 (ou à oui).

Paramètres sortants : #

Ces informations sont mises à jour dans la base YellowBox CRM automatiquement suite à l’envoi de la campagne SMS

> Paramètres sortants
#

Ces informations sont mises à jour automatiquement dans la base YellowBox CRM suite à l’envoi de la campagne SMS :

Référence de la campagne avec tracking (Table Campagne) #

Identifiant généré par le plugin lors de l’envoi

Date de traitement (Table Campagne) #

Le champ doit être créé en type ‘Date complète + heure’

Traitement réalisé par (Table Campagne) : #

Champ à créer en alphanumérique pour recevoir le prénom suivi du nom de l’utilisateur qui a effectué l’envoi

Nombre total envoyé (Table Campagne) #

Nombre total bloqué (Table Campagne) #

Référence de la campagne avec tracking (Table Campagne) - Type alphanumérique (saisie libre)

Date de traitement (Table Campagne) - Type date complète + heure (jj/mm/aaaa hh:mm)

Traitement réalisé par (Table Campagne) - Type alphanumérique (saisie libre)

Nombre total envoyé (Table Campagne) - Type numérique (saisie libre)

Nombre total bloqué (Table Campagne) - Type numérique (saisie libre)

Afin de se prémunir d’une éventuelle mise à jour des résultats dans une fiche en cours d’utilisation, il est conseillé de paramétrer un processus qui recalcule les champs de la fiche campagne sur la base des résultats de la table ‘statistiques’.

Intégration des fonctions #

Ces fonctions peuvent être intégrées dans des processus mis à disposition pour les utilisateurs via paramétrage de l’administrateur selon les écrans disponibles.

Gestion des crédits #

Règle de décrémentation des crédits :
A chaque envoi d’un message sms un crédit est décompté par tranche de 160 caractères.
Exemples de décompte de crédits :

• Pour un message de 82 caractères -> 1 crédit,
• Pour un message de 169 caractères -> 2 crédits,
• Pour un message de 330 caractères -> 3 crédits,
• etc

Incrémentation des crédits :
Cela nécessite la commande d’un nouveau pack via YellowBox Store.

• 82 caractères -> 1 crédit,
• 169 caractères -> 2 crédits,
• 330 caractères -> 3 crédits,
• etc