Mapper vos propriétés HubSpot dans Livestorm

Mapper vos propriétés HubSpot dans Livestorm#

Cette procédure est uniquement disponible pour les clients disposant des forfaits HubSpot « Data Hub Professional » ou « Data Hub Enterprise » (anciennement Operations Hub).

1 En suivant la même procédure que dans la section précédente, créez une propriété personnalisée dans vos contacts HubSpot pour chaque donnée que vous souhaitez transmettre de HubSpot à Livestorm, au format suivant :

  • « Custom property » (texte sur une ligne).

2 Comme précédemment, créez un nouveau workflow vierge (Blank Workflow) et définissez l'envoi de votre formulaire comme déclencheur :

Déclencheur du workflow HubSpot : envoi du formulaire

3 Si vous utilisez l'approche dynamique, dans laquelle vous avez ajouté l'ID de session comme valeur par défaut du champ masqué Livestorm Session ID de votre formulaire, passez à l'étape suivante. Sinon, ajoutez une action Set property value et définissez « livestorm_session_id » sur l'ID de la session à laquelle vous souhaitez inscrire vos contacts :

Action Set property value pour livestorm_session_id

Veillez à coller l'ID de la SESSION et non l'ID de l'événement. 👌

ID de session Livestorm saisi dans l'action

Le jeton d'API doit être créé avec les permissions « Write » (accès complet en lecture et en écriture).

4 Ajoutez une action Custom code :

  • Dans Secrets, cliquez sur Choose secret, puis sur Add secret. Dans le champ « Secret name », saisissez « API_Key » et dans le champ « Secret Value », saisissez votre clé d'API Livestorm. Le résultat doit ressembler à ceci :

Ajout du secret API_Key dans l'action Custom code
  • Dans Property to include in your code, ajoutez « livestorm_session_id » ainsi que toutes les propriétés personnalisées que vous devez mapper entre votre formulaire d'inscription HubSpot et l'inscription Livestorm. Vous devez inclure au minimum l'e-mail, le prénom et le nom du contact.

  • Ajoutez le code suivant :

const axios = require('axios')

exports.main = async (event, callback) => {
  //Get contact properties
  const { email, firstname, lastname, livestorm_session_id: sessionId } = event.inputFields;
        
  const body = {
    data: {
      type: "people",
      attributes : {
        fields: [
          {
            id: "email",
            value: email,
          },
          {
            id: "first_name",
            value: firstname,
          },
          {
            id: "last_name",
            value: lastname
          },
          // Map Custom properties here
          /*
          {
            id: "livestorm_custom_property",
            value: event.inputFields['hubspot_custom_property']
          },
          */
        ],
      },
    },
  };
  
  const headers = {
    'Accept': 'application/vnd.api+json',
    'Content-Type': 'application/vnd.api+json',
    'Authorization': process.env.API_Key,
  };

  // POST Registrant to Session 
  axios.post(`https://api.livestorm.co/v1/sessions/${sessionId}/people`, body, { headers })
    .then((response) => {
      callback({
        outputFields: {
          contact_connection_link: response.data.data.attributes.registrant_detail.connection_link,
        },
      });
    })
    .catch(err => console.error(err));
}
  • Dans Data output, ajoutez une chaîne « contact_connection_link » (nécessaire uniquement si vous souhaitez stocker le lien d'accès dans HubSpot).

Data output contact_connection_link dans l'action Custom code

5 Ajoutez une action Copy property value et copiez « contact_connection_link » dans la propriété de contact « livestorm_connection_link » (nécessaire uniquement si vous souhaitez stocker le lien d'accès dans HubSpot).

Action Copy property value dans le workflow HubSpot
Copie de contact_connection_link vers livestorm_connection_link
Paramètres de l'action Copy property value

6 Si votre workflow ressemble à celui ci-dessous, vous pouvez l'activer en haut à droite. 🎉

Aperçu du workflow HubSpot complet

7 Pour vos prochaines intégrations, il vous suffit de cloner ce workflow et de :

  • Modifier le déclencheur en changeant le formulaire et/ou la page à la première étape du workflow.

  • Modifier l'ID de session à la deuxième étape.

Rejoignez notre démonstration produit Livestorm en direct

Au cours de cet évènement de 30 minutes, nous vous présenterons la plateforme. Vous apprendrez comment utiliser Livestorm pour vos webinars.