# Démarrer avec les passes Apple Wallet

Les passes Apple Wallet sont des cartes numériques, telles que des cartes de fidélité, des coupons, des billets d'événement, des cartes d'embarquement et des cartes de magasin, que vos utilisateurs conservent dans l'application Wallet sur iPhone et Apple Watch. Avec Pushwoosh, vous pouvez concevoir un pass visuellement dans le Control Panel, le partager, puis envoyer des mises à jour à tout moment sans demander aux utilisateurs de réinstaller quoi que ce soit.

Lorsque vous modifiez un pass, Pushwoosh notifie chaque appareil qui l'a ajouté, et iOS récupère discrètement la nouvelle version. Le code-barres, le solde, le numéro de porte ou la date d'expiration sur le téléphone de l'utilisateur se met à jour automatiquement.

## Ce que vous pouvez faire avec les passes Apple Wallet

Avec les passes Apple Wallet dans Pushwoosh, vous pouvez :

*   Concevoir des passes visuellement avec des couleurs, des champs, un logo, une image de bande et un code-barres, sans écrire `pass.json` à la main.
*   Créer des cartes de fidélité, des coupons, des billets d'événement, des cartes d'embarquement et des cartes de magasin génériques.
*   Distribuer les passes aux utilisateurs sous forme de fichier `.pkpass`, de lien d'installation ou de code QR.
*   Mettre à jour le contenu du pass et livrer les modifications aux appareils qui ont ajouté le pass.
*   Atteindre les détenteurs de pass avec une notification push unique, une mise à jour de pass ou un Customer Journey. Voir [Envoyer un message aux détenteurs de pass Apple Wallet](/fr/product/messaging-channels/apple-wallet-passes/message-pass-holders/).

## Prérequis

<Aside type="caution" icon="setting" title="Assistance d'un développeur requise">
L'émission de passes Apple Wallet nécessite un compte Apple Developer et des certificats de signature. Partagez cette section avec votre équipe de développeurs pour effectuer la configuration unique.
</Aside>

Avant de concevoir votre premier pass, confirmez les points suivants :

*   **Programme pour développeurs Apple :** Vous avez besoin d'un abonnement actif pour enregistrer les identifiants de type de pass et créer des certificats de signature. [S'inscrire ou gérer votre compte](https://developer.apple.com/programs/)
*   **Plateforme iOS :** Votre application doit avoir iOS connecté dans Pushwoosh avant de pouvoir ajouter un certificat de signature de pass. [Configurer iOS](/fr/developer/first-steps/connect-messaging-services/ios-configuration/)

## Commencer à travailler avec les passes Apple Wallet

Une fois les [prérequis](#prerequisites) en place, suivez ce processus :

<Steps>

1.  **Configurer les passes Wallet dans Pushwoosh**

    Avant de pouvoir concevoir des passes, Pushwoosh doit avoir votre certificat de signature Apple pour l'application. Votre équipe de développeurs le crée dans Apple Developer et le télécharge sur Pushwoosh. Il s'agit d'une configuration unique par application.

    [Comment configurer le certificat de signature](/fr/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2.  **Concevoir le pass**

    Dans le [constructeur de pass](/fr/product/messaging-channels/apple-wallet-passes/pass-builder/), choisissez un style de pass, définissez les champs et la marque, et vérifiez l'aperçu en direct.

3.  **Générer un `.pkpass` signé**

    Une fois que vous avez créé et validé le pass, dans le [constructeur de pass](/fr/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass), sélectionnez **Générer**. Pushwoosh prépare les images aux résolutions requises et signe le fichier avec votre certificat.

4.  **Distribuer le pass**

    Envoyez aux utilisateurs le fichier `.pkpass`, le lien d'installation ou le code QR. Voir [Partager le pass avec les utilisateurs via les canaux Pushwoosh](#share-the-pass-with-users-via-pushwoosh-channels). Lorsque les utilisateurs ajoutent le pass à Wallet, leur appareil s'enregistre pour les futures mises à jour.

5.  **Mettre à jour le contenu du pass**

    Modifiez le pass dans le constructeur de pass ou via l'API et enregistrez. Pushwoosh notifie les appareils enregistrés, et iOS télécharge la nouvelle version en arrière-plan. Les utilisateurs n'ont pas besoin de réinstaller le pass.

6.  **Envoyer un message aux détenteurs de pass**

    Une fois que les utilisateurs ont ajouté le pass à Wallet, vous pouvez les atteindre avec une notification push unique, une mise à jour de pass ou un Customer Journey automatisé.

    [Envoyer un message aux détenteurs de pass Apple Wallet](/fr/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

## Afficher et gérer les passes existants

Dans le Control Panel, allez à **Campaigns → Wallet Passes** et ouvrez l'onglet **Apple Wallet**. Le tableau **Tous les passes** répertorie chaque pass pour l'application, y compris son nom, son style, l'[User ID](/fr/product/pushwoosh-knowledge-hub/users-userids/) auquel il est associé, ainsi que la date et l'heure de sa dernière mise à jour.

Sur la liste des passes, ouvrez le menu des actions (⋮) pour :

*   **Modifier :** changer le nom et la description du pass, les valeurs et les libellés des champs, modifier les messages, les couleurs, le message du code-barres, l'expiration et le statut, ainsi que les emplacements. Le style et les images du pass restent verrouillés après la création. Lorsque vous enregistrez, chaque appareil qui a ajouté le pass reçoit la mise à jour.

<Aside type="note" title="Les mises à jour sont livrées sous forme de notifications push silencieuses">
Lorsque vous enregistrez une modification, Pushwoosh signe à nouveau le pass et notifie chaque appareil enregistré avec une notification push sans contenu. iOS récupère la nouvelle version automatiquement — aucune réinstallation n'est requise.
</Aside>

*   **Télécharger :** télécharger le fichier `.pkpass` signé.
*   **Code QR :** afficher un code QR d'installation que les utilisateurs peuvent scanner pour ajouter le pass à Wallet et enregistrer leur appareil pour les mises à jour. Dans cette fenêtre, vous pouvez également utiliser **Copier le lien d'installation** sous le QR.
*   **Copier le lien d'installation :** copier l'URL d'installation pour partager le pass dans vos canaux de messagerie. [En savoir plus](#share-the-pass-with-users-via-pushwoosh-channels).
*   **Envoyer un message :** ouvrir le compositeur de notifications push uniques pour envoyer un message aux détenteurs de pass. Lorsque vous l'ouvrez depuis la liste, il cible le propriétaire du pass par [User ID](/fr/product/pushwoosh-knowledge-hub/users-userids/). Voir [Envoyer un message aux détenteurs de pass Apple Wallet](/fr/product/messaging-channels/apple-wallet-passes/message-pass-holders/) pour toutes les manières de les atteindre.
*   **Supprimer :** supprimer le pass. Les copies déjà installées sur les appareils cessent de recevoir les mises à jour et deviennent invalides lors de leur prochain rafraîchissement.

## Partager le pass avec les utilisateurs via les canaux Pushwoosh

Le lien d'installation que vous copiez dans le constructeur (**Copier le lien d'installation**) est une URL normale. L'ouvrir sur un iPhone ajoute le pass à Apple Wallet. Vous pouvez utiliser ce lien dans les mêmes canaux Pushwoosh que vous utilisez déjà pour atteindre votre audience :

*   **E-mail :** ajoutez le lien à un bouton ou à un lien texte dans l'[éditeur d'e-mails](/fr/product/content/email-content/drag-and-drop-email-editor/), par exemple, un appel à l'action "Ajouter à Apple Wallet".
*   **Notifications push :** définissez le lien comme [action d'ouverture](/fr/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked) de la notification afin qu'un appui ouvre le pass.
*   **SMS :** incluez le lien dans le [contenu SMS](/fr/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content).

<Aside type="note" title="Un lien par pass">
Chaque lien d'installation est lié à un seul pass (il porte le numéro de série et le jeton de ce pass), donc un lien fonctionne pour un pass partagé, ce qui est pratique pour un coupon commun ou un billet d'événement. Pour donner à chaque destinataire son propre pass, générez un pass par utilisateur avec l'[API PassKit](/fr/developer/api-reference/apple-wallet-passkit-api/) et envoyez à chaque utilisateur son propre lien. Les passes Wallet s'installent uniquement sur les appareils Apple — iPhone et Apple Watch.
</Aside>

## Gérer les passes via l'API

Tout ce que fait le constructeur de pass est également disponible par programmation via l'API PassKit Designer : créer, mettre à jour, lister, télécharger et supprimer des passes.

<LinkCard title="API PassKit Apple Wallet" href="/developer/api-reference/apple-wallet-passkit-api/" />

## Afficher les détenteurs de pass dans l'User Explorer

Lorsqu'un utilisateur ajoute votre pass à Wallet, Pushwoosh le répertorie dans l'onglet **Appareils et plateformes** de l'[User Explorer](/fr/product/audience-data-and-segmentation/user-explorer/).

1.  Allez à **Audience → User Explorer** et ouvrez le profil de l'utilisateur.
2.  Ouvrez l'onglet **Appareils et plateformes**.
3.  Sélectionnez **Apple Wallet** dans la barre latérale.

Sur le profil de la plateforme, vous pouvez consulter :

*   **Statut de l'abonnement :** par exemple, **ABONNÉ**
*   **Identifiant de la plateforme :** l'identifiant du pass affiché sous le nom de la plateforme
*   **Métadonnées :** **Premier abonnement**, **Fuseau horaire**, et autres champs lorsqu'ils sont disponibles
*   **Tags :** tags de la plateforme, y compris ceux que vous avez définis lors de l'émission du pass

[En savoir plus](/fr/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)