Un amigo te manda una tarjeta: «nos falta un voto, toca para poner el tuyo». Tocas. El miniprograma se abre en el inicio, el voto ya no está y tienes que volver a encontrar el grupo desde cero. Nada se rompió. El botón funcionó. El enlace simplemente olvidó qué llevaba.

Hemos publicado ese fallo más de una vez, y rara vez es un botón roto. Es un enlace pensado como una dirección cuando tendría que ser una frase: abre esto, en este estado, para esta persona, desde este sitio. Años de URLs de web nos enseñaron a tratar los enlaces como lugares. Dentro de una super app, un enlace sin contexto apenas es un enlace: solo una forma de abrir la puerta de entrada.

Un enlace es una frase, no una dirección

Cada punto de entrada te pasa un sobre pequeño de contexto antes de que se dibuje la primera pantalla. Está lo que controlas tú: un id de producto, un id de grupo, una etiqueta de campaña, quién lo compartió. Y está lo que aporta el anfitrión, como un valor de escena que te dice si llegaste desde una pegatina con QR, desde un chat o desde un acceso directo guardado. WeChat los llama valores de escena; Alipay tiene su equivalente; un bot de Telegram recibe un payload start en el primer /start. Nombres distintos, la misma idea: el anfitrión ya sabe algo de cómo llegaste, y conviene leerlo en vez de adivinarlo.

El movimiento práctico es que compartir conserve el estado. Cuando alguien comparte desde la ficha de un producto, la tarjeta debería llevar ese id y dejar al destinatario en esa pantalla exacta, no en el inicio con un vago «mira esto». Cuando una campaña mete gente, la primera pantalla debería ser lo que la campaña prometió. Suena obvio hasta que auditas una app real y encuentras la mitad de las tarjetas apuntando a la ruta raíz.

Hay una regla que aprendimos a golpes: deja identidad, precio y permisos fuera de esos parámetros. Todo lo que va en un enlace lo entrega el cliente. Trata el payload como una pista de adónde ir, y que decida el servidor qué puede ver de verdad esa persona.

Dos caminos, un mismo payload

Aquí es donde casi todos los equipos tropiezan. No hay una forma de entrar, hay dos, y se comportan distinto.

El arranque en frío, con el miniprograma sin ejecutarse, entrega el payload al ciclo de vida de lanzamiento. Lo lees una vez, decides la ruta y renderizas la pantalla destino. Bien. Pero si el miniprograma ya estaba abierto en segundo plano, un enlace nuevo no lo reinicia: lo reanuda. El payload fresco llega al hook de reanudación, la página actual no se recarga, y si no atiendes ese hook a propósito, la persona se queda en la pantalla que dejó diez minutos atrás. Ese es el fallo de «toqué y no pasó nada», y como no es un cierre inesperado, se cuela en los tests.

Así que atiende los dos: parsea y enruta al lanzar, y vuelve a parsear y enrutar cada vez que la app vuelve a primer plano. La misma función pequeña, dos puntos de llamada. Si te salta el segundo, más o menos la mitad de tus enlaces profundos no hacen nada en silencio.

EntradaQué llevaEn qué pantalla aterrizaDónde se pierde
Tarjeta compartida desde un chatId de producto, id de grupo, quién compartióEse producto o grupo exacto, con su estado aplicadoLa tarjeta apunta al inicio; el contexto nunca sale del remitente
QR con valor de escenaId de escena, campaña, ubicaciónUna primera pantalla propia de la campañaEl parámetro de escena se pierde al copiar el enlace fuera del anfitrión
Enlace de anuncio o SMSCampaña, creatividad, un payload cortoLa oferta que el anuncio prometió de verdadEl navegador externo no abre el esquema del anfitrión; el toque muere ahí
Aviso o mensaje de suscripciónUn motivo y una pantalla destinoUna pantalla concreta, no la bandejaLos límites de plantilla descartan el campo custom; se abre una página genérica
Miniprograma ya abiertoUn payload nuevo al reanudarEl destino nuevo, decidido al reanudarNo se atiende el hook de reanudación y la pantalla vieja se queda quieta

Dónde muere la atribución en silencio

Ahora lo honesto. Da por hecho que algo se perderá. Los payloads se truncan: topes de longitud, caracteres especiales, un paso de codificación que no esperabas, un anfitrión que reescribe el enlace al reenviarlo. Los anfitriones también limitan el lanzamiento externo. Un enlace dentro de un navegador o un SMS suele necesitar un esquema concreto, ser interceptado o mostrar una confirmación antes de abrir nada; y un enlace creado para un anfitrión sencillamente no se abre en otro. Nos encantaría una URL que funcionara en todas partes, pero ningún anfitrión la quiere, así que deja de diseñar para eso. Haz una entrada por anfitrión y guarda un fallback web aburrido para el resto.

La atribución se puede romper en cualquier extremo. El remitente edita la ruta. El destinatario copia el enlace a otro chat y el id de escena no lo sigue. Una segunda apertura sobrescribe los parámetros de arranque en frío que ibas a registrar. Alguien hace una captura del QR en vez de escanearlo. Acabarás con un cubo de «origen desconocido» por mucho cuidado que pongas, y fingir que no existe solo produce paneles seguros y equivocados.

También hay un coste de seguridad. Si confiaste en un id de usuario o en un indicador de administrador de la cadena de consulta porque hacía el enrutado más fácil, regalaste un bug de autorización. Verifica en el servidor, siempre. El enlace dice dónde aterrizar; nunca debe decir quién es la persona.

Antes de diseñar la próxima tarjeta, prueba una cosa: abre el miniprograma, llévalo a segundo plano y toca un enlace nuevo desde otra conversación. Si aterriza en la pantalla vieja, acabas de encontrar el fallo que casi todos publican. Atiende el camino de reanudación, mantén el payload corto y aburrido, verifica en servidor todo lo sensible, y acepta que el id de escena que alguien pegó en un grupo es un hueco con el que se convive, no uno que se cierre.

Fuentes