YellowBox Emailing

YellowBox Store #

Objet #

Le plugin YellowBox Emailing permet de gérer directement à partir de YellowBox CRM l’envoi d’emailing de masse utilisant un modèle de courrier responsive ou non à destination de personnes physiques via leurs emails consignés dans la base de données. A charge de l’émetteur de respecter toutes les contraintes inhérentes au RGPD. Il est alors possible de consigner les évènements liés aux emails envoyés en récupérant le tracking des emails ouverts et des liens cliqués (y compris le lien de désabonnement).

A fin d’améliorer le taux de délivrabilité d’un emailing, il est vivement conseillé de paramétrer au niveau du domaine de l’organisation les notions de SPF et DKIM.

La base livrée contient déjà un paramétrage par défaut permettant l’expoitation de la fonction. Si toutefois l’administrateur est amené à faire des évolutions de paramétrage, il lui conviendra de mettre à jour ou d’ajouter les plugins paramétrés nécessaires à.

Installation #

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.
• Cliquer sur le bouton [Installer] pour télécharger dans la liste des plugins paramétrables dans votre YellowBox CRM.

Pré-requis :

• Choix d’un pack d’emails/mois

Ce plugin nécessite une activation.

Paramétrage #

Le plugin YellowBox Emailing 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/Automatismes/Traitements/Traitements/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

Les instances disponibles #

Deux instances sont disponibles avec ce plugin.

IntegrateCampaign(Fonction) #

Cette instance permet d’envoyer en masse un courrier type à des destinataires reliés à une campagne d’emailing.

Seules les correspondances non explicites ou demandant un complément d’information sont ci-dessous développées : Référence du courrier type HTML :

Nom de la campagne :

Sujet de la campagne :

Type de campagne : la valeur de ce champ doit être EMAIL

Type d’adresse émetteur : dans le cas où aucun fichier SPF n’a été paramétré au niveau des DNS, il convient pour une meilleure délivrabilité de renseigner NOREPLY. Dans ce cas, le nom d’affichage sera bien pris en compte dans les boites de réception des destinataires, mais l’email émetteur sera [email protected].
Si un fichier SPF a bien été paramétré au niveau des DNS, sélectionner SPF. Dans ce cas l’email est bien émis avec un email dont l’émetteur appartient au domaine.

Nom d’affichage associé à l’adresse mail : faire ici la correspondance avec le champ contenant l’alias qui apparaît chez le destinataire de l’email.

Adresse mail de l’émetteur de la campagne : cette correspondance est active uniquement si le type d’adresse émetteur sélectionné est SPF.

Mail de résumé de campagne une fois terminée

Date de début de campagne : cette correspondance permet d’indiquer la date effective du traitement.

Date de fin de campagne :

Modèle de courrier HTML :

Référence de campagne AVM : référence de la campagne chez le routeur.

Table liée (Destinataires) : table qui référence les fiches dont les emails sont utilisés pour effectuer les envois (exemples : contacts, leads, adhérents…)

Adresse Email du destinataire :

Case à cocher d’erreur de syntaxe adresse Email du destinataire (id Champs) : dans le cas où un email compris dans la liste des emails à émettre présente une erreur de syntaxe, il est possible de marquer la fiche via une case à cocher. Il est alors possible de sortir la liste des fiches contenant une erreur de syntaxe simplement via une liste.

Dans le cas où un destinataire ciblé a un email vide ou erroné au niveau de la syntaxe, il est exclu de la liste finale envoyée effectivement au routeur.

Dans le cas où un destinataire ciblé a un email dont la syntaxe est bonne mais l’email inconnu, la zone ‘Statut de la stat’ remonte un message contenant ‘User unknown in relay recipient table’. Il est également comptabilisé dans le nombre d’erreurs au niveau des statistiques.

Fax du destinataire : non utilisé

Sms du destinataire : non utilisé

Heure de début de campagne : l’heure doit être formatée de la manière suivante ‘hh:mm’

GetStats (Fonction) #

Cette instance permet de récupérer les actions réalisées par les destinataires de la campagne d’emailing. Seront mis à jour les résultats statistiques au niveau de la campagne, mais également au niveau des destinataires avec un total et un détail.

Ces derniers résultats sont consignés dans deux tables créées à cet effet :

• Une table de statistiques contenant nécessairement les informations telles que la référence de la campagne, la référence du contact.
• Une table consignant le détail de chaque évènement contenant le type d’action remonté et éventuellement le lien cliqué.

Deux types d’évènements sont remontés :

• A ouvert l’email (Opened)
• A cliqué sur un lien (Clicked) : dans ce cas est remontée également le lien effectivement cliqué

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

Référence YB de la fiche campagne :

Référence de la fiche campagne dans AVM (Table Campagne) : référence chez le routeur de la campagne. Cette valeur a été automatiquement alimentée lors de l’envoi effectif par le routeur.

Date de dernière récupération des stats (Table Campagne) :mise à jour au fil des récupérations de tracking.

Référence de la table Destinataires : table à partir de laquelle les destinataires de la campagne ont été ciblés initialement.
Exemples : contacts, leads, adhérents, bénévoles….

Date de dernière récupération de stats de la campagne (Table Campagne) :

Etat de campagne (Table Campagne) : état de la campagne chez le routeur (à venir, en cours, terminée).

Nombre total (Table Campagne) : Nombre total de blacklist (Table Campagne) : Nombre total envoyé (Table Campagne) : Nombre total d’erreur (Table Campagne) : Nombre total en attente (Table Campagne) : Nombre total généré (Table Campagne) :

Table de statistiques : table qui accueille les statistiques par destinataire.

Statut de la stat du destinataire (Table Stat) : Campagne-Destinataire (Table Stat) : Table d’évènements : table qui accueille le détail des évènements pour chacun des destinataires.

Lien URL (Table Evènement) : Date du click du lien URL (Table Evènement) : Type (Table Evènement) : Données (Table Evènement) :

Intégration #

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. Une documentation particulière est disponible détaillant l’ensemble des traitements et autres paramétrages nécessaires à.