Deep Linking
Cómo funcionan los enlaces profundos en ReciGo para una experiencia fluida de usuario.
¿Qué es Deep Linking?
Deep linking es una tecnología que permite que un enlace HTTPS normal abra directamente una página específica dentro de una aplicación móvil, en lugar de abrir el navegador web.
Beneficios
- Experiencia fluida: El cliente hace clic en el SMS y va directamente a la pantalla correcta en la app
- Sin fricción: No necesita buscar manualmente el trabajo en la app
- Mayor conversión: Reduce pasos y aumenta la probabilidad de que el cliente complete el trabajo
- Funciona en navegador: Si la app no está instalada, el enlace funciona como URL web normal
Formato del Enlace
Cuando creas un trabajo a través de la API, ReciGo genera un deep link que se envía al cliente vía SMS:
https://recigo.es/draft/{job_id}?phone={url_encoded_phone}Componentes del Enlace
job_idID único del trabajo (UUID). Ejemplo: 550e8400-e29b-41d4-a716-446655440000
phoneNúmero de teléfono del cliente codificado en URL. Ejemplo: %2B34612345678 (que es +34612345678)
Seguridad: El parámetro phone se usa para verificar que quien abre el enlace es el cliente correcto. Solo el número de teléfono proporcionado en la API puede acceder al trabajo borrador.
Ejemplo Completo
https://recigo.es/draft/550e8400-e29b-41d4-a716-446655440000?phone=%2B34612345678Este enlace se incluye en el SMS enviado al cliente:
Tu trabajo de TuPlataforma está listo en ReciGo.
📦 Mover sofá de 2 plazas
📍 Madrid → Madrid
💰 €46.49
Completa tu trabajo aquí:
https://recigo.es/draft/550e8400...
Descarga ReciGo si no tienes la app.
Flujo Técnico
Cliente Hace Clic en el Enlace
El cliente recibe el SMS y hace clic en https://recigo.es/draft/...
iOS/Android Detecta la App
El sistema operativo comprueba si la app ReciGo está instalada:
✅ App instalada
El enlace abre la app directamente en la pantalla del trabajo borrador
❌ App NO instalada
El enlace abre el navegador y muestra una página de redirección
Verificación de Teléfono
La app extrae el parámetro phone del enlace y verifica que coincida con el número almacenado en el trabajo borrador. Solo si coincide, el cliente puede continuar.
Autenticación (Si Necesario)
Si el cliente no ha iniciado sesión, se le pide que se registre o inicie sesión con verificación de teléfono. Una vez autenticado, el trabajo se vincula a su cuenta.
Mostrar el Trabajo
La app muestra la pantalla del trabajo borrador con todos los detalles pre-rellenados. El cliente puede revisar y proceder a añadir el método de pago.
Universal Links (iOS)
En iOS, ReciGo utiliza Universal Links, una tecnología de Apple que permite asociar URLs HTTPS con una aplicación:
Cómo Funciona
- ReciGo publica un archivo
apple-app-site-associationen el dominio recigo.es - Este archivo declara que la app ReciGo puede manejar URLs que comienzan con
/draft/ - Cuando iOS detecta este patrón, abre automáticamente la app en lugar del navegador
- Si la app no está instalada, iOS abre Safari normalmente
Ventaja: Los Universal Links son más seguros que esquemas URL personalizados (como recigo://) porque requieren verificación de dominio. Solo la app ReciGo oficial puede manejar enlaces de recigo.es.
App Links (Android)
En Android, ReciGo utiliza App Links, el equivalente de Android a Universal Links:
Cómo Funciona
- ReciGo publica un archivo
assetlinks.jsonen el dominio recigo.es - Este archivo declara que la app ReciGo puede manejar URLs de recigo.es
- La app declara un Intent Filter para
https://recigo.es/draft/* - Android verifica automáticamente la asociación y abre la app directamente
Ventaja: App Links con autoVerify=true evitan el diálogo "Abrir con..." y abren la app directamente, mejorando la experiencia del usuario.
Página de Respaldo Web
Si la app no está instalada, el enlace abre una página web que:
Funcionalidad de la Página
- Detecta automáticamente el dispositivo (iOS o Android)
- Muestra un mensaje: "Descarga ReciGo para completar tu trabajo"
- Intenta abrir la app usando esquema URL personalizado (
recigo://draft/...) - Si falla después de 3 segundos, redirige al App Store o Google Play Store
- Incluye botones manuales "Descargar para iOS" / "Descargar para Android"
// Detectar plataforma
const isIOS = /iPad|iPhone|iPod/.test(navigator.userAgent);
const isAndroid = /Android/.test(navigator.userAgent);
// Intentar abrir la app
window.location.href = `recigo://draft/${jobId}?phone=${phone}`;
// Si no funciona después de 3s, ir a la tienda
setTimeout(() => {
if (isIOS) {
window.location.href = 'https://apps.apple.com/app/recigo/...';
} else if (isAndroid) {
window.location.href = 'https://play.google.com/store/apps/details?id=es.recigo.app';
}
}, 3000);Seguridad del Deep Linking
🔒 Verificación de Teléfono
El parámetro phone en el enlace se compara con el customer_phone almacenado en el trabajo borrador. Solo si coinciden, el cliente puede acceder al trabajo.
🔒 Vinculación de Cuenta
Cuando el cliente se autentica, la app vincula el trabajo borrador a su cuenta usando el número de teléfono verificado. Esto previene que otra persona con el enlace pueda acceder al trabajo.
🔒 Expiración
Los trabajos borradores expiran después de 48 horas. Después de este período, el enlace deja de funcionar y muestra un mensaje de "Trabajo expirado o no encontrado".
🔒 Verificación de Dominio
Universal Links (iOS) y App Links (Android) requieren verificación de dominio. Solo la app oficial de ReciGo firmada con el certificado correcto puede manejar enlaces de recigo.es, previniendo ataques de phishing.
Mejores Prácticas
✅ Verifica el número de teléfono
Asegúrate de que el customer_phone que proporcionas sea correcto y esté en formato internacional (ej: +34612345678). Si el número es incorrecto, el SMS llegará a la persona equivocada.
✅ No modifiques el enlace
Usa el deep_link_url exactamente como lo devuelve la API. No añadas parámetros adicionales ni modifiques la URL, ya que esto podría romper la funcionalidad.
✅ Comunica claramente
En tu plataforma, informa al cliente que recibirá un SMS de ReciGo con instrucciones para completar el trabajo. Esto reduce confusión y aumenta la tasa de conversión.
✅ Enlace acortado opcional
Si el enlace es demasiado largo para SMS, puedes usar un servicio de acortamiento de URLs (como Bitly) antes de enviar tu propio mensaje de confirmación. Sin embargo, el SMS de ReciGo ya maneja esto automáticamente.