Les prospects Salesforce peuvent être créés lorsqu’un utilisateur s’inscrit sur votre forum en configurant un événement utilisateur webhook pour poster vers Zapier, puis en utilisant l’intégration Salesforce de Zapier pour créer le prospect.
Créer un nouveau Zap
Connectez-vous à Zapier et cliquez sur le bouton Créer un Zap ! Vous serez redirigé vers une page contenant un formulaire pour créer votre Zap :
Donnez un nom à votre Zap, puis cliquez sur Choisir une application dans la section Déclencheur du formulaire. Dans la section Choisir une application de déclenchement de la page, sélectionnez Webhooks :
Dans le formulaire Sélectionner les Webhooks par le déclencheur Zapier, cliquez sur « afficher moins d’options courantes » puis sélectionnez Récupérer un hook brut (Catch Raw Hook) :
Cliquez sur Enregistrer + Continuer.
Ensuite, copiez l’URL du webhook dans votre presse-papiers.
Créer un webhook d’événement utilisateur Discourse
Pour créer le webhook Discourse, allez sur votre forum Discourse, puis accédez à Admin / API / Webhooks et cliquez sur le bouton Ajouter un webhook. Dans le formulaire qui apparaît, collez l’URL du webhook Zapier dans le champ URL de la charge utile (Payload URL). Sous « Quels événements doivent déclencher ce webhook ? », sélectionnez Sélectionner des événements individuels. Ensuite, dans le groupe Événements utilisateur, cochez la case Un utilisateur est créé. Cochez la case Actif pour activer le webhook, puis cliquez sur le bouton Créer.
Astuce : Puisque vous sélectionnez uniquement l’événement user_created, Discourse ne déclenchera ce webhook que lorsqu’un nouvel utilisateur s’inscrira — et non pour d’autres modifications d’utilisateur. Cela signifie que l’étape de filtre Zapier décrite ci-dessous est facultative, mais toujours recommandée comme mesure de sécurité.
Tester le webhook sur Zapier
Retournez maintenant sur Zapier et cliquez sur le bouton « Ok, j’ai fait cela » :
Vous devez maintenant envoyer une requête exemple depuis Discourse vers Zapier. Pour générer les données nécessaires à la test des étapes suivantes, vous devrez créer un nouvel utilisateur sur votre forum. Une adresse Gmail jetable convient bien pour cela. Inscrivez-vous sur votre forum en tant que nouvel utilisateur, puis retournez à l’étape d’échantillon de Zapier pour examiner les données.
Vous pouvez développer l’échantillon pour voir les données envoyées par Discourse. Cliquez sur Continuer pour passer à l’étape suivante.
Capturer l’événement Utilisateur créé de Discourse
Si vous avez sélectionné uniquement l’événement user_created lors de la configuration du webhook dans Discourse, cette étape de filtre est facultative. Cependant, c’est toujours une bonne mesure de sécurité. Cliquez sur Ajouter une étape, puis sur Filtre :
Pour filtrer tous les événements sauf l’événement Utilisateur créé, configurez le filtre pour ne continuer que si Headers Http X Discourse Event correspond exactement à user_created.
Cliquez sur le bouton Tester et Continuer. Si vous avez déclenché l’événement exemple en créant un nouvel utilisateur sur votre forum, vous devriez voir un message de succès. Si vous voyez plutôt un message indiquant que votre Zap n’aurait pas continué, retournez à vos données d’échantillon et assurez-vous que ses Headers Http X Discourse Event sont définis sur user_created.
Cliquez sur le bouton Continuer pour passer à l’étape suivante.
Analyer la charge brute avec une étape Exécuter du JavaScript
Cliquez sur Ajouter une étape dans le menu de votre Zap. Ensuite, cliquez sur Action/Recherche et sélectionnez Code dans le menu Action. Dans le formulaire Code, sélectionnez Exécuter-JavaScript.
Zapier créera un objet inputData auquel vous pouvez ajouter des propriétés nommées. Ajoutez un nom pour votre propriété dans la colonne de gauche. Dans la colonne de droite, sélectionnez « Récupérer un hook brut » dans le menu déroulant, puis sélectionnez « Corps brut » (Raw Body) :
Faites défiler la page vers le bas pour voir une zone de saisie de code :
Vous devez ensuite remplacer le code exemple par un code qui analyse le Corps brut et retourne un objet contenant les valeurs nécessaires pour votre action finale. Voici le code que j’utilise. Salesforce nécessite un nom de famille, donc si aucun nom de famille n’existe, une erreur est renvoyée. Sur mon site Discourse, j’ai ajouté un champ utilisateur personnalisé pour l’Entreprise qui est requis lors de l’inscription. Je souhaite transmettre ces données à Salesforce. En examinant la charge utile envoyée par Discourse, je sais que ce champ se trouve à \"user_fields\":[\"10\"]. Vous devrez configurer le code pour retourner les champs de données brutes que vous souhaitez transmettre à Salesforce.
const parsed = JSON.parse(inputData.raw);
if (parsed.user) {
const user = parsed.user,
name = user.name,
userFields = user.user_fields;
let firstName,
lastName,
company;
if (name) {
const splitName = name.split(' ');
firstName = splitName[0];
lastName = splitName[1]
}
if (userFields) {
company = userFields['10'];
}
if (lastName) {
return {id: user.id,
username: user.username,
lastName: lastName,
firstName: firstName,
email: user.email,
company: company,
error: null
};
} else {
return {error: \"Nom de famille manquant\"}
}
} else {
return {error: \"Un objet utilisateur n'a pas été renvoyé\"};
}
Après avoir ajouté votre code, cliquez sur le bouton Continuer, puis sur le bouton Tester cette étape. Les résultats devraient renvoyer les données du nouvel utilisateur :
Filtrer les demandes échouées
Si votre étape JavaScript a renvoyé une erreur, par exemple « Nom de famille manquant », vous pouvez ajouter une autre étape de filtre pour éviter d’envoyer des demandes échouées à Salesforce. Cliquez sur Ajouter une étape dans le menu des Zaps, puis sur Filtre. Configurez ce filtre pour ne continuer que s’il n’y a pas d’erreurs :
Créer un prospect sur Zapier
Cliquez sur Ajouter une étape, puis sur Action/Recherche. Dans le menu Action, recherchez et sélectionnez Salesforce. Dans le menu Action de Salesforce, sélectionnez Créer un prospect. Cliquez sur Enregistrer + Continuer. Ensuite, cliquez sur Connecter un compte. On vous demandera d’autoriser Zapier à accéder à votre compte Salesforce. Cliquez sur le bouton Tester pour vérifier que vous êtes connecté :
Sur la page Configurer le prospect Salesforce, vous pouvez ajouter des champs de l’étape Exécuter-JavaScript aux champs Salesforce correspondants :
Cliquez sur Continuer, puis sur Envoyer un test à Salesforce. Vous devriez voir un nouveau prospect Salesforce. Si tout fonctionne correctement, cliquez sur Terminer, puis activez le Zap.
