Pases de Wallet

Joryio puede emitir pases de Apple Wallet y Google Wallet - tarjetas de fidelización, cupones, entradas para eventos y pases genéricos - con tus propias credenciales de Apple y Google. Añade un enlace «Añadir a Wallet» a cualquier mensaje (email, in-app, SMS o WhatsApp); cada destinatario recibe su propio pase personalizado y puedes actualizar un pase emitido en cualquier momento desde un recorrido: el cambio se envía directamente al dispositivo.

Cómo funciona

Un pase de Wallet no es un mensaje; tiene tres etapas:

1. Aprovisionamiento: cuando un destinatario toca el enlace Añadir a Wallet, Joryio genera un pase personalizado y lo firma con tus credenciales. El aprovisionamiento se pospone hasta el clic, de modo que puedes incrustar un enlace por destinatario en cualquier mensaje sin firmarlo en el momento de envío.
2. Distribución: el enlace va dentro de un mensaje normal. Ese mensaje respeta las mismas reglas de consentimiento, supresión, horas de silencio y frecuencia que cualquier otro mensaje de su canal.
3. Actualización: cuando cambias el pase de un contacto (por ejemplo, un nuevo saldo de puntos), la actualización se envía a todos los dispositivos que lo instalaron (Apple mediante push y Google mediante la API de Wallet). Las actualizaciones son de sistema a sistema y no están sujetas al consentimiento de marketing, pero el pase de un contacto eliminado o marcado como no contactar se anula en vez de actualizarse.

1. Conecta tus credenciales

Ve a Configuración → Pases de Wallet y añade una cuenta de proveedor. Cada cuenta registra quién la creó y quién la actualizó por última vez.

Apple Wallet

Necesitas una cuenta de Apple Developer y un certificado de ID de tipo de pase. Hay dos formas de añadirlo:

• CSR → certificado (recomendado): Joryio genera una solicitud de firma (CSR) para que la cargues en el portal Apple Developer; después cargas el archivo .cer emitido por Apple de vuelta en Joryio. La clave privada nunca sale de Joryio.
• Carga de .p12: carga un certificado de ID de tipo de pase existente exportado como archivo .p12 junto con su contraseña.

Proporciona tu ID de equipo, ID de tipo de pase (por ejemplo, pass.com.yourcompany.loyalty) y una clave APNs (para poder enviar actualizaciones del pase). Joryio avisa cuando el certificado se acerca a su vencimiento y bloquea la emisión cuando caduca. Usa Actualizar certificado en la cuenta para renovarlo sin reemplazarla.

Google Wallet

Necesitas una cuenta de servicio de Google Cloud con el rol Wallet Object Issuer y tu ID de emisor. Carga el JSON de la cuenta de servicio e introduce el ID de emisor.

Las credenciales se cifran en reposo y se muestran ocultas después de guardarlas; puedes reemplazarlas en cualquier momento.

2. Crear una plantilla de pase

En Brand Studio → Plantillas de Wallet, crea una plantilla desde cero o parte de un preajuste de galería. La información básica - Nombre, Descripción, Etiquetas, Tipo de pase y la cuenta de Apple / Google - permanece en la parte superior del editor. El resto se organiza en tres pestañas:

• Frente del pase: la cara visible del pase.
• Reverso del pase: las filas que aparecen cuando el titular da la vuelta al pase.
• Funciones: capacidades a nivel de pase (caducidad, enlaces profundos de app y ubicaciones).

Una vista previa en vivo aparece a la derecha con su propio selector Frente / Reverso, y un selector Apple Wallet / Google Wallet permite diseñar cada plataforma.

Los valores de los campos y el código de barras son plantillas Liquid que se generan para cada destinatario. Por ejemplo, un valor de campo principal {{ user.custom.points }} muestra el propio saldo de puntos de cada cliente. La vista previa muestra el diseño con datos de ejemplo; los tokens reales se resuelven por destinatario al enviar.

Frente del pase

• Diseño: colores de fondo, texto y etiquetas; texto de logo e imágenes (logo, icono, franja, imagen principal). Los pases de Apple también pueden suprimir el brillo de la franja.
• Campos: grupos de encabezado / principal / secundario / auxiliar (clave, etiqueta y valor). Las entradas de eventos añaden Información del evento (nombre del evento y lugar); los pases genéricos de Google añaden filas de información.
• Código de barras: QR / PDF417 / Aztec / Code 128, con el valor codificado y texto alternativo opcional.

Reverso del pase

El reverso se muestra cuando el titular toca para dar la vuelta al pase. Añade tantas filas como quieras y arrástralas y suéltalas para reordenarlas. Cada fila es una de estas:

• Enlace: un Título, texto de presentación y URL, que se muestra como enlace tocable en el reverso del pase (por ejemplo, un enlace «Gestionar cuenta» o «Ver pedido»).
• Campo de texto: un Título y valor (por ejemplo, condiciones, fecha de alta u horario de soporte).

Todos los campos del reverso admiten tokens de personalización - incluido el texto de presentación de un enlace y su URL - , de modo que un enlace puede apuntar a un destino por destinatario como https://example.com/orders/{{ user.custom.orderId }}.

Funciones

Capacidades de nivel de pase que no aparecen como campos de la tarjeta.

Caducidad del pase: actívala para desactivar automáticamente el pase después de la fecha y hora elegidas. La hora se interpreta en la zona horaria del espacio de trabajo.

aviso

Los pases caducados se desactivan y no se pueden reactivar. Para volver a dar a un contacto un pase válido, debes distribuir uno nuevo.

Enlaces profundos de app: permiten que el pase abra tu app desde Wallet.

• Apple: un ID de App Store más una URL de inicio. La URL de inicio solo se usa cuando se configura un ID de App Store.
• Google: un nombre de paquete Android y una URL de app web.

Son capacidades nativas del pase: la app de Wallet muestra el enlace y el enlace profundo se gestiona en el dispositivo.

Mensajes basados en ubicación: muestran un mensaje en la pantalla bloqueada cuando el titular está a unos 100 m de un lugar. Añade uno o varios puntos, cada uno con latitud, longitud y el mensaje de pantalla bloqueada que mostrar. Es nativo del dispositivo y no necesita notificación push.

Solo iPhone

El mensaje de pantalla bloqueada es una función de Apple Wallet (iPhone). Google Wallet almacena la ubicación pero no puede mostrar un mensaje personalizado, y la entrega en Android no está garantizada. Para una geovalla fiable en Android, usa en su lugar una notificación push activada por ubicación.

nota

Los pases vinculados (agrupar pases relacionados para que se instalen juntos) e iBeacon (un mensaje de pantalla bloqueada cerca de una baliza Bluetooth) están disponibles mediante Contactar con soporte.

3. Añadir un enlace «Añadir a Wallet» a un mensaje

No existe un «mensaje de Wallet» independiente: incrusta el enlace donde compongas el mensaje.

Email e in-app (bloque de arrastrar y soltar)

En el editor de email o in-app, arrastra el bloque Añadir a Wallet desde el panel Bloques a tu diseño. Selecciónalo y elige la plantilla de pase y la plataforma en el panel Ajustes de la derecha. El icono de engranaje del Canvas abre Configurar pase…, donde puedes definir una etiqueta de origen / seguimiento y anulaciones de valores por campo, con una vista previa en vivo del pase.

SMS y WhatsApp (personalización)

Los cuerpos de SMS y WhatsApp son texto simple, así que abre + Personalizar y elige Añadir a Wallet. Selecciona la plantilla, la plataforma, una etiqueta de origen opcional y cualquier anulación de campo; una vista previa en vivo muestra el pase. Al insertarlo se añade un token que se convierte en un enlace de instalación por destinatario al enviar (acortado a un enlace /s/… para que no agote el presupuesto de segmentos de SMS).

Opciones de plataforma

• Apple Wallet: un enlace solo para Apple.
• Google Wallet: un enlace solo para Google.
• Híbrida (detección automática): recomendada; el enlace detecta el dispositivo (iOS → Apple, Android → Google) y muestra una página de destino de marca en escritorio o en dispositivos desconocidos.

4. La página de destino universal

Los enlaces híbridos abiertos en un ordenador o dispositivo desconocido muestran una página de destino de marca con botones Añadir a Apple Wallet y Guardar en Google Wallet. De forma predeterminada, toma la marca de la plantilla de pase. Puedes personalizarla por espacio de trabajo en Configuración → Pases de Wallet → Página de destino de instalación (título, subtítulo, logo, colores de acento y fondo).

5. Anulaciones por campo y etiquetas de origen

Tanto el bloque del editor como el selector de personalización te permiten:

• Anular valores de campo para un envío concreto (por ejemplo, un saldo promocional puntual) sin editar la plantilla compartida. Las anulaciones en blanco conservan el valor predeterminado de la plantilla.
• Definir una etiqueta de origen / seguimiento (por ejemplo, summer_promo). Al configurarla, sustituye la atribución automática de campaña/recorrido para ese enlace en los informes.

Cuando se envía desde una campaña o recorrido sin etiqueta manual, el pase se atribuye automáticamente a esa campaña o recorrido.

6. Actualizar un pase en un recorrido

En el Creador de recorridos, el nodo Actualizar pase de Wallet vuelve a generar el pase de un contacto para una plantilla y envía la actualización a su dispositivo; por ejemplo, «al comprar, actualiza el saldo de puntos». No envía un mensaje de marketing, por lo que no está sujeto al consentimiento ni a las horas de silencio, pero el pase de un contacto suprimido/eliminado se anula en vez de actualizarse.

Editar una plantilla después de emitir pases: los destinatarios nuevos - y cualquiera que aún no haya añadido el pase - reciben automáticamente la plantilla actual la próxima vez que se abre el enlace. Las personas que ya añadieron el pase a su Wallet solo cambian cuando envías una actualización (el nodo Actualizar pase de Wallet): editar una plantilla nunca reescribe silenciosamente tarjetas que ya están en los teléfonos de las personas.

7. Registrar y analizar la actividad de Wallet

Cada interacción de Wallet se registra en la cronología del contacto y está disponible para la segmentación y los disparadores de recorridos:

Evento	Cuándo
pass.issued	se aprovisionó un pase para el contacto
pass.downloaded	se abrió el enlace de instalación
pass.installed	se añadió el pase a Wallet en un dispositivo
pass.updated / pass.update_pushed	se cambió el pase y se envió a los dispositivos
pass.removed	se eliminó el pase de Wallet
pass.scanned	se escaneó/canjeó el código de barras del pase
pass.voided	se revocó el pase

Abre un contacto y ve a la pestaña Wallet para consultar sus pases emitidos, estado e historial. Para informes agregados, ve a Analítica → Analítica de Wallet: un embudo de adopción (issued → downloaded → scanned) con tasas de instalación, escaneo y retención, desglosadas por origen, plataforma o plantilla.

Señal de instalación de Apple frente a Google

pass.installed se activa para Apple cuando el dispositivo registra el pase, y para Google mediante la devolución de llamada de guardar/eliminar de Wallet. Añade un origen a tus enlaces para comparar canales en el embudo.

Segmentar por actividad de Wallet

Crea segmentos basados en eventos de Wallet con el filtro estándar evento; por ejemplo, «realizó pass.installed donde platform = apple» o «realizó pass.scanned ≥ 2 en los últimos 30 días». Puedes filtrar por propiedades de evento como platform, passTemplateId y source. (Un evento de Wallet aparece en el selector cuando se ha observado al menos una vez.)

Preguntas frecuentes: ¿cuándo se crea un pase nuevo?

¿Cada campaña crea un pase nuevo? No. Un pase se identifica por contacto + plantilla (por plataforma), no por la campaña. El primer envío aprovisiona el pase; cualquier envío posterior de la misma plantilla a ese contacto lo reutiliza.

Si envío un recordatorio, ¿el contacto acabará con dos pases? No: el recordatorio reutiliza el mismo pase y el mismo enlace «Añadir a Wallet». Añadirlo de nuevo solo actualiza el único pase que ya está en su Wallet.

¿Qué ocurre si envío la misma tarjeta por SMS y email? Sigue siendo un único pase: ambos enlaces se resuelven al mismo pase para ese contacto.

¿Cómo doy a un contacto dos tarjetas distintas? Crea dos plantillas. Una plantilla = un tipo de tarjeta = un pase activo por contacto.

Edité la plantilla: ¿por qué no cambió un pase ya emitido? Un pase que ya está en un teléfono solo se actualiza mediante el nodo Actualizar pase de Wallet (o al añadirlo de nuevo). Los pases aún no añadidos incorporan el cambio automáticamente; consulta «Editar una plantilla después de emitir pases» más arriba.

Notas

• El pase no contiene un enlace para darse de baja: eliminar un pase es la acción nativa «eliminar de Wallet», que registra pass.removed.
• Un pase por contacto + plantilla. Un contacto tiene un único pase activo para cada plantilla; los recordatorios, reenvíos y la misma tarjeta por SMS y email lo reutilizan (nunca se duplica). La campaña/recorrido se registra solo para atribución, no para identidad. Para una segunda tarjeta distinta, usa otra plantilla.
• Una solicitud de eliminación de datos (DSR) anula los pases del contacto y elimina los archivos de pases almacenados.