Integraci贸n de Front End

Esta p谩gina explica los requisitos de integraci贸n para poder integrar Fast Track Rewards. Esta gu铆a es para marcas que no han integrado Fast Track Front End Javascript SDK anteriormente (y que no pretenden integrar Fast Track Rewards junto con Fast Track Javascript SDK para Notificaciones en Sitio y Rich Inbox).
Si pretendes integrar Fast Track Rewards Front End junto con Fast Track Javascript SDK para Notificaciones en Sitio y Rich Inbox, lee este art铆culo en su lugar 禄​

Paso 1: Mecanismo de autenticaci贸n (JWT)

En tu backend, necesitas generar un JWT Token que se ajuste a las Especificaciones JWT Oficiales. Este JWT Token debe contener el id del usuario actualmente conectado y el JWT Token debe estar codificado con un secreto que compartir谩s con tu Fast Track Partner Manager o Integration Manager.
Recomendaciones
  1. Si ya est谩s usando JWT para tu propia autenticaci贸n en tu sitio, recomendamos que implementes una funcionalidad separada espec铆ficamente para FT rewards.
  2. Mant茅n la expiraci贸n del token corta y vuelve a autenticar si es necesario. Puedes usar la funci贸n SDK window.updateFtJwtToken(newToken) para actualizarlo dentro de la misma sesi贸n.
  3. Soportamos dos algoritmos, RSA y HMAC. Recomendamos usar RSA con claves p煤blicas y privadas.

Ejemplo de payload JWT

Paso 2: Configurar el objeto de configuraci贸n

Agrega este c贸digo javascript en tu front end, preferiblemente lo m谩s temprano posible.

Paso 3: Cargar el Javascript SDK

Copia este fragmento exactamente como est谩 y p茅galo en tu c贸digo front end, directamente despu茅s de donde pegaste el objeto de configuraci贸n (secci贸n anterior).

Paso 4: Conectar evento de clic para abrir "Mis Recompensas"

A continuaci贸n se describe c贸mo puedes usar Fast Track Rewards Web Components para mostrar el "Modal de Mis Recompensas".

HTML:

Puedes poner cualquier elemento HTML dentro del elemento Fast Track ft-my-rewards-toggle. La visibilidad de este elemento HTML y su contenido es controlada desde FT CRM.

CSS:

Para hacer que el elemento ft-my-rewards-toggle est茅 oculto por defecto puedes agregar el CSS a continuaci贸n.

C贸mo reautenticar Rewards

Estas funciones en el SDK pueden usarse cuando un usuario cierra sesi贸n y vuelve a iniciar sesi贸n sin refrescar la p谩gina. O para reautenticar con un nuevo token JWT. Ten en cuenta que puede diferir de c贸mo reautenticar con las notificaciones OnSite.
window.logoutFtRewards() Cierra la sesi贸n del usuario actual y ya no ver谩n Rewards.
window.updateFtJwtToken("newJWTToken") Actualizar谩 el token JWT existente que se usa dentro de FT Rewards, poblando la variable window.sid.
window.initFtRewards() inicializa el componente Rewards para el usuario conectado. Busca el window.sid para el token JWT con el cual autenticarse.

El flujo ilustrado

​
​