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 tus usuarios guardan en la aplicación Wallet en iPhone y Apple Watch. Con Pushwoosh, puedes 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 cambias un pase, Pushwoosh notifica a cada dispositivo que lo ha añadido, 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é puedes hacer con los pases de Apple Wallet

Con los pases de Apple Wallet en Pushwoosh, puedes:

• 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 añadieron el pase.

Prerrequisitos

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. Comparte esta sección con tu equipo de desarrolladores para completar la configuración única.

Antes de diseñar tu primer pase, confirma lo siguiente:

• Programa de Desarrolladores de Apple: Necesitas una membresía activa para registrar los ID de tipo de pase y crear certificados de firma. Inscríbete o gestiona tu cuenta
• Plataforma iOS: Tu aplicación debe tener iOS conectado en Pushwoosh antes de que puedas añadir un certificado de firma de pase. Configurar iOS

Empezar a trabajar con los pases de Apple Wallet

Una vez que los prerrequisitos estén listos, sigue este flujo de trabajo:

1. Configurar los pases de Wallet en Pushwoosh

   Antes de que puedas diseñar pases, Pushwoosh debe tener tu certificado de firma de Apple para la aplicación. Tu 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 constructor de pases, elige un estilo de pase, establece los campos y la marca, y comprueba la vista previa en vivo.

3. Generar un .pkpass firmado

   Una vez que crees y valides el pase, en el constructor de pases, selecciona Generar. Pushwoosh prepara las imágenes en las resoluciones requeridas y firma el archivo con tu certificado.

4. Distribuir el pase

   Envía a los usuarios el archivo .pkpass, el enlace de instalación o el código QR. Consulta Compartir el pase con los usuarios a través de los canales de Pushwoosh. Cuando los usuarios añaden el pase a Wallet, su dispositivo se registra para futuras actualizaciones.

5. Actualizar el contenido del pase

   Edita el pase en el constructor de pases o a través de la API y guarda. 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, ve a Campañas → Apple Wallet para abrir la lista de pases. La página enumera cada pase para la aplicación, incluyendo su nombre, estilo, el User ID con el que está asociado, y la fecha y hora de su última actualización.

En la lista de pases, abre 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 guardas, cada dispositivo que añadió el pase recibe la actualización.

Las actualizaciones se entregan como notificaciones push silenciosas

Cuando guardas 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 añadir el pase a Wallet y registrar su dispositivo para actualizaciones. En esta ventana, también puedes usar Copiar enlace de instalación debajo del QR.
• Copiar enlace de instalación: copia la URL de instalación para compartir el pase en tus 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 copias en el constructor (Copiar enlace de instalación) es una URL normal. Abrirlo en un iPhone añade el pase a Apple Wallet. Puedes usar este enlace en los mismos canales de Pushwoosh que ya usas para llegar a tu audiencia:

• Email: añade 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 “Añadir a Apple Wallet”.
• Notificaciones push: establece el enlace como la acción de apertura de la notificación para que un toque abra el pase.
• SMS: incluye el enlace en el contenido del 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, genera un pase por usuario con la API PassKit y envía 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 constructor 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