Tutorial: Validación en tiempo real del login vía Email o código vía web service Seguir
Easypromos permite validar en tiempo real las direcciones de correo electrónico introducidas por los usuarios en el proceso de registro a la promoción contra un sistema de usuarios externo. De esta forma se pueden crear campañas promocionales en donde únicamente puedan participar usuarios existents en una base de datos mantenida por un cliente como los suscriptores de su newsletter, un CRM de contactos o un programa de fidelización.
Esta funcionalidad de validación en tiempo real, funciona tanto para validaciones de correo electrónicos como códigos únicos de usuario, por ejemplo: número de empleado, número de cliente, número de fidelizado, etc.
Ejemplos de uso:
- Crear un sorteo entre los suscriptores de una newsletter: Cuando el usuario se registre al sorteo, el sistema validará en tiempo real, que el usuario forma parte de la newsletter. Si no forma parte, el usuario verá un mensaje que debe registrarse a la newsletter con un enlace directo.
- Crear un juego tipo ruleta de premios en donde los usuarios deben introducir su número de cliente fidelizado para participar: se validará en tiempo real que el número introducido por el usuario forma parte de la base de datos de clientes fidelizados.
NOTA: Esta funcionalidad aplica cuando el proceso de identificación y registro sucede en Easypromos, es decir los usuarios deben rellenar el formulario de registro de la promoción. Si lo que buscas es una solución SSO (Single Sign On), en el que el usuario se identifica directamente en tu sistema, deberás utilizar la API de Autologin o bien la integración con Open ID Connect.
Requisitos y configuraciones iniciales
Estos requisitos son los que debe realizar y validar la persona que gestiona la promoción, que no tiene que ser necesariamente el desarrollador.
Para poder realizar la conexión son necesario estos requerimientos:
- Es necesario disponer de una plan Marca Blanca o Corporate. No se incluye en planes Premium o Básicos.
- La versión de la promoción debe ser Marca Blanca. No aplica a promociones Premium
- La pantalla de identificación/Login debe estar habilitada. No aplica cuando se activa el sistema de Login y registro en un solo paso
- Esta funcionalidad únicamente aplica con los métodos de Login:
- Email (Si validas correos electrónicos)
- Código cliente (Si validas números de cliente)
Una vez se cumplen estos requisitos, para la validación de email se deberá configurar la pantalla de identificación y registro de esta forma:
- Acceder al Editor de la promoción
- Ir a Páginas > Login y registro > Pestaña Login
- Asegurar que la opción de "Proceso de identificación y registro en un único paso" está deshabilitada
- Habilitar el Login con Email y en sus opciones habilitar Restricciones de email "A través de API externa (Web service)". Si en vez de validar emails, quieres validar códigos de cliente, deberás habilitar la opción de "Login con código de cliente".
- El Método, Content-type, Cabeceras, y URL del Web service, lo deberá proporcionar el desarrollador de la integración. Se explica en la siguiente sección del tutorial
- Mensaje de error: Introduce el texto que verá un usuario en caso de error en la validación. Aprovecha para introducir un enlace a tu sistema para que se registre. Ejemplo: "El email no es válido. Si todavía no eres suscriptor, date de alta aquí."
Para desarrolladores: Instrucciones técnicas para la integración del web service
Esta sección del tutorial está dirigida específicamente a los desarrolladores o integradores técnicos responsables de configurar la conexión con el web service externo. Deberán encargarse de la configuración de la API, incluyendo las cabeceras, los métodos y la URL del web service, para habilitar la validación en tiempo real.
Actualmente están soportadas llamadas a URLs vía HTTPS con el verbo GET y esperando una respuesta de tipo JSON.
La URL debe responder con un código 200 si el email tiene acceso a la promoción. Si se recibe cualquier otro código se interpretará que el usuario no tiene acceso a la promoción.
Al ser una comprobación en tiempo real cada vez que el usuario introduce el código se realiza la llamada al web service. Esta llamada tiene un timeout de 2 segundos. La implementación del web service, por tanto, debe ser capaz de devolver el código 200 en menos de dos segundos para no perjudicar la experiencia del usuario, en caso contrario la validación fallará.
Cabeceras
Configura las cabeceras de la llamada con los requisitos de autenticación de tu web service.
La configuración de Cabeceras es especialmente importante ya que permite proteger la url del cliente con tokens privados y evitar que la API sea consultada con posibles ataques de fuerza bruta. Las peticiones a la API se realizan de servidor a servidor, con lo que estos tokens nunca serán visibles desde el navegador del usuario.
URL del Web service
La URL del servicio debe apuntar al endpoint programado por el cliente. Este endpoint requiere que se añada la variable {EMAIL} en la propia url o como parámetro GET. Esta variable se sustituirá por el email introducido por el usuario.
Ejemplos de URLs válidas para comprobar el email:
https://mypromo.com/validate/{EMAIL} | https://mypromo.com/validate/aaa@gmail.com |
https://mypromo.com/validate?email={EMAIL} | https://mypromo.com/validate?email=aaa@gmail.com |
https://mypromo.com/{EMAIL}/validate | https://mypromo.com/aaa@gmail.com/validate |
Si en vez de validar emails, validas códigos de cliente, deberás utilizar el parámetro {CUSTOMER_NUMBER}
https://mypromo.com/validate/{CUSTOMER_NUMBER} | https://mypromo.com/validate/66778A3R |
https://mypromo.com/validate?code={CUSTOMER_NUMBER} | https://mypromo.com/validate?email=66778A3R |
https://mypromo.com/{CUSTOMER_NUMBER}/validate | https://mypromo.com/66778A3R/validate |
Testing
Se puede usar la función de [Realiza un test] para probar distintos emails y ver la respuesta. Para cada email introducido se muestra la respuesta del web service en la pantalla emergente del test, por ejemplo:
Para poder probar esta función antes de programar la URL definitiva hemos creado dos URLs de prueba, una que responde siempre con un código 200, aceptando el email. Y otra que devuelve un código 404, rechazando cualquier email.
Estas URLs son:
- https://wl.easypromosapp.com/v24/ok/{EMAIL} - Para el caso de todo OK
- https://wl.easypromosapp.com/v24/ko/{EMAIL} - Para el caso de todo ERROR
En caso de validar códigos de cliente en vez de emails, las URLs son:
- https://wl.easypromosapp.com/v24/ok/{CUSTOMER_NUMBER} - Para el caso de todo OK
- https://wl.easypromosapp.com/v24/ko/{CUSTOMER_NUMBER} - Para el caso de todo ERROR
Si por ejemplo configuramos la URL de siempre error en el Editor de una promoción tal como vemos en esta imagen:
El usuario nunca podrá entrar en la promoción ya que siempre obtendrá un error.
Por supuesto, estas URLs sólo son de prueba. El cliente debe implementar una url pública donde se pueda enviar un email para ser validado. Para evitar un uso malicioso de estas urls se pueden usar los campos header para enviar tokens de seguridad.
NOTA: En caso que esta configuración de llamada a un web service externa no encajara con tu servicio actual, será necesario programar y alojar un conector intermedio que haga la interconexión de los dos servicios. Si necesitas un conector, puedes contactar con nuestro equipo comercial de Easypromos para pedir presupuesto para el desarrollo, alojamiento y mantenimiento del conector.
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.