Webmecanik

YellowBox Store #

Objet #

Webmecanik est l’éditeur français d’une solution SaaS de marketing automation basé sur le produit opensource Mautic.

Le plugin Webmecanik permet à l’administrateur de la base YellowBox CRM de réaliser deux types de travaux dans YellowBox CRM :

• Pousser un segment dans Webmecanik à partir d’une table créée au préalable. Ce segment est alimenté via des contacts reliés statiquement et/ou des contacts issus d’une ou plusieurs recherches. Ceci permet de mettre à jour ou créer ces contacts dans Webmecanik et de les affectés au segment créé.

• Visualiser dans YellowBox CRM sur la fiche d’un contact synchronisé l’ensemble de ses comportements traqués dans Webmecanik.

Les utilisateurs ‘Marketing’ peuvent également mettre en oeuvre directement dans Webmecanik le connecteur Webmecanik -> YellowBox CRM permettant l’initialisation de la base Webmecanik à partir d’éléments de YellowBox CRM, mais également de pousser des contacts de Webmecanik vers YellowBox CRM (notion de PushToCrm).

Le plugin SearchField est également nécessaire en complément de celui de Webmecanik ; il permet de générer dans un écran de YellowBox CRM un champ dont l’objet est de lister des recherches dont le résultat constitue la liste des contacts impliqués dans un segment.

Le connecteur inclus dans Webmecanik et celui de YellowBox CRM peuvent être mis en oeuvre de manière totalement indépendante les uns des autres.

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.

Ce plugin nécessite une activation car soumis à abonnement (cf. tarification en ligne dans le YellowBox Store).

Identifiants de connexion #

Pour pouvoir connecter le plugin à la base de Webmecanik à partir de YellowBox CRM, il est également nécessaire de générer au préalable un token via l’écran Webmecanik suivant :

Pour se faire, il faut se connecter à son instance Webmecanik et cliquer sur la molette en haut à droite ce qui permet d’ouvrir le menu de paramétrage et de sélectionner [Identifiants de l’API].

Suite au clic sur le bouton [+ Nouveau] en haut à droite de l’écran, suivre les instructions :

• Renseigner le protocole d’autorisation OAuth2
• Donner un nom à la clé (qui sera repris dans le paramétrage côté YellowBox CRM)
• Indiquer l’URI en reprenant l’url de la base YellowBox CRM utilisée suffixée de /callbackoauth2.
  
  Toutes ces informations générées seront utiles pour permettre la connexion du plugin à Webmecanik.

Paramétrage #

Le plugin Webmecanik 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, accéder à la liste des plugins paramétrés via le menu administrateur ‘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.

Création/Mise à jour d’un segment de contacts (fonction) #

Permet de gérer des segments de contacts et de pousser les segments et les contacts reliés vers Webmecanik.

ContactActivityComponent (composant) #

Permet d’intégrer sur un design de contact, la liste des comportements observés par Webmecanik sur le contact courant.

Paramétrage d’une instance de type ‘Création/Mise à jour d’un segment de contacts’ #

L’écran de paramétrage se décompose en quatre parties distinctes :

• L’entête
• Les paramètres de connexion OAuth2
• Le paramétrage Webmecanik
• Le paramétrage du segment

Sélection de la table sur laquelle le composant paramétré sera intégré

• Cocher la case ‘Dans le contexte d’une fiche’, car ce composant ne peut être utilisé que dans un tel contexte.
• Sélectionner dans la liste déroulante la table à partir de laquelle le segment sera envoyé.

Paramètres de connexion OAuth2

Il convient ici de renseigner l’instance de Webmecanik sur laquelle les segments sont poussés et de renseigner le type d’information qui est poussé (Contact / Company).

• tokenName : nom qui a été donné à la clé d’API dans Webmecanik

• grantType : authorization_code

• redirectUri : url de la base YellowBox CRM suffixée de ‘/callbackoauth2’

• authorizationUri : url de l’instance Webmecanik suffixée de ‘/oauth/v2/authorize

• accesTokenUri : url de l’instance Webmecanik suffixée de ‘/oauth/v2/token

• clientId : clientId généré par Webmecanik lors de la création du token

• clientSecret : clientSecret généré par Webmecanik lors de la création du token

L’authentification doit être initiée via le bouton ‘Connexion’. En cas de réussite l’information ‘Connecté’ apparaît en bas de bloc.

Paramétrage Webmecanik

• Url de connexion : url de l’instance webmecanik
• Ressource : indiquer la table liée recensant les contacts (et les emails) du segment

Une fois la connexion effective, le bouton [Mettre à jour] permet de récupérer l’ensemble des champs sélectionnables pour le paramétrage des correspondances du dernier bloc de paramétrage. Il est alors possible de sélectionner les champs de Webmecanik avec lesquels une table de correspondance doit être établie avec les champs de YellowBox CRM pour pouvoir pousser les contacts de YellowBox CRM vers Webmecanik.

• Champs sélectionnables : sélectionner ici les champs des contacts dans Webmecanik sur lesquels une correspondance doit être effectuée.
• Champ contenant la clé YellowBox : dès lors qu’un contact est créé dans Webmecanik, la clé l’identifiant est stockée dans le champ indiqué ici dans YellowBox CRM.

Paramétrage du segment

Le haut de la liste reprend les correspondances qui sont obligatoires au bon fonctionnement du plugin :

• Clé Webmecanik t
• Titre du segment
• Champ contenant la liste des recherches

Il convient ensuite d’identifier la table contenant les contacts (contacts, leads ou autre) et de paramétrer une correspondance pour chacun de ces champ :

• Table reliée au segment
• Clé Webmecanik
• Champ 1 sélectionné
• Champ 2 sélectionné
• Champ …
• Email : clé de dédoublonnage des contacts dans Webmecanik

Paramétrage d’une instance de type ‘ContactActivityComponent’ #

L’écran de paramétrage se décompose en trois parties distinctes :

• L’entête
• Les paramètres de connexion OAuth2
• Le paramétrage Webmecanik

Sélection de la table sur laquelle le composant paramétré sera intégré

Il convient se sélectionner la table de la fiche à partir de laquelle le composant sera exécuté.

Paramétres de connexion OAuth2 : les informations nécessaires ici sont les même que sur le paramétrage de l’instance précédente.

Paramétrage Webmecanik

• Url de connexion : renseigner à ce niveau l’url de l’instance webmecanik
• Clé webmecanik : renseigner ici le champ de la fiche contact contenant la clé webmecanik du contact

Intégration du composant #

En tant qu’administrateur il est possible d’ajouter un plugin paramétré directement via les écrans des utilisateurs en cliquant sur le bouton central en bas d’écran [Mode éditeur]. Pour ajouter un composant Webmecanik préparamétré sur la fiche Contacts par exemple, il convient de réaliser les opérations suivantes : :

• Passer en mode éditeur
• Sélectionner l’objet qui doit accueillir le composant
• Cliquer dans la barre de propriétés apparaissant au bas de l’écran sur [Ajouter]
• Sélectionner [Composant] dans la liste déroulante
• Sélectionner dans la seconde liste déroulante le nom du plugin paramétré désiréé
• Ajuster la taille et la position du composant selon le résultat cible