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 tienda, que sus usuarios guardan en la aplicación Wallet en iPhone y Apple Watch. Con Pushwoosh, puede diseñar un pase visualmente en el Panel de control, 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 tira 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.

Requisitos previos

Se necesita asistencia 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.

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
• Plataforma iOS: Su aplicación debe tener iOS conectado en Pushwoosh antes de poder agregar un certificado de firma de pase. Configurar iOS

Empezar a trabajar con los pases de Apple Wallet

Una vez que los requisitos previos estén listos, siga este flujo:

1. Configurar los pases de Wallet en Pushwoosh

   Antes de poder 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

2. Diseñar el pase

   En el creador de pases, 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, 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. 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 guárdelo. Pushwoosh notifica a los dispositivos registrados, y iOS descarga la nueva versión en segundo plano. Los usuarios no necesitan reinstalar el pase.

Ver y gestionar los pases existentes

En el Panel de control, 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 ID de usuario al que está asociado, y la fecha y hora en que se actualizó 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 los mensajes, los colores, el mensaje del código de barras, la caducidad y el estado, y las 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.

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.

• 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.
• 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, por ejemplo, una llamada a la acción “Agregar a Apple Wallet”.
• Notificaciones push: establezca el enlace como la acción de apertura de la notificación para que un toque abra el pase.
• SMS: incluya el enlace en el contenido de SMS.

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 entrada de evento común. Para dar a cada destinatario su propio pase, genere un pase por usuario con la API PassKit y envíe a cada usuario su propio enlace. Los pases de Wallet se instalan solo en dispositivos Apple: iPhone y Apple Watch.

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.

API PassKit de Apple Wallet