Integração Front End

Esta página explica os requisitos de integração para poder integrar o Fast Track Rewards. Este guia é para marcas que não integraram o Fast Track Front End Javascript SDK anteriormente (e que não pretendem integrar o Fast Track Rewards junto com o Fast Track Javascript SDK para Notificações On Site e Rich Inbox).
Se você pretende integrar o Fast Track Rewards Front End junto com o Fast Track Javascript SDK para Notificações On Site e Rich Inbox, leia este artigo em vez disso »​

Passo 1: Mecanismo de autenticação (JWT)

No seu backend, você precisa gerar um JWT Token que esteja em conformidade com as Especificações Oficiais JWT. Este JWT Token deve conter o id do usuário atualmente logado e o JWT Token deve ser codificado com um segredo que você compartilhará com seu Fast Track Partner Manager ou Integration Manager.
Recomendações
  1. Se você já está usando JWT para sua própria autenticação no seu site, recomendamos que implemente uma funcionalidade separada especificamente para FT rewards.
  2. Mantenha a expiração do token curta e reautentique se necessário. Você pode usar a função SDK window.updateFtJwtToken(newToken) para atualizá-lo dentro da mesma sessão.
  3. Suportamos dois algoritmos, RSA e HMAC. Recomendamos usar RSA com chaves públicas e privadas.

Exemplo de payload JWT

Passo 2: Configurar o objeto de configuração

Adicione este código javascript no seu front end, preferencialmente o mais cedo possível.

Passo 3: Carregar o Javascript SDK

Copie este trecho exatamente como está e cole no seu código front end, diretamente após onde você colou o objeto de configuração (seção acima).

Passo 4: Conectar evento de clique para abrir "Minhas Recompensas"

Abaixo descreve como você pode usar os Fast Track Rewards Web Components para mostrar o "Modal Minhas Recompensas".

HTML:

Você pode colocar qualquer elemento HTML dentro do elemento Fast Track ft-my-rewards-toggle. A visibilidade deste elemento HTML e seu conteúdo é controlada pelo FT CRM.

CSS:

Para fazer o elemento ft-my-rewards-toggle ficar oculto por padrão, você pode adicionar o CSS abaixo.

Como reautenticar Recompensas

Essas funções no SDK podem ser usadas quando um usuário faz logout e login novamente sem atualizar a página. Ou para reautenticar com um novo token JWT. Por favor, note que pode diferir de como reautenticar com as notificações OnSite.
window.logoutFtRewards() Faz logout do usuário atual e eles não verão mais Recompensas.
window.updateFtJwtToken("newJWTToken") Atualizará o token JWT existente que é usado dentro do FT Rewards, populando a variável window.sid.
window.initFtRewards() inicializa o componente Rewards para o usuário logado. Procura pelo window.sid para o token JWT com o qual autenticar.

O fluxo ilustrado

​
​