Passer au contenu principal
Connecter OneSignal à vos systèmes internes comme un entrepôt de données, un CRM ou une plateforme de gestion de données (DMP) déverrouille des capacités puissantes pour une messagerie en temps réel, personnalisée et évolutive. Que vous utilisiez Salesforce, un système utilisateur personnalisé ou une autre plateforme, l’intégration vous permet de :
  • Envoyer des messages personnalisés et urgents en utilisant des données en direct
  • Synchroniser les attributs utilisateur et les données de message entre les systèmes
  • Déclencher des Journeys automatisés à partir des actions des utilisateurs dans votre système
  • Utiliser votre système interne comme source de vérité tout en exploitant l’infrastructure de messagerie de OneSignal
Diagramme montrant le flux de données entre une base de données et OneSignal

​
Guide d’intégration

OneSignal dispose d’intégrations directes avec de nombreuses plateformes populaires. Consultez la page des intégrations pour voir si votre plateforme est prise en charge — si c’est le cas, suivez plutôt ce guide de configuration.

Intégrations

Parcourez toutes les intégrations OneSignal disponibles avec les CRM, les entrepôts de données, les outils d’analyse, etc.
Si votre plateforme n’est pas répertoriée, suivez les étapes ci-dessous pour l’intégrer via l’API REST OneSignal.

​
Étape 1 : Identifier les utilisateurs avec External ID

L’external_id de OneSignal est le lien clé entre OneSignal et votre base de données. Définissez l’external_id de chaque utilisateur dans OneSignal pour qu’il corresponde à leur ID utilisateur dans votre base de données. Cela vous permet de cibler des utilisateurs, de synchroniser des données et de déclencher des messages en utilisant des identifiants que vous avez déjà. Si vous utilisez plusieurs applications OneSignal (par ex., des applications séparées pour iOS, Android et web), définir le même external_id sur toutes les applications identifie le même utilisateur sur toutes les plateformes. Si vous avez des utilisateurs anonymes ou n’avez pas d’ID utilisateur stable pour suivre les utilisateurs entre les systèmes, vous pouvez utiliser l’onesignal_id ou le subscription_id de OneSignal. Cependant, nous recommandons de définir un external_id lorsque l’utilisateur est stable et identifiable. L’onesignal_id et/ou le subscription_id est disponible dans la réponse de l’API Create user et via nos SDK mobiles et web en utilisant les méthodes Observer.

​
Configuration API uniquement

Si vous n’utilisez OneSignal que pour les e-mails et les SMS/RCS (sans applications mobiles ni sites web), vous pouvez gérer les utilisateurs entièrement via l’API REST :
  • Create user — Créez un utilisateur avec un external_id, une adresse e-mail et/ou un numéro de téléphone
  • Update user — Mettez à jour les propriétés utilisateur et les abonnements
Aucune installation de SDK n’est requise. Votre backend envoie les données utilisateur directement à OneSignal. Configuration avec SDK Si vous avez des applications mobiles ou des sites web, utilisez les SDK frontend de OneSignal pour capturer les tokens de notification push et définir l’external_id :
  1. Installez le SDK OneSignal pour votre plateforme.
  2. Appelez login avec l’external_id de l’utilisateur après son authentification dans votre application.
  3. Le SDK capture automatiquement le token push et le lie à l’utilisateur.

​
Étape 2 : Synchroniser les données utilisateur et les événements

Une fois l’identité utilisateur configurée, vous pouvez synchroniser deux types de données depuis votre système vers OneSignal : Balises — propriétés utilisateur persistantes Les balises stockent les attributs utilisateur dans OneSignal pour la segmentation et la personnalisation des messages. Utilisez-les pour les données qui décrivent qui est un utilisateur, comme le type d’abonnement, la langue préférée ou la date d’inscription. Événements personnalisés — actions des utilisateurs Les Événements personnalisés représentent des actions effectuées par un utilisateur, comme completed_purchase, viewed_page ou subscription_expired. Utilisez-les pour déclencher des Journeys automatisés.
  • Envoyez des événements personnalisés via notre API ou nos SDK frontend
  • Les événements personnalisés ne sont pas persistants comme les balises, mais peuvent être utilisés pour déclencher des Journeys et la personnalisation des messages

​
Étape 3 : Exporter les données de messages et d’engagement

Pour synchroniser les données de livraison et d’engagement vers vos systèmes :
  • Event Streams — (Recommandé) Livraison de webhooks en temps réel des événements de messages (envoyé, livré, cliqué, etc.). Idéal pour maintenir votre base de données synchronisée à mesure que les événements se produisent.
  • Export subscriptions CSV — Exportation en masse des données d’abonnement pour les synchronisations périodiques ou les migrations.
  • View messages API — Interrogez l’historique des messages et les statistiques de livraison par programmation.

​
Recommandations d’architecture

  • Conservez votre base de données comme source de vérité. Traitez OneSignal comme la couche de messagerie — envoyez les données utilisateur et les événements à OneSignal, et récupérez les données de livraison/engagement.
  • Utilisez l’API pour les mises à jour en temps réel. Lorsqu’un utilisateur effectue une action (par ex., finalise un achat), appelez immédiatement l’API OneSignal pour mettre à jour les balises ou envoyer un événement personnalisé.
  • Utilisez l’importation CSV pour les opérations en masse. Pour l’intégration initiale ou les grandes migrations, utilisez l’importation CSV plutôt que de faire des milliers d’appels API individuels.
  • Respectez les limites de débit. Pour les mises à jour à volume élevé, regroupez les requêtes dans la mesure du possible et implémentez une logique de réessai avec backoff exponentiel.
  • Utilisez Event Streams pour le chemin de retour. Plutôt que d’interroger l’API OneSignal pour les données de livraison, configurez Event Streams pour recevoir des webhooks en temps réel pour les événements de messages.

​
Déclencher des messages depuis votre base de données

Vous pouvez déclencher des messages en utilisant deux approches — choisissez l’une ou les deux en fonction de votre cas d’utilisation.
Utilisez l’API Create message pour une messagerie transactionnelle immédiate.Ciblez les utilisateurs via :
  • external_id
  • Alias (par ex., crm_id)
  • E-mail ou numéro de téléphone
Idéal pour :
  • Messages transactionnels (par ex., reçus, alertes)
  • Notifications urgentes ou personnalisées
  • Ciblage d’individus ou de groupes (jusqu’à 20 000 utilisateurs par appel)
Vous pouvez également planifier des messages en utilisant le paramètre send_after.

​
FAQ

​
Dois-je utiliser l’API ou Journeys pour envoyer des messages depuis ma base de données ?

Utilisez l’API Create message pour les messages transactionnels immédiats comme les reçus ou les alertes. Utilisez Journeys avec des balises ou des Événements personnalisés pour les messages de cycle de vie et marketing automatisés qui bénéficient d’une création visuelle de flux de travail.

​
Quelles données dois-je stocker dans OneSignal vs. dans mon propre système ?

Décidez en fonction de l’objectif des données : Ce qu’il faut stocker dans OneSignal
  • Stockez les données utilisées directement pour la messagerie :
    • external_id et alias
    • E-mails (pour la messagerie e-mail)
    • Numéros de téléphone (pour SMS)
    • Attributs utilisateur légers sous forme de balises
    • Événements clés pour lesquels vous souhaitez envoyer des messages sous forme d’Événements personnalisés
OneSignal prend en charge plusieurs façons de personnaliser les messages détaillées dans Personnalisation des messages.
Ce qu’il faut garder dans vos propres systèmes
  • Gardez les données non liées à la messagerie (par ex., profils utilisateur complets, journaux de transactions) dans vos propres systèmes pour les performances, la confidentialité et le contrôle. Archivez l’historique des messages depuis OneSignal pour des analyses à long terme ou la conformité.

​
Puis-je envoyer des messages à des utilisateurs qui n’ont pas d’External ID ?

Oui, mais cela nécessite une gestion supplémentaire. Vous pouvez utiliser l’onesignal_id ou le subscription_id de OneSignal, mais ceux-ci sont anonymes jusqu’à ce qu’ils soient liés à un external_id. Nous recommandons de définir un external_id pour chaque utilisateur afin de simplifier l’identification inter-systèmes.

​
Quelle est la différence entre les balises et les événements personnalisés ?

Les balises sont des propriétés utilisateur persistantes (par ex., type d’abonnement, préférence de langue) utilisées pour la segmentation et la personnalisation. Les Événements personnalisés représentent des actions ponctuelles des utilisateurs (par ex., completed_purchase) utilisées pour déclencher des Journeys. Les balises décrivent qui est un utilisateur ; les événements personnalisés décrivent ce qu’un utilisateur a fait.

Utilisateurs

Comprenez le modèle utilisateur de OneSignal et comment les identités sont structurées.

Événements personnalisés

Envoyez des événements depuis vos systèmes pour déclencher des Journeys et suivre le comportement des utilisateurs.

Personnalisation des messages

Personnalisez les messages avec des balises, des données personnalisées et du contenu dynamique.

Journeys

Créez des flux de travail de messagerie automatisés déclenchés par le comportement et les données des utilisateurs.