# Enregistrer les appareils dans Pushwoosh et synchroniser les données avec la plateforme

Pour cibler et engager efficacement les utilisateurs via Pushwoosh, il est crucial de s'assurer que les appareils des utilisateurs sont correctement enregistrés et que vos données sont synchronisées. Il existe plusieurs méthodes pour enregistrer les appareils et synchroniser les données avec Pushwoosh, en fonction de vos besoins spécifiques.

## SDK Pushwoosh

### Mobile

Pour les applications mobiles, l'intégration du SDK Pushwoosh est la méthode recommandée pour un enregistrement transparent des appareils et une synchronisation des données entre l'application, les systèmes Pushwoosh et, éventuellement, les systèmes tiers que les clients peuvent utiliser pour des pipelines de données ou des flux de travail spécifiques.

En intégrant le SDK, vous pouvez automatiser le processus d'enregistrement des appareils et de gestion de leurs jetons push. Le SDK appelle en interne la méthode de l'API registerDevice, garantissant que chaque appareil est enregistré et synchronisé avec Pushwoosh sans nécessiter d'intervention manuelle.

De plus, le SDK Pushwoosh permet d'enregistrer des numéros de téléphone pour les notifications SMS et WhatsApp. Vous pouvez utiliser les méthodes suivantes :

#### Enregistrer un numéro SMS

##### iOS

```
- (void)registerSmsNumber:(NSString * _Nonnull)number;
```

**Exemple**

```
Pushwoosh.sharedInstance().registerSmsNumber(@"+0000000000");
```

Remplacez `+0000000000` par le numéro de téléphone réel au **format E.164** (incluant le signe « + » et l'indicatif du pays).

##### Android

```
Pushwoosh.getInstance().registerSmsNumber(String number);
```

**Exemple**

```
Pushwoosh.getInstance().registerSmsNumber("+0000000000");
```

Remplacez `+0000000000` par le numéro de téléphone réel de l'utilisateur au format E.164, incluant le « + » et l'indicatif du pays.

#### Enregistrer un numéro WhatsApp

##### iOS

```
- (void)registerWhatsappNumber:(NSString * _Nonnull)number;
```

**Exemple**

```
Pushwoosh.sharedInstance().registerWhatsappNumber(@"+0000000000");
```

Remplacez `+0000000000` par le numéro de téléphone réel au **format E.164** (incluant le signe « + » et l'indicatif du pays).

##### Android

Pour enregistrer le numéro de téléphone d'un utilisateur pour WhatsApp sur Android, utilisez la méthode suivante :

```
Pushwoosh.getInstance().registerWhatsappNumber(String number);
```

**Exemple**

```
Pushwoosh.getInstance().registerWhatsappNumber("+0000000000");
```

Remplacez `+0000000000` par le numéro de téléphone réel de l'utilisateur au format E.164, incluant le « + » et l'indicatif du pays.

### Web

Pour enregistrer les appareils pour les notifications push web, utilisez le [SDK Web Push](/fr/developer/pushwoosh-sdk/web-push-notifications/web-push-sdk-30/).

<Aside type="tip">
Pour permettre aux visiteurs de votre site web de s'inscrire aux notifications push, configurez une [invite d'abonnement](/fr/developer/guides/messaging-channels/subscription-prompt/) personnalisée ou par défaut sur votre site. Cette invite déclenche la demande d'abonnement native du navigateur, où les utilisateurs peuvent choisir d'activer ou de bloquer les notifications push web pour votre site.
</Aside>
<video src="/start-with-your-project-subscribe-users-1.webm" title="Exemple d'invite d'abonnement push web montrant la demande d'autorisation de notification du navigateur" autoplay loop muted playsinline />

[En savoir plus sur le SDK Pushwoosh](/fr/developer/pushwoosh-sdk/pushwoosh-sdk-overview)

## API Pushwoosh

Vous pouvez également utiliser l'**API Pushwoosh** pour enregistrer les appareils et synchroniser les données. L'API offre une flexibilité totale pour des scénarios plus avancés.

### Mobile

Pour enregistrer les appareils mobiles, utilisez la méthode de l'API [`registerDevice`](/fr/developer/api-reference/device-api/#registerdevice).

### E-mail

Pushwoosh fournit des formulaires d'abonnement intégrés que vous pouvez intégrer à votre site web pour collecter les inscriptions par e-mail. Apprenez comment [créer et intégrer un formulaire](/fr/product/audience-data-and-segmentation/subscription-forms/create-subscription-forms/#how-to-build-a-form) et [personnaliser le widget](/fr/product/audience-data-and-segmentation/subscription-forms/customize-widget/#customize-colors).

Après avoir collecté les e-mails, utilisez la méthode de l'API [`registerEmail`](/fr/developer/api-reference/email-api#registeremail) pour enregistrer les appareils de type e-mail. Alternativement, vous pouvez utiliser [`registerDevice`](/fr/developer/api-reference/device-api#registerdevice).

<Aside type="note">
Veuillez noter que la requête [`registerEmailUser`](/fr/developer/api-reference/email-api#registeremailuser) n'enregistre pas une adresse e-mail dans votre base d'utilisateurs ; elle ne doit être utilisée que pour attribuer des ID utilisateur aux e-mails déjà enregistrés par l'appel registerEmail.
</Aside>

Pour associer les utilisateurs de votre application ou les visiteurs de votre site à leurs adresses e-mail, utilisez les [ID utilisateur](/fr/developer/pushwoosh-knowledge-hub/users-userids/users-userids). Cela vous permet de créer des Customer Journeys cross-canal et d'envoyer des e-mails en fonction des actions de l'utilisateur dans votre application ou sur le site web. L'ID utilisateur vous permettra également de consulter l'historique des messages et des événements de l'utilisateur dans l'User Explorer.

**1. Obtenez l'ID utilisateur.**

Chaque appareil enregistré pour votre projet Pushwoosh a son ID utilisateur ; par défaut, il est égal à l'ID matériel de l'appareil (HWID) et est récupéré par la requête API [`registerDevice`](/fr/developer/api-reference/device-api#registerdevice).

Pour définir un ID utilisateur personnalisé, appelez la méthode [`registerUser`](/fr/developer/api-reference/user-centric-api#registeruser).

**2. Attribuez l'ID utilisateur à une adresse e-mail.**

Utilisez la méthode de l'API [`registerEmail`](/fr/developer/api-reference/email-api#registeremail) ou [`registerEmailUser`](/fr/developer/api-reference/email-api#registeremailuser) pour associer l'ID utilisateur à une adresse e-mail.

[En savoir plus sur les ID utilisateur](/fr/developer/pushwoosh-knowledge-hub/users-userids/users-userids)

### SMS

Pour enregistrer des appareils SMS dans Pushwoosh, vous pouvez utiliser soit la méthode de l'API [`registerDevice`](/fr/developer/api-reference/device-api#registerdevice), soit la méthode de l'API [`createSMSMessage`](/fr/developer/api-reference/sms#createsmsmessage). En utilisant cette dernière, assurez-vous de définir le paramètre `use_auto_registration` sur `true` afin d'enregistrer automatiquement le numéro de téléphone en tant qu'appareil SMS. [En savoir plus](/fr/developer/api-reference/sms#createsmsmessage)

### WhatsApp

Pour enregistrer des appareils WhatsApp dans Pushwoosh, vous pouvez utiliser soit la méthode de l'API [`registerDevice`](/fr/developer/api-reference/device-api#registerdevice), soit la méthode de l'API [`createWhatsAppMessage`](/fr/developer/api-reference/whatsapp). En utilisant cette dernière, assurez-vous de définir le paramètre `use_auto_registration` sur `true` afin d'enregistrer automatiquement le numéro de téléphone en tant qu'appareil WhatsApp.

## Importer votre base d'utilisateurs existante

Si vous travaillez avec de grands ensembles de données préexistantes, vous pouvez importer ces données dans Pushwoosh.

### Mobile

Pour migrer votre base d'abonnés push mobiles, veuillez nous contacter via le [formulaire de contact](https://help.pushwoosh.com/hc/en-us/requests/new) et fournir un échantillon de votre base d'utilisateurs. Notre équipe examinera le format des données et évaluera si la migration est réalisable.

### Web

Les utilisateurs web ne peuvent pas être importés en raison de limitations techniques. Les différents fournisseurs de notifications push utilisent des formats de charge utile et des configurations de plateforme variés, ce qui rend l'importation des utilisateurs web inefficace. Par conséquent, la base d'utilisateurs importée serait soit invalidée, soit recevrait un contenu incorrect ou vide.

Cependant, les utilisateurs web qui ont déjà donné leur permission pour recevoir des notifications push pour votre site web peuvent être réabonnés. [En savoir plus](https://help.pushwoosh.com/hc/en-us/articles/360018326111-Migrate-your-userbase-to-Pushwoosh/?utm_content=docs&utm_term=post&utm_campaign=migrate-your-userbase-to-pushwoosh)

### E-mail

Pour [importer votre base de données d'abonnés par e-mail](/fr/product/messaging-channels/emails/get-email-subscribers/#import-email-list), téléchargez un fichier **.csv** avec les adresses e-mail. Les e-mails importés seront enregistrés en tant qu'abonnés sur la plateforme de messagerie. Vous pouvez également soumettre des données supplémentaires pour chaque adresse e-mail, telles que le nom, le sexe ou l'emplacement du destinataire, pour mieux segmenter et personnaliser vos communications par e-mail.

[Importer des e-mails](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-emails)

### SMS

Importez un fichier **.csv** avec les numéros de téléphone des abonnés SMS. Vous pouvez fournir des données supplémentaires, telles que le nom, le sexe ou l'emplacement du destinataire, pour segmenter et personnaliser davantage vos communications SMS.

[Importer des contacts SMS](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-sms)

### WhatsApp

Pour importer vos contacts WhatsApp, téléchargez un fichier .csv avec les contacts WhatsApp. Vous pouvez également fournir des détails supplémentaires, tels que le nom, le sexe ou l'emplacement du destinataire, pour personnaliser vos messages WhatsApp.

[Importer des contacts WhatsApp](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-whatsapp)

### Viber

Pour importer vos contacts Viber, téléchargez un fichier .csv avec les contacts Viber. Vous pouvez également fournir des détails supplémentaires, tels que le nom, le sexe ou l'emplacement du destinataire, pour personnaliser vos messages Viber.

[Importer des contacts Viber](https://app.pushwoosh.com/applications/AEE06-2F522/import-csv/import-viber)

## Utiliser des intégrations tierces pour transférer des données

En plus du SDK et de l'API, Pushwoosh propose plusieurs intégrations tierces pour vous aider à synchroniser et à transférer des données depuis d'autres plateformes, facilitant ainsi la gestion des utilisateurs et des données sur plusieurs systèmes.

[Découvrez toutes les intégrations disponibles](/fr/product/integrations/)