fbpx
France 05 82 95 81 35 - Belgique 02 319 88 46 - UK 0203 445 5618 - Maroc 05 24 43 92 19

Modules à installer

Il faut installer les modules suivants :

Contact Form 7 : c’est le module qui gère les formulaires

ContactForm 7 Redirection : c’est le module qui permet d’envoyer les données du formulaire à une API tierce

Nom des champs dans les formulaires

Le nom des champs doit respecter la syntaxe suivante :

nom_de_l'entité__nom_du_champ

Exemples

Nom du contact : contact__nom

E-mail du contact : contact__e_mail

Nom de la société : organisation__nom

Les entités disponibles

  • contact
  • organisation
  • action
  • note
  • affaire
  • produit
  • ticket
  • document

Attention : il faut respecter le nom des entités sinon les champs ne seront pas intégrés dans HOP CRM.

Exemple de formulaire

Création du contact

Par défaut l’API de HOP CRM va créer un contact.

Ce contact n’est créé que si le mail saisi dans le formulaire n’existe pas dans un contact déjà enregistré dans HOP CRM. Le champ utilisé pour faire ce test est le champ e-mail standard de HOP CRM e_mail qui correspond donc au champ contact__e_mail dans le formulaire (voir le paragraphe ci-dessus sur la syntaxe des noms de champs).

Si un contact avec le même e-mail est trouvé dans HOP CRM, ce contact sera automatiquement mis à jour avec les données saisies dans le formulaire si elles ne sont pas vides.

Définition des autres entités qui seront créées

L’API WordPress de HOP CRM permet de créer d’autres entités en plus du contact.

Par exemple si vous demandez le nom de la société dans votre formulaire vous aurez probablement envie de créer l’organisation correspondante dans HOP CRM.

De la même manière vous aurez probablement envie de créer une note associée au contact pour dire qu’il a complété un formulaire sur votre site internet.

Les entités à créer sont automatiquement détectées dans la liste des champs du formulaire et la liste des valeurs prédéfinies (voir ci-dessous).

Intégration de valeurs prédéfinies

HOP CRM vous donne la possibilité d’insérer des valeurs prédéfinies. Vous pourrez donc indiquer que l’origine du contact est votre site internet, donner un titre à la note qui sera associée au contact…

Nous allons utiliser pour cela un champ caché de type TEXTAREA qui s’appellera constantes et qui contiendra le nom des champs auxquels vous voulez affecter une valeur prédéfinie ainsi que la valeur à affecter à chaque champ.  Les champs seront séparés par un point-virgule.

Pour chaque champ à affecter la syntaxe est la suivante :

nom_de_l'entité__nom_du_champ:valeur_à_affecter

Exemple

Cas des champs à choix multiple

Il s’agit des champs qui dans HOP CRM ont le type TAG, BOUTON RADIO ou LISTE DEROULANTE.

Pour ces champs la valeur à affecter est celle que vous trouverez en mode EXPERT dans la colonne ID de la liste que vous trouverez sur la page Réglages/Autres sources de données de HOP CRM :

Dans cet exemple pour indiquer que l’origine du contact est un formulaire sur votre site internet il suffit d’indiquer :

contact__origine:2581

Page de remerciement

La page de remerciement (appelée aussi page de redirection) doit être spécifiée dans le formulaire.

Nous allons utiliser pour cela un champ caché de type TEXT qui s’appellera merci et qui contiendra l’URL de la page de remerciement.

À noter : si vous ne spécifiez pas de page de remerciement, la page contenant le formulaire sera réaffichée.

Connexion du formulaire à l’API de HOP CRM

Dans l’onglet Redirection du formulaire faire les actions suivantes :

  • saisir l’URL que vous trouverez dans HOP CRM sur la page Réglages/Connecteurs/WordPress
  • cocher la case Use external URL
  • cocher la case Pass all the fields from the form as URL query parameters

Attention : il faudra refaire ces actions à chaque nouveau formulaire

Où trouver l’URL dans HOP CRM

Exemple de configuration