> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Développeurs

> Guide du développeur pour intégrer OneSignal : configuration du SDK, référence API, identité des utilisateurs et tests sur mobile et web.

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**](#get-started) — accédez à votre App OneSignal et trouvez vos clés API
2. [**Configurer les canaux de messagerie**](#set-up-messaging-channels) — installez le SDK et configurez les canaux
3. [**Référence SDK et API**](#sdk-and-api-reference) — documentation détaillée des méthodes, classes et endpoints
4. [**Utilisateurs et identité**](#users-and-identity) — identifiez les Utilisateurs, gérez les Abonnements et sécurisez l'accès
5. [**Tutoriels**](#tutorials) — guides étape par étape pour les cas d'utilisation courants
6. [**Tests et débogage**](#testing-and-debugging) — vérifiez votre intégration avant le lancement
7. [**Analytiques et webhooks**](#analytics-and-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](./manage-team-members) dans l'Organisation. Sinon, [créez un compte](https://onesignal.com) 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.

<Columns cols={2}>
  <Card title="Apps, Organisations et comptes" icon="building" href="./apps-organizations">
    Comment les Apps, Organisations et comptes sont liés entre eux.
  </Card>

  <Card title="Clés et ID" icon="key" href="./keys-and-ids">
    Trouvez votre App ID, clé API REST et Organization ID pour l'authentification.
  </Card>

  <Card title="Ajouter des membres d'équipe" icon="user-plus" href="./manage-team-members">
    Invitez des développeurs et attribuez des rôles au sein de votre Organisation.
  </Card>

  <Card title="Utilisation et facturation" icon="credit-card" href="./billing-faq">
    Facturation, factures et détails d'utilisation.
  </Card>
</Columns>

***

## 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.

<Columns cols={3}>
  <Card title="Configuration du SDK mobile" icon="mobile" href="./mobile-sdk-setup">
    Configuration du SDK pour iOS, Android, Huawei et Amazon. Active les notifications push, les messages in-app et les Live Activities.
  </Card>

  <Card title="Push web" icon="globe" href="./web-sdk-setup">
    Installation du Web SDK et configuration des notifications push du navigateur.
  </Card>

  <Card title="Email" icon="envelope" href="./email-setup">
    Configuration du canal email et vérification du domaine d'expéditeur.
  </Card>

  <Card title="Messages in-app" icon="window-maximize" href="./in-app-messages-setup">
    Affichez des messages riches et interactifs dans votre application mobile.
  </Card>

  <Card title="SMS" icon="comment-sms" href="./sms-messaging">
    Configuration du canal SMS et enregistrement auprès des opérateurs.
  </Card>

  <Card title="RCS" icon="message" href="./rcs-messaging">
    Messagerie enrichie avec contenu de marque et confirmations de lecture.
  </Card>

  <Card title="Live Activities" icon="tower-broadcast" href="./live-activities">
    Mises à jour dynamiques de l'écran de verrouillage iOS. Fonctionnalités similaires disponibles pour Android.
  </Card>
</Columns>

***

## Référence SDK et API

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

<Columns cols={2}>
  <Card title="Référence SDK mobile" icon="mobile" href="./mobile-sdk-reference">
    Méthodes, classes et hooks d'événements pour les SDK iOS, Android et multiplateformes.
  </Card>

  <Card title="Référence SDK web" icon="globe" href="./web-sdk-reference">
    Initialisation, gestion des Utilisateurs, méthodes d'Abonnement et déclencheurs personnalisés.
  </Card>

  <Card title="Référence SDK serveur" icon="server" href="./server-sdk-reference">
    Installez et configurez les SDK serveurs pour Node.js, Python, Java, Go, PHP, Ruby, C# et Rust.
  </Card>

  <Card title="Présentation de l'API REST" icon="code" href="/reference/rest-api-overview">
    Endpoints, authentification, limites de débit et formats de requête/réponse.
  </Card>

  <Card title="Messages transactionnels" icon="paper-plane" href="./transactional-messages">
    Envoyez des OTP, reçus et alertes urgentes via API avec des données personnalisées.
  </Card>

  <Card title="SDK serveurs sur GitHub" icon="github" href="https://github.com/OneSignal/sdks#server-sdks">
    Code source et exemples pour toutes les bibliothèques de SDK serveur.
  </Card>
</Columns>

***

## 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.

<Columns cols={2}>
  <Card title="Utilisateurs" icon="users" href="./users">
    Modèle d'Utilisateur, External ID, Utilisateurs anonymes vs. identifiés, et login/logout.
  </Card>

  <Card title="Abonnements" icon="address-book" href="./subscriptions">
    Appareils, adresses email et numéros de téléphone qui reçoivent vos messages.
  </Card>

  <Card title="Vérification d'identité" icon="shield-halved" href="./identity-verification">
    Exige des JWT générés par le serveur pour prévenir l'usurpation d'identité des Utilisateurs.
  </Card>

  <Card title="Alias" icon="fingerprint" href="./aliases">
    Mappez des identifiants personnalisés aux Utilisateurs pour le suivi multiplateforme et les intégrations.
  </Card>

  <Card title="Balises" icon="tags" href="./add-user-data-tags">
    Définissez des données clé-valeur sur les Utilisateurs pour la personnalisation et la segmentation.
  </Card>

  <Card title="Événements personnalisés" icon="bolt" href="./custom-events">
    Suivez les actions des Utilisateurs pour déclencher des Journeys ou alimenter les analyses.
  </Card>
</Columns>

***

## Tutoriels

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

<Card title="Tutoriels et cas d'utilisation" icon="graduation-cap" href="./tutorials">
  Parcourez les guides d'implémentation pour les paniers abandonnés, les flux d'intégration, les campagnes de réengagement et plus encore.
</Card>

***

## Tests et débogage

Vérifiez que votre intégration fonctionne avant d'envoyer à toute votre audience.

<Tip>
  Testez toujours en premier avec des [Abonnements de test](./test-users). Cela vous permet de vérifier la livraison, le rendu et les deep links sans affecter les vrais Utilisateurs.
</Tip>

<Columns cols={2}>
  <Card title="Abonnements de test" icon="vial" href="./test-users">
    Trouvez et configurez des Abonnements de test pour push, email et SMS.
  </Card>

  <Card title="Journaux de débogage" icon="bug" href="./capturing-a-debug-log">
    Capturez des journaux SDK détaillés depuis les applications mobiles pour le dépannage.
  </Card>

  <Card title="Dépannage mobile" icon="mobile" href="./mobile-troubleshooting">
    Résolvez les problèmes courants de livraison push, APNS et messagerie in-app.
  </Card>

  <Card title="Dépannage web" icon="globe" href="./troubleshooting-web-push">
    Corrigez les problèmes de service worker, de compatibilité navigateur et de push web.
  </Card>
</Columns>

***

## 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.

<Columns cols={2}>
  <Card title="Event Streams" icon="signal-stream" href="./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.
  </Card>

  <Card title="Webhooks de Journey" icon="route" href="./journeys-webhook">
    Envoyez des requêtes HTTP à votre serveur depuis les étapes du Journey.
  </Card>

  <Card title="Webhooks push web" icon="link" href="./webhooks">
    Callbacks HTTP pour les événements d'affichage, de clic et de fermeture du push web.
  </Card>
</Columns>

***

## 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](./keys-and-ids) 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](./users#external-id) 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é](./identity-verification) 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é.

***

<Info>
  Besoin d'aide ?

  Discutez avec notre équipe d'assistance ou envoyez un e-mail à `support@onesignal.com`

  Veuillez 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](/docs/en/capturing-a-debug-log) pertinents

  Nous serons ravis de vous aider !
</Info>