====== Client App - Campagnes CRM ======

Cette vue permet d'associer des campagnes créées dans SuiteCRM à des campagnes PureCloud.
La campagne PureCloud peut être créée automatiquement à partir des données d'une campagne SuiteCRM choisie.

  - [[#Accès]]
  - [[#Utilisation]]
    - [[#Page d'accueil]]
    - [[#Page d'une campagne marketing]]
  - [[#Configuration]]
    - [[#Créer une nouvelle campagne Marketing dans SuiteCRM]]
    - [[#Créer une nouvelle target list Marketing dans SuiteCRM]]
  - [[#Infos techniques]]
    - [[#Campagne PureCloud]]
    - [[#Liste de contact PureCloud]]

----

===== Accès =====
Pour avoir accès il faut faire partie du groupe Collaborate ''[[https://apps.mypurecloud.ie/directory/#/group/56a8e5fe575e7515f3cb43ed|Campagnes sortantes]]''. \\
L'accès se fait le menu Performances > Campagnes CRM \\
{{:purecloud:clientapps:clientapp_campaignmanager.png?400|}}


----

===== Utilisation =====

==== Page d'accueil ====
La page d'accueil affiche la liste des campagnes créées dans **SuiteCRM**.\\

{{:purecloud:clientapps:campaignmanger_index.png?600|}} \\

Chaque ligne représente une campagne différente. En cliquant sur l'identifiant on accède à [[#Page d'une campagne marketing|la vue détaillée de la campagne]] sans quitter PureCloud.\\
On peut aussi faire bouton droit sur le nom de la campagne > Ouvrir comme un nouvel onglet pour [[#Créer une nouvelle campagne Marketing dans SuiteCRM|voir la campagne dans SuiteCRM]] (Impossible de cliquer sur le lien directement pour des raisons de sécurité). \\
On peut faire de même sur le bouton ''+ Créer une campagne marketing'' pour [[#Créer une nouvelle campagne Marketing dans SuiteCRM|créer une nouvelle campagne dans suiteCRM]].
\\
\\
==== Page d'une campagne marketing ====
Cette page affiche le détail d'une campagne SuiteCRM sélectionnée.\\
{{:purecloud:clientapps:campaignmanager_campaign.png?600|}}\\
\\
Les données dans l'entête grise sont issues de la campagne telle qu'elle est [[#Créer une nouvelle campagne Marketing dans SuiteCRM|configurée dans SuiteCRM]] (Titre, description et autres données : type, budget, statut, etc.).\\
**Pour créer une une campagne PureCloud** à partir de cette campagne et de [[#Créer une nouvelle target list Marketing dans SuiteCRM|la liste de cibles associées dans SuiteCRM]] il faut choisir un ''script'' et une ''queue'' dans la partie inférieure gauche et cliquer sur ''[[#Créer une nouvelle campagne Marketing dans SuiteCRM|+ Créer la campagne PureCloud]]''.\\
Tu peux aussi choisir dans la partie de droite les champs des Accounts qui feront partie de la contact list ou même ajouter des champs vides (Les champs vides n'importeront pas des données des Accounts mais seront présents dans la liste de contact PureCloud pour collecter des informations en retour).\\
Les actions suivantes sont alors exécutées : 
  - Création d'une liste de contacts PureCloud au nom de la campagne (précédée de "CRM" et suivie de la date)
  - Ajout des contacts (associés à la campagne Marketing dans le CRM) à la liste de contact PureCloud
  - Création d'une campagne preview utilisant le script et la queue choisis + la liste de contact qui vient d'être créée
  - Mise à jour de SuiteCRM pour faire référence à la campagne et la liste de contacts PureCloud. 

Lorsque la campagne PureCloud est créee, cette vue affiche des liens vers la campagne PureCloud et la Contact List PureCloud.\\
{{:purecloud:clientapps:campaignmanager_campaign_creation.png?600|}} \\

----

===== Configuration =====

==== Créer une nouvelle campagne Marketing dans SuiteCRM ====
Pour créer une nouvelle campagne utilisant des contacts SuiteCRM, il suffit de cliquer sur le lien ''[[#Créer une nouvelle campagne Marketing dans SuiteCRM| + Créer une nouvelle campagne CRM]]'' sur la page d'accueil.\\
{{:purecloud:clientapps:suitecrm_campaigns.png?600|}}\\
Pour créer une nouvelle campagne marketing, il suffit de cliquer sur ''Create Campaign'' dans le menu à gauche.\\
Les paramètres utiles à choisir : 
  * Choix du modèle
    * ''Modèle'' : //Non email based campaign//
  * Header
    * ''Name'' : Le nom qui apparaîtra dans PureCloud
    * ''Description'' : Description rapide visible dans PureCloud
    * ''Statut'' : Laisser ''Planning'', elle passera automatiquement en ''Active'' lorsqu'elle sera créée dans PureCloud.
  * ''Type'' : Laisser Telesales mais n'importe quelle valeur fonctionne
  * Budget
    * ''Budget'', 'Actual Cost'', ''Expected revenue'', 'Expected Cost'' peuvent tous recevoir une valeur, ils seront visibles dans la vue d'une Campagne dans PureCloud.
  * Target Lists\\Ici il faut choisir une target list créée dans SuiteCRM. C'est la liste qui fait référence aux accounts SuiteCRM (qui feront partie de la contact list PureCloud)
    * Pour //utiliser une liste existante// il suffit de cliquer dessus dans la liste ''Add Existing Target List''
    * Pour //créer une nouvelle liste// il faut cliquer sur ''CREATE'' dans la zone ''Create New Target List'' en choisissant au préalable ''Target List Type'' : ''Default'' et un nom dans le champ ''Target List Name'' (Cette liste est vide dans un premier temps, elle sera remplie par la suite)

A ce stade la campagne marketing est créée et une target list est associée. Si la target list vient d'être créée, il faut la remplir car elle est toujours vide.\\

==== Créer une nouvelle target list Marketing dans SuiteCRM ====
Pour remplir la target list, il faut aller dans le menu Marketing > Targets - Lists\\
{{:purecloud:clientapps:suitecrm_targetslists.png?600|}}\\
  * Cliquer sur la campagne que l'on veut remplir.\\
{{:purecloud:clientapps:sutiecrm_targetslist.png?600|}}\\
Dans la section ''Accounts'' on retrouve tous les comptes associés à la liste.
  * Cliquer sur ''Create V'' > ''Select'' (Bien cliquer la partie à droite du bouton !!) dans la section ''Accounts''
  * Dans la page qui s'ouvre, effectuer la recherche des comptes (un simple clic sur ''SEARCH'' permet d'avoir tous les Accounts
  * Dans la partie inférieure (la liste), cocher les Accounts à importer et cliquer sur ''SELECT''

A ce stade la campagne marketing est prêtre pour être utilisé dans l'extension PureCloud.

----

===== Infos techniques =====
Quelques informations supplémentaires sur la config de l'intégration.

==== Campagne PureCloud ====
La campagne PureCloud est créée avec les paramètres suivants : 
  * ''dialingMod'': **preview**
  * ''campaignStatus'': **off**
  * ''abandonRate'': **5**
  * ''dncLists'': //Aucune//
  * ''callerName'': **Genesys Demo**
  * ''callerAddress'': **+33186760873**
  * ''ruleSets'': //Aucun//
  * ''skipPreviewDisabled'': **false**
  * ''singleNumberPreview'': **true**
  * ''alwaysRunning'': **true**

==== Liste de contact PureCloud ====
Liste des champs importés de la fiche Account SuiteCRM : 

  * id
  * name
  * description
  * phone_office
  * phone_alternate
  * assigned_user_name
  * account_type
  * industry
  * annual_revenue
  * billing_address_street
  * billing_address_postalcode
  * billing_address_city
  * billing_address_country
  * rating
  * website
  * employees
  * email_c
  * sic_code