Volver a Inicio

Flujo del Cliente

Entiende qué sucede después de que creas un trabajo a través de la API.

Resumen del Flujo

Cuando creas un trabajo a través de la API de ReciGo, el cliente recibe un SMS con un enlace para completar el trabajo en la aplicación móvil. Este flujo está diseñado para maximizar la conversión y la confianza del cliente.

Pasos del Flujo

1

Tu plataforma crea un trabajo vía API

2

ReciGo envía SMS al cliente con enlace

3

Cliente abre la app (descarga si es necesario)

4

Cliente se registra/inicia sesión con verificación de teléfono

5

Cliente revisa el trabajo pre-rellenado

6

Cliente añade método de pago

7

Cliente publica el trabajo

8

Trabajo visible para transportistas cercanos

1

Tu Plataforma Crea el Trabajo

Llamas al endpoint POST /v1/jobs con los detalles del trabajo:

POST /v1/jobs
{
  "external_reference": "blocket-listing-12345",
  "title": "Mover sofá de 2 plazas",
  "description": "Sofá gris en buen estado",
  "size": "L",
  "pickup": {
    "address": "Calle Gran Vía 1, Madrid"
  },
  "dropoff": {
    "address": "Calle Alcalá 100, Madrid"
  },
  "customer_phone": "+34612345678",
  "photos": [
    "https://tu-plataforma.com/foto1.jpg"
  ]
}

Importante: El trabajo se crea con estado draft y expirará automáticamente después de 48 horas si el cliente no completa el pago.

2

ReciGo Envía SMS al Cliente

Inmediatamente después de crear el trabajo, ReciGo envía un SMS al número de teléfono del cliente con tu marca:

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.

Nota: El nombre de tu plataforma (ej: "TuPlataforma") se obtiene del campo company_name de tu perfil de partner. El mensaje es completamente dinámico y se genera automáticamente.

3

Cliente Abre la App

Cuando el cliente hace clic en el enlace del SMS:

✅ Si la app está instalada

El enlace abre directamente la aplicación ReciGo en la pantalla del trabajo borrador. El cliente puede proceder inmediatamente.

📱 Si la app NO está instalada

Se muestra una página web que detecta automáticamente el dispositivo (iOS/Android) y redirige a la App Store o Google Play Store. Después de instalar, el cliente puede abrir el enlace nuevamente.

Universal Links: ReciGo utiliza Universal Links (iOS) y App Links (Android) para una experiencia de usuario fluida. El enlace es un HTTPS URL normal que funciona tanto en navegador como en la app.

4

Cliente Inicia Sesión o Se Registra

Si el cliente no ha iniciado sesión en la app, se le pide que se registre o inicie sesión:

Verificación de Teléfono

  1. Cliente introduce su número de teléfono
  2. ReciGo envía un código de verificación vía SMS
  3. Cliente introduce el código
  4. ReciGo verifica que el número coincide con el customer_phone del trabajo borrador
  5. Si coincide, el trabajo se vincula automáticamente a la cuenta del cliente

Seguridad: Solo el número de teléfono proporcionado en la API puede acceder al trabajo borrador. Esto previene acceso no autorizado y garantiza que el trabajo se vincule al cliente correcto.

5

Cliente Revisa el Trabajo

El cliente ve todos los detalles del trabajo pre-rellenados con la información que proporcionaste:

Información Visible

📦 Título y descripción

📍 Direcciones de recogida y entrega

📏 Tamaño del objeto

📸 Fotos subidas por ti

💰 Precio total

🚛 Distancia estimada

⏱️ Duración estimada

📄 Desglose de costos

El cliente puede revisar toda la información pero no puede editarla (excepto añadir notas adicionales si lo desea). Esto garantiza que los detalles del trabajo permanezcan consistentes con lo que se acordó en tu plataforma.

6

Cliente Añade Método de Pago

Si el cliente no tiene un método de pago guardado, se le solicita que añada uno:

Opciones de Pago

  • 💳 Tarjeta de crédito/débito (Visa, Mastercard, etc.)
  • 🍎 Apple Pay (iOS)
  • 🤖 Google Pay (Android)

Seguridad: Todos los pagos son procesados por Stripe. ReciGo nunca almacena datos de tarjetas completos. El pago se pre-autoriza pero NO se captura hasta que el trabajo sea completado por el transportista.

7

Cliente Publica el Trabajo

Una vez que el cliente ha revisado todo y añadido su método de pago, hace clic en "Publicar Trabajo":

Qué Sucede al Publicar

  1. El pago se pre-autoriza (se retiene el monto en la tarjeta)
  2. El estado del trabajo cambia de draft a posted
  3. El trabajo se hace visible para transportistas cercanos en la app
  4. El cliente recibe una confirmación

¡Éxito! En este punto, el trabajo está publicado y activo en la red de ReciGo. El cliente puede rastrear el progreso en la app.

8

Transportistas Ven el Trabajo

Los transportistas con la app ReciGo cerca de la ubicación de recogida recibirán notificaciones push y verán el trabajo en su feed:

Proceso de Aceptación

  1. Transportista ve el trabajo en el mapa o lista
  2. Transportista revisa detalles (precio, distancia, fotos)
  3. Transportista acepta el trabajo
  4. Cliente recibe notificación de que alguien aceptó
  5. Transportista va a recoger el objeto
  6. Transportista entrega el objeto
  7. El pago se captura y transfiere al transportista
  8. Ambas partes dejan calificaciones

ReciGo maneja todo el proceso de coordinación, comunicación y pago entre el cliente y el transportista. Tu plataforma no necesita intervenir después de crear el trabajo.

¿Qué Pasa Si...?

❓ El cliente nunca completa el pago

El trabajo permanece en estado draft y expira automáticamente después de 48 horas. Es eliminado de la base de datos y el cliente no puede acceder a él. No se realiza ningún cargo.

❓ El cliente no tiene la app instalada

El enlace del SMS detecta automáticamente si la app no está instalada y redirige al cliente a la App Store (iOS) o Google Play Store (Android). Después de instalar, el cliente puede abrir el enlace nuevamente y continuar donde lo dejó.

❓ El número de teléfono es incorrecto

Si proporcionaste un número de teléfono incorrecto, el SMS se enviará a ese número. Solo el dueño de ese número podrá acceder al trabajo. Si el cliente correcto no recibió el SMS, el trabajo expirará después de 48 horas sin actividad.

❓ Nadie acepta el trabajo

El trabajo permanece visible para transportistas hasta que alguien lo acepte o el cliente lo cancele. ReciGo notifica automáticamente a transportistas cercanos. Si después de un tiempo razonable nadie acepta, el cliente puede cancelar y recibir un reembolso completo (la pre-autorización se libera).

❓ El cliente cancela después de publicar

Si el trabajo aún no ha sido aceptado por un transportista, el cliente puede cancelar sin penalización y la pre-autorización se libera. Si ya fue aceptado, pueden aplicar políticas de cancelación dependiendo del momento.

Modelo Fire-and-Forget

ReciGo utiliza un modelo "fire-and-forget" para la integración de partners:

Qué Significa Esto

  • No hay webhooks: ReciGo NO envía webhooks cuando el estado del trabajo cambia
  • Consulta cuando necesites: Usa el endpoint GET /v1/jobs/{job_id} si necesitas conocer el estado actual
  • Sin responsabilidad post-creación: Una vez creado el trabajo, ReciGo maneja todo el proceso
  • Simplifica tu integración: No necesitas implementar endpoints para recibir webhooks

Si Necesitas Rastrear el Estado

Si quieres actualizar tu base de datos con el estado del trabajo, puedes:

  1. Implementar polling periódico (ej: cada hora) del endpoint GET /v1/jobs/{job_id}
  2. Mostrar un enlace al cliente para "Ver estado en ReciGo"
  3. Considerar el trabajo como "completado" una vez que sale de tu plataforma

Explorar Más

Deep Linking →

Detalles técnicos sobre cómo funcionan los enlaces profundos

Consultar Estado →

Aprende cómo consultar el estado de un trabajo