HubSpot

L’intégration de OneSignal avec HubSpot vous permet d’automatiser la livraison de notifications push, d’e-mails, de SMS et de gérer les tags de données pour la messagerie intégrée via les workflows HubSpot. Cette intégration vous permet également de visualiser les activités OneSignal sur les chronologies de contacts et de segmenter les utilisateurs en fonction de leurs interactions avec OneSignal. Pour des fonctionnalités avancées telles que les tests A/B, la livraison intelligente, la limitation et le reciblage, vous pouvez utiliser OneSignal de manière indépendante.

---

​

Prérequis

• Vous devez être un Super Administrateur HubSpot ou disposer des Permissions App Market dans votre compte HubSpot.
• Compte OneSignal amélioré (non disponible sur les applications gratuites).

Clients historiques uniquement : Migration vers la nouvelle intégration HubSpot

​

Installation de la nouvelle intégration HubSpot

Comme décrit dans le guide général, les utilisateurs devront désormais activer l’intégration HubSpot depuis leur tableau de bord OneSignal, dans la section Integrations des paramètres de leur application

​

Migration de vos workflows

Bien que ce ne soit pas obligatoire, nous recommandons de créer un nouveau workflow pour tester la nouvelle intégration avant de remplacer les Actions dans vos workflows existants. Certains utilisateurs maintiennent également des environnements HubSpot de test et de production séparés à des fins de test.

​

Cloner votre workflow

Sur la page Workflows dans HubSpot, vous pouvez cliquer sur le bouton Clone à côté de votre workflow existant pour en créer une nouvelle copie.

​

Supprimer les déclencheurs du nouveau workflow

Après l’avoir cloné, vous devez d’abord supprimer tous les déclencheurs dans le workflow nouvellement créé. Cela garantira que vous pouvez publier le nouveau workflow sans le déclencher involontairement automatiquement.

​

Mettre à jour les anciennes actions OneSignal avec les nouvelles versions

Vous pouvez ensuite parcourir votre workflow, en supprimant toutes les anciennes actions OneSignal et en les remplaçant par la nouvelle. Étant donné que vous aurez probablement à la fois l’ancienne application OneSignal installée tout en utilisant également la nouvelle intégration construite par OneSignal, il sera important de faire attention à vous assurer que vous créez des actions à partir de la nouvelle application. L’ancienne application aura le texte “Built by HubSpot”.

The menu of actions when both legacy and new OneSignal apps are installed. Use the one that doesn't say 'Built by HubSpot'

​

Tester le workflow

Après avoir remplacé les actions du workflow et sauvegardé et publié votre workflow, vous pourrez inscrire manuellement des contacts pour tester le workflow. Nous vous recommandons de le faire d’abord avec un seul contact de test pour vous assurer que le workflow fonctionne correctement.

Exemple de migration d'un workflow HubSpot depuis l'intégration héritée.

Après avoir inscrit le contact, vous pourrez consulter l’historique d’inscription du workflow pour voir si les actions ont été réussies. Si vous rencontrez des erreurs inattendues, veuillez contacter le support OneSignal.Après avoir testé le workflow avec succès, vous pouvez soit remplacer le workflow original par la copie, soit apporter les mêmes modifications au workflow original.

---

​

Configuration

​

Activer HubSpot dans OneSignal

Dans OneSignal, accédez à la page Data > Integrations de votre application et sous HubSpot, sélectionnez Activate. Cliquez sur Authenticate, puis connectez-vous à votre compte HubSpot. Il se peut qu’on vous demande de choisir le compte HubSpot que vous souhaitez utiliser. Une fois que vous acceptez les conditions et sélectionnez Connect app, vous serez redirigé vers votre application OneSignal et devrez ouvrir le compte HubSpot nouvellement connecté.

​

Définir l’ID externe OneSignal

Afin de faire correspondre les utilisateurs dans HubSpot avec les utilisateurs dans OneSignal, vous devrez définir l’identifiant External ID dans OneSignal pour qu’il ait la même valeur qu’une propriété utilisateur unique que vous collectez dans HubSpot. Vous l’utiliserez pour la correspondance dans vos workflows HubSpot décrits ci-dessous. L’ID externe peut être défini de plusieurs manières, mais il est fortement recommandé d’utiliser une propriété facilement disponible dans votre application mobile ou votre site Web afin de pouvoir le définir sur les Subscriptions push de votre utilisateur avec notre méthode SDK login.

---

​

Définir un workflow HubSpot

Dans HubSpot, accédez à Automation > Workflows et cliquez sur Create workflow. Sélectionnez Contact-based et configurez votre inscription. Pour ajouter l’action OneSignal, cliquez sur le + et recherchez OneSignal. Nos actions de workflow vous permettent de créer des utilisateurs dans OneSignal, des Tags (qui sont des propriétés utilisateur personnalisées ou des événements) et d’envoyer des messages. Pour utiliser l’une ou l’autre action, vous devez d’abord définir quelques propriétés :

​

Champ Application OneSignal

Il s’agit de l’application OneSignal que vous avez connectée au compte HubSpot lors des instructions de configuration initiale ci-dessus.

​

Champ ID externe

Il s’agit de la propriété que vous définissez sur vos utilisateurs dans votre application OneSignal qui correspond à une propriété définie dans HubSpot.

---

​

Créer des utilisateurs OneSignal depuis HubSpot

Vous pouvez créer des Users dans OneSignal au fur et à mesure qu’ils sont créés ou passent par un workflow dans HubSpot. Vous pouvez utiliser le nœud de création d’utilisateur pour vous assurer que OneSignal et HubSpot sont synchronisés. Si les propriétés HubSpot suivantes sont définies, cela créera les Subscriptions correspondantes pour cet utilisateur :

• La propriété Email de HubSpot créera un abonnement e-mail dans OneSignal pour cet utilisateur.
• La propriété Phone number de HubSpot créera un abonnement SMS dans OneSignal pour cet utilisateur.

Les enregistrements SMS enverront un message d’opt-in si votre application OneSignal a activé le Double Opt-in. Vous pouvez désactiver l’envoi automatique du message d’opt-in dans le nœud Create User de HubSpot. Cela signifie qu’un enregistrement SMS sera créé dans OneSignal, mais pas abonné aux messages SMS, et aucun message d’opt-in ne sera envoyé à cet utilisateur. Vous pouvez définir l’ID externe et les tags dans le nœud Create User, de manière très similaire au nœud Edit Tags.

---

​

Modifier les tags OneSignal depuis HubSpot

OneSignal utilise les Tags pour ajouter des propriétés personnalisées aux utilisateurs. Les tags peuvent être utilisés pour ajouter des propriétés de contact HubSpot dans OneSignal pour la Personnalisation des messages et/ou la Segmentation, qui peut être utilisée pour de nombreuses choses, y compris l’envoi de messages intégrés.

​

Champ Tags

Entrez une chaîne JSON avec le format { "key1" : "value1", "key2" : "value2" } et appuyez sur Save. Vous pouvez injecter des propriétés HubSpot en tant que tags afin qu’elles soient stockées dans OneSignal. Un exemple de ceci est l’ajout du nom de l’utilisateur en tant que tag afin que vous puissiez vous adresser à l’utilisateur par son nom dans ses messages. Vous pouvez supprimer des tags en définissant la "value" sur une chaîne vide comme ceci : { "key" : "" }. Ceci est utile si vous avez des données de tag dans OneSignal que vous souhaitez supprimer. Si le tag n’existe pas, il sera omis.

---

​

Envoyer une notification OneSignal

Vous pouvez envoyer une notification push en remplissant le formulaire fourni ou en sélectionnant des Templates prédéfinis pour pouvoir envoyer des e-mails ou des SMS. Il est recommandé de Match by OneSignal external_id car la correspondance par e-mail est destinée aux clients historiques ou si vous définissez l’e-mail en utilisant notre méthode SDK addEmail. Vous aurez ensuite la possibilité d’envoyer un message en utilisant un modèle ou en définissant une notification push directement dans le workflow.

​

Option Templates

Vous pouvez créer des Templates dans le tableau de bord OneSignal ou notre API. En utilisant des modèles, vous pouvez envoyer des SMS, des e-mails ou des notifications push.

​

Option Champs de formulaire

Si vous n’utilisez pas de modèle, vous ne pouvez envoyer que des notifications push en utilisant du texte dans divers champs (Titre, Sous-titre, Message, URL d’image, URL de lancement). Les e-mails et les SMS ne peuvent être utilisés que via des modèles. L’avantage de cette option est que vous pouvez également utiliser les données de contact HubSpot (par exemple, First Name, favorite color) pour personnaliser les champs de notification. OneSignal formatera correctement le message pour différents appareils et canaux de messagerie. Cliquez sur Save lorsque vous avez terminé.

---

​

FAQ

​

Quelles données sont partagées entre HubSpot et OneSignal ?

​

Comment puis-je envoyer des messages intégrés avec HubSpot ?

Dans le tableau de bord OneSignal Audience, sélectionnez New Segment. Donnez-lui un nom basé sur les tags sélectionnés et sélectionnez le filtre User Tag. Entrez la "key" et la "value" définies dans HubSpot et cliquez sur Create Segment. Accédez à Messages > In-App et sélectionnez New In-App. Nommez votre nouveau IAM afin de pouvoir l’identifier dans le tableau de bord. Sous “1. Audience”, sélectionnez Show to Particular Segment(s) et sélectionnez votre segment nouvellement créé. Au fur et à mesure que les utilisateurs passent par le workflow HubSpot, ils seront tagués, ce qui les placera immédiatement dans ce segment. Remarque : obtenir un tag ne déclenche pas l’IAM. Plus de détails ci-dessous dans Options de déclenchement. Pour “2. Message”, suivez le Guide d’envoi de messages intégrés pour plus de détails sur la création de votre message intégré.

​

Options de déclenchement

Les messages intégrés doivent être déclenchés pour s’afficher sur l’appareil. Les déclencheurs peuvent être basés sur le temps ou programmés. Remarque : un tag n’est pas un déclencheur. Si le tag est ajouté pendant que l’appareil utilise actuellement l’application, l’IAM ne s’affichera pas. Le message intégré s’affichera la prochaine fois que l’utilisateur reviendra sur votre application dans une nouvelle session. Les nouvelles sessions sont comptées lorsque l’application est hors de focus pendant 30 secondes. Sous “3. Triggers”, vous pouvez configurer l’IAM pour qu’il s’affiche en fonction des déclencheurs suivants :

• À l’ouverture de l’application
• Durée de session > ou < un nombre de secondes défini
• Durée depuis qu’un autre IAM a été affiché
• Par programmation avec le SDK OneSignal

Les déclencheurs peuvent être combinés avec des opérateurs “AND” et séparés en plusieurs options avec des opérateurs “OR”. Consultez le guide Comment déclencher un IAM pour plus de détails.

---