Passer au contenu principal
Ce guide aide les développeurs à intégrer OneSignal dans des applications mobiles et web. Suivez les sections dans l’ordre pour une première configuration ou accédez directement à la section dont vous avez besoin.
  1. Premiers pas — accédez à votre App OneSignal et trouvez vos clés API
  2. Configurer les canaux de messagerie — installez le SDK et configurez les canaux
  3. Référence SDK et API — documentation détaillée des méthodes, classes et endpoints
  4. Utilisateurs et identité — identifiez les Utilisateurs, gérez les Abonnements et sécurisez l’accès
  5. Tutoriels — guides étape par étape pour les cas d’utilisation courants
  6. Tests et débogage — vérifiez votre intégration avant le lancement
  7. Analytiques et webhooks — suivez les performances et recevez les événements de messages côté serveur

​
Premiers pas

Si votre équipe dispose déjà d’un compte OneSignal, demandez à un administrateur de vous inviter dans l’Organisation. Sinon, créez un compte pour commencer. Votre App OneSignal est l’endroit où vivent les données des utilisateurs et des messages. Chaque App possède son propre App ID, ses clés API et ses canaux de messagerie. Vous pouvez avoir plusieurs Apps dans une seule Organisation pour différents projets ou environnements.

Apps, Organisations et comptes

Comment les Apps, Organisations et comptes sont liés entre eux.

Clés et ID

Trouvez votre App ID, clé API REST et Organization ID pour l’authentification.

Ajouter des membres d'équipe

Invitez des développeurs et attribuez des rôles au sein de votre Organisation.

Utilisation et facturation

Facturation, factures et détails d’utilisation.

​
Configurer les canaux de messagerie

Installez le SDK OneSignal pour créer et suivre l’engagement des utilisateurs sur vos plateformes. Chaque canal de messagerie dispose de son propre guide de configuration couvrant les identifiants, l’initialisation du SDK et des tutoriels.

Configuration du SDK mobile

Configuration du SDK pour iOS, Android, Huawei et Amazon. Active les notifications push, les messages in-app et les Live Activities.

Push web

Installation du Web SDK et configuration des notifications push du navigateur.

Email

Configuration du canal email et vérification du domaine d’expéditeur.

Messages in-app

Affichez des messages riches et interactifs dans votre application mobile.

SMS

Configuration du canal SMS et enregistrement auprès des opérateurs.

RCS

Messagerie enrichie avec contenu de marque et confirmations de lecture.

Live Activities

Mises à jour dynamiques de l’écran de verrouillage iOS. Fonctionnalités similaires disponibles pour Android.

​
Référence SDK et API

Documentation détaillée pour les SDK clients, SDK serveurs et l’API REST.

Référence SDK mobile

Méthodes, classes et hooks d’événements pour les SDK iOS, Android et multiplateformes.

Référence SDK web

Initialisation, gestion des Utilisateurs, méthodes d’Abonnement et déclencheurs personnalisés.

Référence SDK serveur

Installez et configurez les SDK serveurs pour Node.js, Python, Java, Go, PHP, Ruby, C# et Rust.

Présentation de l'API REST

Endpoints, authentification, limites de débit et formats de requête/réponse.

Messages transactionnels

Envoyez des OTP, reçus et alertes urgentes via API avec des données personnalisées.

SDK serveurs sur GitHub

Code source et exemples pour toutes les bibliothèques de SDK serveur.

​
Utilisateurs et identité

OneSignal attribue à chaque personne un OneSignal ID et suit ses appareils, adresses email et numéros de téléphone en tant qu’Abonnements. Les Utilisateurs sont anonymes jusqu’à ce que vous appeliez login avec un External ID pour les identifier. L’identification des Utilisateurs unifie leurs Abonnements sur tous les canaux et appareils.

Utilisateurs

Modèle d’Utilisateur, External ID, Utilisateurs anonymes vs. identifiés, et login/logout.

Abonnements

Appareils, adresses email et numéros de téléphone qui reçoivent vos messages.

Vérification d'identité

Exige des JWT générés par le serveur pour prévenir l’usurpation d’identité des Utilisateurs.

Alias

Mappez des identifiants personnalisés aux Utilisateurs pour le suivi multiplateforme et les intégrations.

Balises

Définissez des données clé-valeur sur les Utilisateurs pour la personnalisation et la segmentation.

Événements personnalisés

Suivez les actions des Utilisateurs pour déclencher des Journeys ou alimenter les analyses.

​
Tutoriels

Guides étape par étape pour implémenter des cas d’utilisation courants de messagerie avec OneSignal.

Tutoriels et cas d'utilisation

Parcourez les guides d’implémentation pour les paniers abandonnés, les flux d’intégration, les campagnes de réengagement et plus encore.

​
Tests et débogage

Vérifiez que votre intégration fonctionne avant d’envoyer à toute votre audience.
Testez toujours en premier avec des Abonnements de test. Cela vous permet de vérifier la livraison, le rendu et les deep links sans affecter les vrais Utilisateurs.

Abonnements de test

Trouvez et configurez des Abonnements de test pour push, email et SMS.

Journaux de débogage

Capturez des journaux SDK détaillés depuis les applications mobiles pour le dépannage.

Dépannage mobile

Résolvez les problèmes courants de livraison push, APNS et messagerie in-app.

Dépannage web

Corrigez les problèmes de service worker, de compatibilité navigateur et de push web.

​
Analytiques et webhooks

Suivez les performances des messages et recevez des événements de messages côté serveur pour les analyses, l’automatisation ou la synchronisation avec des systèmes externes.

Event Streams

Diffusez en temps réel les clics, ouvertures, réceptions et autres événements de messages vers votre entrepôt de données.

Webhooks de Journey

Envoyez des requêtes HTTP à votre serveur depuis les étapes du Journey.

Webhooks push web

Callbacks HTTP pour les événements d’affichage, de clic et de fermeture du push web.

​
Questions fréquentes

​
Comment authentifier les requêtes à l’API REST ?

Incluez votre clé API REST dans l’en-tête Authorization en tant que token Bearer : Authorization: Key YOUR_REST_API_KEY. Trouvez votre clé dans Paramètres > Clés et ID dans le tableau de bord OneSignal. Consultez Clés et ID pour plus de détails.

​
Quelle est la différence entre les SDK clients et les SDK serveurs ?

Les SDK clients (mobile et web) s’exécutent dans votre application sur l’appareil de l’Utilisateur. Ils gèrent l’enregistrement des Abonnements, les invites de permission, les messages in-app et l’identification de l’Utilisateur via login. Les SDK serveurs s’exécutent sur votre backend et appellent l’API REST pour envoyer des messages, gérer les Utilisateurs et exporter des données.

​
Comment identifier les Utilisateurs sur plusieurs appareils ?

Appelez OneSignal.login("your_external_id") sur chaque appareil après la connexion de l’Utilisateur. OneSignal fusionne tous les Abonnements avec le même External ID sous un seul Utilisateur. Consultez Utilisateurs pour les détails d’implémentation.

​
Dois-je configurer la vérification d’identité ?

La vérification d’identité est optionnelle mais fortement recommandée pour les applications en production. Sans elle, n’importe quel client peut appeler login avec un External ID arbitraire. L’activation de la vérification d’identité nécessite de mettre à jour le SDK OneSignal pour utiliser un JWT généré par le serveur, empêchant ainsi l’usurpation d’identité.
Besoin d’aide ?Discutez avec notre équipe d’assistance ou envoyez un e-mail à support@onesignal.comVeuillez inclure :
  • Les détails du problème que vous rencontrez et les étapes de reproduction si disponibles
  • Votre OneSignal App ID
  • L’External ID ou le Subscription ID le cas échéant
  • L’URL du message que vous avez testé dans le OneSignal Dashboard le cas échéant
  • Tous les journaux ou messages d’erreur pertinents
Nous serons ravis de vous aider !