# Primeros pasos con los pases de Apple Wallet

Los pases de Apple Wallet son tarjetas digitales, como tarjetas de fidelización, cupones, entradas para eventos, tarjetas de embarque y tarjetas de tiendas, que sus usuarios guardan en la aplicación Wallet en iPhone y Apple Watch. Con Pushwoosh, puede diseñar un pase visualmente en el Control Panel, compartirlo y luego enviar actualizaciones en cualquier momento sin pedir a los usuarios que reinstalen nada.

Cuando cambia un pase, Pushwoosh notifica a cada dispositivo que lo agregó, y iOS obtiene silenciosamente la nueva versión. El código de barras, el saldo, el número de puerta o la fecha de caducidad en el teléfono del usuario se actualizan por sí solos.

## Qué puede hacer con los pases de Apple Wallet

Con los pases de Apple Wallet en Pushwoosh, puede:

* Diseñar pases visualmente con colores, campos, logotipo, imagen de banda y código de barras, sin escribir `pass.json` a mano.
* Crear tarjetas de fidelización, cupones, entradas para eventos, tarjetas de embarque y tarjetas de tienda genéricas.
* Distribuir pases a los usuarios como un archivo `.pkpass`, un enlace de instalación o un código QR.
* Actualizar el contenido del pase y entregar los cambios a los dispositivos que agregaron el pase.
* Llegar a los titulares de pases con una notificación push única, una actualización de pase o un Customer Journey. Consulte [Enviar mensajes a los titulares de pases de Apple Wallet](/es/product/messaging-channels/apple-wallet-passes/message-pass-holders/).

## Requisitos previos

<Aside type="caution" icon="setting" title="Se necesita la ayuda de un desarrollador">
La emisión de pases de Apple Wallet requiere una cuenta de desarrollador de Apple y certificados de firma. Comparta esta sección con su equipo de desarrolladores para completar la configuración única.
</Aside>

Antes de diseñar su primer pase, confirme lo siguiente:

* **Programa de Desarrolladores de Apple:** Necesita una membresía activa para registrar los ID de tipo de pase y crear certificados de firma. [Inscríbase o gestione su cuenta](https://developer.apple.com/programs/)
* **Plataforma iOS:** Su aplicación debe tener iOS conectado en Pushwoosh antes de poder agregar un certificado de firma de pase. [Configurar iOS](/es/developer/first-steps/connect-messaging-services/ios-configuration/)

## Empezar a trabajar con los pases de Apple Wallet

Una vez que los [requisitos previos](#prerequisites) estén listos, siga este flujo:

<Steps>

1. **Configurar los pases de Wallet en Pushwoosh**

   Antes de que pueda diseñar pases, Pushwoosh debe tener su certificado de firma de Apple para la aplicación. Su equipo de desarrolladores lo crea en Apple Developer y lo sube a Pushwoosh. Esta es una configuración única por aplicación.

   [Cómo configurar el certificado de firma](/es/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2. **Diseñar el pase**

   En el [creador de pases](/es/product/messaging-channels/apple-wallet-passes/pass-builder/), elija un estilo de pase, establezca los campos y la marca, y compruebe la vista previa en vivo.

3. **Generar un `.pkpass` firmado**

   Una vez que cree y valide el pase, en el [creador de pases](/es/product/messaging-channels/apple-wallet-passes/pass-builder/#generate-the-pass), seleccione **Generar**. Pushwoosh prepara las imágenes en las resoluciones requeridas y firma el archivo con su certificado.

4. **Distribuir el pase**

   Envíe a los usuarios el archivo `.pkpass`, el enlace de instalación o el código QR. Consulte [Compartir el pase con los usuarios a través de los canales de Pushwoosh](#share-the-pass-with-users-via-pushwoosh-channels). Cuando los usuarios agregan el pase a Wallet, su dispositivo se registra para futuras actualizaciones.

5. **Actualizar el contenido del pase**

   Edite el pase en el creador de pases o a través de la API y guarde. Pushwoosh notifica a los dispositivos registrados, y iOS descarga la nueva versión en segundo plano. Los usuarios no necesitan reinstalar el pase.

6. **Enviar mensajes a los titulares de pases**

   Una vez que los usuarios agregan el pase a Wallet, puede llegar a ellos con una notificación push única, una actualización de pase o un Customer Journey automatizado.

   [Enviar mensajes a los titulares de pases de Apple Wallet](/es/product/messaging-channels/apple-wallet-passes/message-pass-holders/)

</Steps>

## Ver y gestionar pases existentes

En el Control Panel, vaya a **Campañas → Pases de Wallet** y abra la pestaña **Apple Wallet**. La tabla **Todos los pases** lista cada pase para la aplicación, incluyendo su nombre, estilo, el [User ID](/es/product/pushwoosh-knowledge-hub/users-userids/) con el que está asociado, y la fecha y hora en que fue actualizado por última vez.

En la lista de pases, abra el menú de acciones (⋮) para:

* **Editar:** cambiar el nombre y la descripción del pase, los valores y etiquetas de los campos, cambiar mensajes, colores, mensaje del código de barras, caducidad y estado, y ubicaciones. El estilo y las imágenes del pase permanecen bloqueados después de la creación. Cuando guarda, cada dispositivo que agregó el pase recibe la actualización.

<Aside type="note" title="Las actualizaciones se entregan como notificaciones push silenciosas">
Cuando guarda un cambio, Pushwoosh vuelve a firmar el pase y notifica a cada dispositivo registrado con una notificación push sin contenido. iOS obtiene la nueva versión por sí solo, no se requiere reinstalación.
</Aside> 

* **Descargar:** descargar el archivo `.pkpass` firmado.
* **Código QR:** mostrar un código QR de instalación que los usuarios pueden escanear para agregar el pase a Wallet y registrar su dispositivo para recibir actualizaciones. En esta ventana, también puede usar **Copiar enlace de instalación** debajo del QR.
* **Copiar enlace de instalación:** copiar la URL de instalación para compartir el pase en sus canales de mensajería. [Más información](#share-the-pass-with-users-via-pushwoosh-channels).
* **Enviar mensaje:** abrir el compositor de notificaciones push únicas para enviar mensajes a los titulares de pases. Cuando lo abre desde la lista, se dirige al propietario del pase por [User ID](/es/product/pushwoosh-knowledge-hub/users-userids/). Consulte [Enviar mensajes a los titulares de pases de Apple Wallet](/es/product/messaging-channels/apple-wallet-passes/message-pass-holders/) para conocer todas las formas de llegar a ellos.
* **Eliminar:** eliminar el pase. Las copias ya instaladas en los dispositivos dejan de recibir actualizaciones y se invalidan en su próxima actualización.

## Compartir el pase con los usuarios a través de los canales de Pushwoosh

El enlace de instalación que copia en el creador (**Copiar enlace de instalación**) es una URL normal. Abrirlo en un iPhone agrega el pase a Apple Wallet. Puede usar este enlace en los mismos canales de Pushwoosh que ya utiliza para llegar a su audiencia:

* **Correo electrónico:** agregue el enlace a un botón o enlace de texto en el [editor de correo electrónico](/es/product/content/email-content/drag-and-drop-email-editor/), por ejemplo, una llamada a la acción "Agregar a Apple Wallet".
* **Notificaciones push:** establezca el enlace como la [acción de apertura](/es/product/messaging-channels/push-notifications/send-push-notifications/one-time-push/#define-what-happens-when-the-push-is-clicked) de la notificación para que un toque abra el pase.
* **SMS:** incluya el enlace en el [contenido del SMS](/es/product/messaging-channels/sms/send-sms/send-sms-via-customer-journey/#configure-sms-content).

<Aside type="note" title="Un enlace por pase">
Cada enlace de instalación está vinculado a un único pase (lleva el número de serie y el token de ese pase), por lo que un enlace funciona para un pase compartido, lo cual es útil para un cupón o una entrada de evento común. Para dar a cada destinatario su propio pase, genere un pase por usuario con la [API PassKit](/es/developer/api-reference/apple-wallet-passkit-api/) y envíe a cada usuario su propio enlace. Los pases de Wallet se instalan solo en dispositivos Apple: iPhone y Apple Watch.
</Aside>

## Gestionar pases a través de la API

Todo lo que hace el creador de pases también está disponible programáticamente a través de la API PassKit Designer: crear, actualizar, listar, descargar y eliminar pases.

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

## Ver a los titulares de pases en User Explorer

Cuando un usuario agrega su pase a Wallet, Pushwoosh lo lista en la pestaña **Dispositivos y plataformas** en [User Explorer](/es/product/audience-data-and-segmentation/user-explorer/).

1. Vaya a **Audiencia → User Explorer** y abra el perfil del usuario.
2. Abra la pestaña **Dispositivos y plataformas**.
3. Seleccione **Apple Wallet** en la barra lateral.

En el perfil de la plataforma, puede revisar:

* **Estado de la suscripción:** por ejemplo, **SUBSCRIBED**
* **Identificador de la plataforma:** el identificador del pase que se muestra bajo el nombre de la plataforma
* **Metadatos:** **Primera suscripción**, **Zona horaria** y otros campos cuando estén disponibles
* **Tags:** tags de la plataforma, incluyendo cualquiera que haya establecido al emitir el pase

[Más información](/es/product/audience-data-and-segmentation/user-explorer/#devices-and-platforms-tab)