HubSpot : mise à jour de l'abonnement

Le modèle de point HubSpot : mise à jour de l’abonnement écrit l’état de l’abonnement push et l’étape du parcours sur un contact HubSpot existant, afin que les équipes de vente et de marketing par e-mail voient ce que la personne reçoit déjà de l’application.

Ce point s’authentifie avec son propre jeton d’application privée HubSpot — il n’utilise aucune intégration HubSpot au niveau du compte configurée ailleurs dans les Paramètres.

Configurer le point

1. Faites glisser HubSpot : mise à jour de l’abonnement de la section Intégrations sur le canevas.
2. Double-cliquez sur le point et saisissez un Nom d’étape.
3. Dans Jeton d’application privée, saisissez un jeton d’application privée HubSpot avec la portée crm.objects.contacts.write. Il est stocké masqué, comme un en-tête secret de webhook.

4. Dans Rechercher le contact par, saisissez le nom interne de la propriété HubSpot qui contient l’identifiant — email par défaut, ou une de vos propres propriétés qui contient l’ID utilisateur Pushwoosh. HubSpot ne recherche un contact que par une propriété dont il conserve les valeurs uniques.

5. Dans Valeur de l’identifiant, saisissez la valeur à rechercher, par exemple {{device:user_id}} ou un tag du voyageur.

6. Dans Propriétés à écrire, ajoutez une ligne par nom interne de propriété HubSpot mappée à ce qu’il faut y écrire. Les noms ne doivent pas être vides et doivent être uniques. Voir champs clé/valeur. Outre les tags, la valeur peut utiliser {{device:push_subscribed}} pour l’état de l’abonnement push, {{now}} pour le moment où le voyageur est passé ici, ou {{journey:name}} / {{point:name}} pour l’endroit. Une cellule contenant une seule macro conserve le type propre à cette macro. Par exemple, {{device:push_subscribed}} seul arrive comme un booléen, et non comme la chaîne de caractères "true".

7. Cliquez sur Enregistrer.

Note

Chaque propriété dans Propriétés à écrire doit déjà exister sur l’objet contact HubSpot. Ce point ne crée pas de nouvelles propriétés. Configurez-les d’abord dans HubSpot. Si l’une d’elles n’existe pas, HubSpot rejette l’ensemble de la requête. Aucune des propriétés de cette étape n’est écrite, et le voyageur est retiré du parcours de la même manière que pour toute autre requête échouée.

Connecter les branches

Après avoir enregistré, le point affiche deux branches sur le canevas. Connectez une étape suivante à chacune :

• Mis à jour : l’identifiant correspondait à un contact HubSpot existant et HubSpot a renvoyé le contact mis à jour. Par exemple, continuez avec le reste du parcours.
• Non trouvé : HubSpot a répondu avec un 404 (aucun contact correspondant). Le voyageur n’est pas retiré. Le point ne réessaie pas et n’attend pas la fin d’un délai de récupération après une requête échouée comme le ferait une véritable requête échouée. Par exemple, envoyez un chemin différent ou créez d’abord le contact.

Non trouvé n’est pas une requête échouée. Une véritable requête échouée retire le voyageur à la place. Voir Erreurs et requêtes échouées.

Réponse

Sur Mis à jour, les étapes ultérieures peuvent utiliser l’ID du contact HubSpot comme hubspot_contact_id. Utilisez-le de la même manière qu’un attribut de réponse Webhook. Par exemple, définissez un Tag avec Mettre à jour le profil utilisateur.

Sur Non trouvé, cet attribut n’est pas disponible.

Scénario d’exemple : Synchronisation de l’état de l’abonnement push avec HubSpot après l’opt-in

Une équipe souhaite que les services de vente et de marketing par e-mail voient, directement sur le contact HubSpot, si une personne a opté pour les notifications push.

1. Ajoutez un élément Entrée basée sur un déclencheur et configurez-le pour qu’il se déclenche sur un événement PushOptedIn.
2. Ajoutez HubSpot : mise à jour de l’abonnement juste après. Laissez Rechercher le contact par sur email et définissez Valeur de l’identifiant sur {{tag:Email}}. Dans Propriétés à écrire, définissez push_subscribed sur {{device:push_subscribed}}.
3. Cliquez sur Enregistrer, puis connectez Mis à jour au reste du parcours et Non trouvé à une étape qui crée d’abord le contact, par exemple HubSpot : créer ou mettre à jour un contact.

Une fois que cela s’exécute, le contact HubSpot affiche l’état actuel de l’abonnement push du voyageur, de sorte que les équipes de vente et de marketing par e-mail n’ont pas à le deviner.