Integração com Reskyt

Se você tem seu eCommerce na Reskyt, integre sua conta do Connectif com a Reskyt para poder enviar notificações push nativas através do aplicativo.

Neste artigo, você aprenderá como integrar sua conta do Connectif com a Reskyt para coletar a atividade do contato e um exemplo de um workflow em que é enviada uma notificação push para a Reskyt. 

Por que implementar a extensão

1. Casos de uso que você poderá criar após essa integração

Aqui estão algumas ideias que podem ajudá-lo a implementar diferentes estratégias no aplicativo da Reskyt após ativar em sua Loja do Connectif a extensão com a Reskyt.

• Recuperar carrinhos abandonados.
• Realizar estratégias de remarketing através das push da Reskyt.
• Enviar uma felicitação de aniversário aos contatos.
• Enviar um desconto pelo aniversário da primeira compra.

2. O que você poderá fazer com o Connectif na Reskyt?

Com esta extensão, a partir do Connectif, você poderá criar estratégias automatizadas para enviar notificações push através do app da Reskyt.

Além disso, poderá coletar a atividade do contato na Reskyt.

3. Que dados do Connectif você poderá usar na Reskyt?

Da mesma forma, na Reskyt você poderá aproveitar todas as informações coletadas na ficha do contato, assim como sua atividade em tempo real, para personalizar as notificações com os dados do contato do Connectif.

Antes de começar: o que você deve levar em conta

Para poder integrar sua conta do Connectif com a Reskyt e automatizar o envio de notificações push nativas, você precisará:

• Solicitar à Reskyt a ativação da API e seu valor, para poder utilizá-la.

Além disso, você deve levar em conta algumas propriedades das notificações push móveis enviadas através da Reskyt:

• Não é possível cancelar a inscrição de um contato nessas notificações, pois não existe um mecanismo que notifique em caso de erro na entrega.
• As push móveis não possuem estatísticas nem análise de envios, aberturas ou cliques. 
  • O número de cliques poderia ser recuperado através de opções de UTM no link, mas não é um valor coletado por padrão.
• O contato terá, no máximo, um dispositivo, pois apenas um token pode ser armazenado no campo personalizado.
• Dois ou mais contatos podem ter o mesmo token da Reskyt, pois podem, por exemplo, iniciar várias sessões no mesmo dispositivo. 

PASSO 1: Criação do campo personalizado que armazenará o token da Reskyt 

(Nesta seção será criado o campo personalizado que armazenará o Token da Reskyt, ou seja, o identificador do contato no App).  

1. Acesse "Contatos > Campos do Contato" e clique em    Adicionar novo campo personalizado.

2. Atribua o tipo Texto e clique em Ir para o editor.

3. Atribua o Nome e o ID "reskyt-token" e clique em   Salvar.

PASSO 2: Criação do workflow para coletar o token do contato  

(Nesta seção será criado o workflow que coletará a atividade do contato durante sua navegação pelo app da Reskyt e atualizará, no Connectif, o campo personalizado que você criou no PASSO 1. Esta atividade será coletada por meio de um script que será inserido na Reskyt via inline).

4. Acesse Workflows e clique em    Criar novo workflow.

5. Selecione um novo workflow em branco.

6. No "Nó Início", selecione Todos os contatos da minha lista.

7. Adicione o nó gatilho "Ao visitar página" para que o workflow seja ativado no momento em que um contato visite o site. Na configuração do nó, na aba Limitações, remova todas as limitações.

8. Adicione o nó do tipo condição "Verificar valor" e acesse o editor do nó.

9. Na configuração do nó  "Verificar valor" selecione o operador User Agent, obtido no nó "Ao visitar página" e arraste-o para a coluna esquerda do painel central.

10. Selecione, na coluna direita, o valor Literal e arraste-o para o painel central, na coluna direita. Em seguida, insira nesse valor o texto "rktwebview".

11. Clique em   Atualizar.

12. Adicione o nó de tipo ação "Enviar conteúdo web" para inserir o Script que verificará a atividade do contato na Reskyt.

13. Não edite a união desse nó com o nó "Verificar valor", para que apareça "Sim".

14. Clique em  (Editar configuração do nó) do nó “Enviar conteúdo web” e  Criar novo conteúdo para gerar um novo conteúdo.

15. Ao criar um novo conteúdo, selecione como tipo Inline, atribua um nome, por exemplo "Script Reskyt", e clique em   Criar novo conteúdo. 

16. Adicione um componente do tipo HTML e edite-o, copiando e colando o seguinte código:

<script>
(function connectifReskyt(global) {

  if (global.connectif &&

      global.connectif.managed &&

      global.connectif.managed.isInitialized()) {

    getReskytToken();

  } else {

    global.document.addEventListener(

      "connectif.managed.initialized",

      function onConnectifInitialized() {

        getReskytToken();

      }

    );

  }

  function getReskytToken() {

    var reskytToken = getCookie("token_md5") || "";

    var previousReskytToken = global.sessionStorage.getItem("cn_reskyt_token");

    if (reskytToken !== previousReskytToken) {

      global.connectif.managed.sendEvents([], {

        entityInfo: { "reskyt-token": reskytToken },

        onResponded: function onResponded() {

            global.sessionStorage.setItem("cn_reskyt_token", reskytToken);

        }

      });

    }

  }

  function getCookie(name) {

    var value = "; " + global.document.cookie;

    var parts = value.split("; " + name + "=");

    if (parts.length === 2) return parts.pop().split(";").shift();

  }

})(window);
</script>

17. Clique em  Salvar para manter as modificações e em   Voltar ao seletor para retornar e finalizar a configuração do nó.

18. Depois de selecionar o conteúdo Inline que você acabou de criar, clique em Próximo .

19. Em Configuração, adicione o seletor adequado para exibir o conteúdo. Neste caso, é recomendável incluir o conteúdo na página do produto ou outra página que seja renderizada tanto na web quanto no App.

20. Na aba Limitações, remova todas as limitações do nó. Por fim, clique em Finalizar para salvar a configuração do nó.

21. Salve e ative o Workflow.

PASSO 3: Criação do evento de envio de dados para exibir pushes na Reskyt

(Nesta seção será criado o evento que enviará as informações do Connectif para a Reskyt, permitindo que as notificações push sejam exibidas no App).

22. Acesse Configuração da loja no menu lateral esquerdo.

23. No seletor de abas, vá para "Integrações > Integrações personalizadas (webhooks)" e clique em   Criar nova integração.

24. Defina o campo "Nome da integração" para identificar a integração e clique em  Atualizar.

25. Na aba Enviar dados, clique em  Criar novo evento de envio.

26. Dentro dessa tela, atribua um nome ao evento.

27. No campo Webhook URL para envio da mensagem, cole a URL da API da Reskyt para envio de notificações push. Neste caso, a URL é "https://push.api.reskyt.com/push/send".

28. Clique em Adicionar uma nova cabeçalho e atribua o Nome "x-api-key" e, no Valor, insira o valor da API da Reskyt.

29. Clique em   Adicionar um novo campo para criar cada um dos campos personalizados e complete as informações:

• Crie um campo com o nome e o ID "dateEnd" do tipo Texto.

Embora não seja obrigatório adicionar a data de término, é recomendável, por exemplo, em estratégias onde desejamos enviar uma push informando sobre uma oferta, para que deixe de ser enviada quando essa oferta terminar.

• Crie um campo com o nome e o ID "pictureUrl" do tipo Texto.
• Crie um campo com o nome e o ID "title" do tipo Texto e marque-o como obrigatório.
• Crie um campo com o nome e o ID "tokens" do tipo Texto e marque-o como obrigatório. Ative as opções JSON e atribua o parâmetro "/tokens/0".

• Crie um campo com o nome e o ID "url" do tipo Texto.
• Crie um campo com o nome e o ID "utmCampaign" do tipo Texto.

30. Clique em  Salvar.

PASSO 4: Criação do workflow para enviar uma notificação push na Reskyt

(Nesta seção será criada a estratégia que enviará uma notificação push para o aplicativo da Reskyt).

31. Acesse Workflows e clique em    Criar novo workflow e selecione um Novo workflow em branco.

32. No "Nó Início", selecione o Segmento Dinâmico Plus que você criou para filtrar os contatos da Reskyt. 

34. Busque o nó do tipo ação que você criou ao fazer sua integração com a Reskyt (passo 3) e adicione-o ao seu workflow.

35. Na configuração do nó, arraste o campo "reskyt-token" das informações do contato e associe-o ao valor "Tokens" da coluna direita. Os demais valores devem ser associados a um campo Literal para definir o formato e as informações que sua push na Reskyt conterá.

36. Clique em  Atualizar para salvar a configuração do nó e ative seu workflow.