L’intégration HubSpot de OneSignal connecte votre CRM HubSpot à OneSignal via des actions de workflow natives — sans middleware tiers. Vous pouvez :
Envoyer des messages — déclencher des notifications push, des e-mails et des SMS depuis les Workflows HubSpot
Créer des utilisateurs — synchroniser les contacts HubSpot avec OneSignal avec des abonnements e-mail et SMS
Gérer les tags — définir ou supprimer des Tags OneSignal selon les propriétés de contact HubSpot
Cibler les messages in-app — utiliser les tags définis par HubSpot pour créer des segments qui contrôlent la diffusion des messages in-app
Pour des fonctionnalités comme les tests A/B, la livraison intelligente, le throttling et le reciblage, utilisez directement le tableau de bord ou l’API OneSignal en complément de HubSpot.
HubSpot a déprécié l’application OneSignal tierce d’origine en décembre 2024. OneSignal propose désormais sa propre application HubSpot avec des fonctionnalités étendues. Si vous utilisiez l’intégration précédente, consultez les étapes de migration ci-dessous.
Migration depuis l'intégration HubSpot héritée
Installer la nouvelle intégrationActivez l’intégration HubSpot depuis le tableau de bord OneSignal sous Données > Intégrations comme décrit dans Connecter HubSpot à OneSignal ci-dessous.Migrer vos workflowsNous recommandons de créer un nouveau workflow pour tester la nouvelle intégration avant de remplacer les actions dans vos workflows existants.
Cloner votre workflow — Sur la page Workflows de HubSpot, cliquez sur Cloner à côté de votre workflow existant.
Supprimer les déclencheurs — Dans le workflow cloné, supprimez tous les déclencheurs d’inscription pour qu’il ne se déclenche pas automatiquement à la publication.
Remplacer les actions héritées — Supprimez chaque action OneSignal héritée et remplacez-la par la nouvelle version. Si les deux applications sont installées, l’application héritée affiche “Built by HubSpot” — utilisez celle qui ne l’affiche pas.
Lorsque les deux applications sont installées, utilisez l'action OneSignal qui n'indique pas 'Built by HubSpot'.
Tester avec un seul contact — Enregistrez et publiez le workflow, puis inscrivez manuellement un contact de test. Vérifiez l’historique d’inscription pour confirmer que les actions se sont exécutées avec succès.
Exemple de workflow HubSpot migré.
Remplacer ou mettre à jour — Après avoir confirmé que le workflow fonctionne correctement, remplacez le workflow original par le clone ou appliquez les mêmes modifications à l’original.
Si vous rencontrez des erreurs lors de la migration, contactez support@onesignal.com.
Dans OneSignal, accédez à Données > Intégrations > Catalogue et sélectionnez HubSpot.
La carte d'intégration HubSpot sur la page Intégrations de OneSignal.
Cliquez sur Paramètres > Authentifier, puis sélectionnez votre compte HubSpot et connectez-vous.
Vous ne pouvez connecter qu’un seul compte HubSpot à chaque application OneSignal. Si vous avez un environnement de test, vous pouvez configurer une autre application OneSignal pour les tests.
Sélectionnez le compte HubSpot à connecter à cette application OneSignal.
Après avoir accepté les conditions et sélectionné Connecter l’application, vous êtes redirigé vers OneSignal. Ouvrez le compte HubSpot nouvellement connecté pour confirmer la connexion.
Pour lier les contacts HubSpot aux utilisateurs OneSignal, définissez l’External ID dans OneSignal sur une valeur correspondant à une propriété unique dans HubSpot (par exemple, un identifiant utilisateur ou une adresse e-mail).Définissez l’External ID à l’aide de la méthode login du SDK dans votre application ou site web. Choisissez une propriété facilement accessible dans votre application et dans HubSpot pour que la correspondance soit fiable.
Consultez Utilisateurs et Abonnements pour plus de détails sur la gestion des identités et des abonnements.
Dans HubSpot, accédez à Automatisation > Workflows et cliquez sur Créer un workflow. Sélectionnez Basé sur les contacts et configurez vos déclencheurs d’inscription.Pour ajouter une action OneSignal, cliquez sur + dans l’éditeur de workflow et recherchez “OneSignal.”
Actions de workflow OneSignal dans HubSpot.
Chaque action OneSignal nécessite deux champs :
Définition de l'application OneSignal et de l'External ID dans une action de workflow.
Application OneSignal — l’application que vous avez connectée lors de la configuration
External ID — la propriété de contact HubSpot correspondant à l’External ID dans OneSignal
L’action Créer un utilisateur crée un Utilisateur dans OneSignal lorsqu’un contact passe par le workflow. Utilisez-la pour maintenir la synchronisation entre OneSignal et HubSpot au fur et à mesure que de nouveaux contacts sont ajoutés.Si les propriétés HubSpot suivantes sont définies, OneSignal crée automatiquement les Abonnements correspondants :
E-mail → crée un abonnement e-mail dans OneSignal
Numéro de téléphone → crée un abonnement SMS dans OneSignal
Vous pouvez également définir l’External ID et les tags dans le nœud Créer un utilisateur.
Nœud Créer un utilisateur OneSignal dans un workflow HubSpot.
Si votre application OneSignal a le Double Opt-in activé, les nouveaux abonnements SMS reçoivent automatiquement un message d’opt-in. Vous pouvez le désactiver dans le nœud Créer un utilisateur — l’abonnement SMS sera créé mais l’utilisateur ne sera pas abonné tant qu’il n’aura pas effectué l’opt-in séparément.
{ "welcome": "1", "name": "<First Name property>" }
Vous pouvez injecter n’importe quelle propriété de contact HubSpot comme valeur de tag en utilisant l’inserteur de jetons de propriété HubSpot dans l’éditeur de workflow. Par exemple, ajouter le prénom d’un utilisateur comme tag pour personnaliser les messages dans OneSignal.
L’action Envoyer une notification envoie une notification push, un e-mail ou un SMS à l’utilisateur OneSignal correspondant.
Associez les utilisateurs par External ID OneSignal plutôt que par e-mail. L’association par e-mail est une option héritée pour les clients qui ont défini l’e-mail avec la méthode addEmail du SDK.
Configuration de l'action Envoyer une notification OneSignal.
Utiliser un modèleSélectionnez un Modèle prédéfini créé dans le tableau de bord ou l’API OneSignal. Les modèles prennent en charge les notifications push, les e-mails et les SMS.Utiliser des champs de formulaireSi vous ne sélectionnez pas de modèle, vous pouvez rédiger une notification push directement dans l’action de workflow en utilisant les champs Titre, Sous-titre, Message, URL de l’image et URL de lancement. Les e-mails et les SMS ne sont disponibles que via des modèles.L’option des champs de formulaire vous permet d’injecter des propriétés de contact HubSpot (par exemple, Prénom) pour personnaliser le contenu de la notification.
Les messages in-app ne peuvent pas être envoyés directement depuis un workflow HubSpot. Utilisez plutôt HubSpot pour taguer les utilisateurs, puis ciblez ces utilisateurs avec un message in-app basé sur un segment dans OneSignal.
1
Taguer les utilisateurs depuis HubSpot
Dans votre workflow HubSpot, utilisez l’action Modifier les tags pour définir un tag sur les contacts. Par exemple : { "hubspot_campaign": "spring_promo" }.
2
Créer un segment dans OneSignal
Dans le tableau de bord OneSignal, accédez à Audience > Segments et cliquez sur Nouveau segment. Ajoutez un filtre Tag utilisateur correspondant à la clé et à la valeur du tag défini par HubSpot (par exemple, hubspot_campaign est spring_promo).
3
Créer le message in-app
Accédez à Messages > In-App et créez un nouveau message in-app. Sous Audience, sélectionnez Afficher à des segments spécifiques et choisissez le segment que vous avez créé.Au fur et à mesure que les utilisateurs passent par le workflow HubSpot et reçoivent le tag, ils sont immédiatement ajoutés au segment.
4
Configurer le déclencheur
Les tags seuls ne déclenchent pas de messages in-app. Si le tag est défini pendant que l’utilisateur utilise activement l’application, le message in-app ne s’affichera pas avant la prochaine session (une nouvelle session commence après que l’application est en arrière-plan pendant 30+ secondes).Déclencheurs disponibles :
À l’ouverture de l’application — s’affiche la prochaine fois que l’utilisateur ouvre l’application
Durée de la session — s’affiche après un nombre défini de secondes en session
Temps depuis le dernier message in-app — évite les messages consécutifs
Programmatique — déclencher depuis le code de votre application via le SDK OneSignal
Consultez Déclencheurs de messages in-app pour plus de détails sur la combinaison de déclencheurs avec des opérateurs AND/OR.
Les workflows HubSpot combinent des déclencheurs d’inscription (l’événement qui démarre le workflow) avec des actions OneSignal (ce qui se passe pour l’utilisateur dans OneSignal). Voici les modèles recommandés pour les cas d’usage courants.
Envoyez un message de bienvenue lorsqu’un nouvel utilisateur s’inscrit et taguez-le pour les messages in-app d’intégration.
Étape
Type
Configuration
Déclencheur d’inscription
HubSpot
La propriété de contact Date de devenir client est connue
Action 1
OneSignal : Créer un utilisateur
Définissez l’External ID sur la propriété de contact HubSpot correspondant à votre application (par exemple, un identifiant utilisateur ou une adresse e-mail)
Action 2
OneSignal : Modifier les tags
{ "onboarding": "active", "name": "<First Name>" } — insérez le jeton de propriété Prénom de HubSpot pour la valeur du nom
Action 3
OneSignal : Envoyer une notification
Utilisez un modèle de push de bienvenue ou rédigez en ligne avec un message personnalisé
Combinez cela avec un message in-app ciblant le segment onboarding = active pour guider les nouveaux utilisateurs dans votre application au premier lancement.
Déclenchez un message de remerciement et taguez les utilisateurs pour des campagnes d’upsell après la conclusion d’une affaire.
Étape
Type
Configuration
Déclencheur d’inscription
HubSpot
La propriété d’affaire Étape de l'affaire = Conclue gagnée
Action 1
OneSignal : Modifier les tags
{ "customer": "true", "deal_value": "<Amount>" } — insérez le jeton de propriété Montant de l’affaire de HubSpot pour la valeur
Action 2
OneSignal : Envoyer une notification
Utilisez un modèle d’e-mail de remerciement
Délai
HubSpot : Attendre 7 jours
—
Action 3
OneSignal : Envoyer une notification
Utilisez un modèle de push d’upsell/cross-sell
Les workflows basés sur les affaires nécessitent un type de workflow Basé sur les affaires dans HubSpot. Utilisez l’External ID du contact associé pour associer l’utilisateur OneSignal.
Ciblez une audience spécifique avec un message in-app déclenché par une liste ou un formulaire HubSpot.
Étape
Type
Configuration
Déclencheur d’inscription
HubSpot
Le contact devient membre d’une liste statique ou active (par exemple, “Éligibles à la vente de printemps”)
Action 1
OneSignal : Modifier les tags
{ "promo": "spring_2025" }
Suivez ensuite les étapes de Envoyer des messages in-app avec HubSpot pour créer un segment OneSignal correspondant à promo = spring_2025 et configurer un message in-app pour ce segment.Pour retirer les utilisateurs de la campagne une fois terminée, créez un second workflow qui supprime le tag :
Étape
Type
Configuration
Déclencheur d’inscription
HubSpot
Basé sur une date, défini à la date de fin de campagne
Vérifiez le message d’erreur — Développez l’action échouée dans l’historique d’inscription du workflow HubSpot. Le message d’erreur indique souvent la cause (par exemple, “Utilisateur introuvable,” “ID d’application invalide”).
Vérifiez l’External ID — Confirmez que la propriété de contact HubSpot utilisée comme External ID correspond à un utilisateur dans OneSignal. Vérifiez le profil de l’utilisateur dans OneSignal > Audience > Utilisateurs et recherchez par External ID.
Confirmez que l’intégration est active — Accédez à OneSignal > Données > Intégrations > HubSpot et vérifiez que le statut de la connexion est actif.
Le message a été envoyé mais l’utilisateur ne l’a pas reçu
Vérifiez les abonnements — L’utilisateur doit avoir un abonnement actif pour le canal sur lequel vous envoyez (push, e-mail ou SMS). Vérifiez-le dans le profil de l’utilisateur dans OneSignal sous Abonnements.
Vérifiez l’appartenance au segment — Si vous utilisez un modèle avec ciblage par segment, confirmez que l’utilisateur appartient au segment ciblé.
Examinez les rapports de messages — Dans le tableau de bord OneSignal, accédez à Messages, trouvez le message et vérifiez son rapport de livraison pour voir si le message a été livré, abandonné ou a généré une erreur.
Les tags n’apparaissent pas sur l’utilisateur OneSignal
Vérifiez la correspondance de l’External ID — Si l’External ID dans le workflow ne correspond pas à un utilisateur OneSignal existant, l’action Modifier les tags échoue silencieusement. Utilisez l’action Créer un utilisateur avant Modifier les tags pour vous assurer que l’utilisateur existe.
Vérifiez le format JSON — Les tags doivent être un objet JSON valide. Les erreurs courantes incluent des guillemets manquants autour des clés ou des valeurs, des virgules en fin de ligne ou l’utilisation de guillemets simples au lieu de guillemets doubles.
Vérifiez les valeurs vides — Définir une valeur de tag sur "" supprime le tag. Vérifiez que les propriétés de contact HubSpot injectées ne sont pas vides.
Quelles données sont partagées entre HubSpot et OneSignal ?
HubSpot
Direction
OneSignal
Description
Propriétés de contact
→
External ID, Tags
Les données de contact HubSpot correspondent et enrichissent les utilisateurs OneSignal via External ID et Tags.
Workflows
←
Modèles de messages
Les Modèles OneSignal sont disponibles pour sélection dans les actions de workflow HubSpot.
L’intégration ne synchronise pas automatiquement les listes, les affaires ou les fiches d’entreprise HubSpot vers OneSignal. Utilisez les actions de workflow pour passer explicitement les données dont vous avez besoin.
Que se passe-t-il si l’External ID ne correspond pas à un utilisateur OneSignal ?
Les actions Envoyer une notification et Modifier les tags échouent silencieusement — aucun message n’est envoyé et aucun tag n’est défini. Placez toujours une action Créer un utilisateur avant les autres actions OneSignal dans votre workflow pour vous assurer que l’utilisateur existe dans OneSignal.
Puis-je utiliser des listes HubSpot pour cibler des segments OneSignal ?
Pas directement. Les listes HubSpot et les segments OneSignal sont des systèmes indépendants. Pour les connecter, créez un workflow qui inscrit les contacts d’une liste HubSpot et utilisez l’action Modifier les tags pour définir un tag. Créez ensuite un segment OneSignal basé sur ce tag. Consultez Campagne promotionnelle via message in-app pour un exemple concret.
Quels canaux OneSignal puis-je envoyer depuis HubSpot ?
Les notifications push peuvent être envoyées à l’aide de modèles ou de champs de formulaire. Les e-mails et les SMS ne peuvent être envoyés qu’à l’aide de Modèles créés dans OneSignal. Les messages in-app ne peuvent pas être envoyés depuis les workflows HubSpot — utilisez plutôt le modèle de tag et segment.
Pourquoi mon message in-app ne s’est-il pas affiché après la définition du tag ?
Les tags seuls ne déclenchent pas de messages in-app. Le tag ajoute l’utilisateur à un segment, mais le message in-app nécessite toujours un déclencheur pour s’afficher. Si le tag est défini pendant que l’utilisateur utilise activement l’application, le message n’apparaîtra pas avant la prochaine session (30+ secondes en arrière-plan). Définissez le déclencheur du message in-app sur À l’ouverture de l’application pour le comportement le plus fiable. Consultez Déclencheurs de messages in-app pour toutes les options de déclencheur.
Puis-je utiliser les webhooks HubSpot pour appeler directement l’API OneSignal ?
Oui. L’action de workflow Code personnalisé de HubSpot vous permet d’effectuer des requêtes HTTP vers des API externes. Vous pouvez appeler l’API REST OneSignal pour envoyer des messages, créer des utilisateurs ou mettre à jour des tags en dehors de l’intégration native. Cela est utile pour des cas d’usage que les actions natives ne couvrent pas, comme l’envoi à un segment plutôt qu’à un utilisateur individuel.
Puis-je renvoyer les événements de messages OneSignal vers HubSpot ?
Oui. Utilisez Flux d’événements pour exporter les événements de messages OneSignal (envoyés, cliqués, etc.) vers un endpoint de webhook. Vous pouvez router ces événements vers l’API des événements personnalisés de HubSpot ou utiliser un service middleware pour mettre à jour les propriétés de contact HubSpot en fonction des données d’engagement OneSignal.
Puis-je déclencher un Journey OneSignal depuis HubSpot ?
Il existe deux options pour intégrer des utilisateurs HubSpot dans un Journey OneSignal :
Tags — Utilisez l’action Modifier les tags pour définir un tag sur l’utilisateur. Créez un segment dans OneSignal basé sur ce tag et utilisez le segment comme condition d’entrée du Journey.
Événements personnalisés — Utilisez l’action Code personnalisé de HubSpot pour appeler l’API d’événements personnalisés OneSignal, qui peut servir de déclencheur d’entrée du Journey.
Puis-je envoyer des événements personnalisés de HubSpot vers OneSignal ?
Pas via les actions de workflow natives. L’intégration native prend en charge Créer un utilisateur, Modifier les tags et Envoyer une notification. Pour envoyer des événements personnalisés, utilisez l’action Code personnalisé de HubSpot pour appeler directement l’API d’événements personnalisés OneSignal.
Quels déclencheurs d’inscription HubSpot fonctionnent avec OneSignal ?
N’importe quel déclencheur d’inscription HubSpot fonctionne — les actions OneSignal sont des actions de workflow standard qui s’exécutent quelle que soit la manière dont le contact a été inscrit. Les déclencheurs courants incluent :
Changements de propriétés de contact (étape du cycle de vie, statut du prospect, date de dernière activité)
Soumissions de formulaires (formulaires d’inscription, demandes de démo, inscriptions à des événements)
Appartenance aux listes (ajouté à une liste statique ou active)
Changements d’étape d’affaire (progression du pipeline, conclue gagnée/perdue)
Basé sur une date (campagnes planifiées, temps écoulé depuis un événement)
Inscription manuelle (pour des envois uniques ou des tests)
