Integre sua conta Connectif com Reskyt para poder enviar notificações push nativas através do aplicativo.
Neste artigo, você aprenderá como integrar sua conta Connectif com Reskyt para coletar a atividade do contato e um exemplo de um workflow no qual é enviada uma notificação push para Reskyt.
Tempo de implementação: 1 hora.
Dificuldade: Intermediário
Quando usar?: Para enviar notificações push pelo aplicativo.
Este é um exemplo das muitas possibilidades que esta integração oferece. Seguindo os princípios básicos explicados neste artigo, você poderá criar mais estratégias de envio de push que ajudarão a cumprir seus objetivos.
Por que implementar a extensão
1. Casos de uso que você poderá criar após esta integração
Aqui deixamos algumas ideias que podem servir para implementar diferentes estratégias no aplicativo Reskyt após ativar a extensão com Reskyt em sua Loja Connectif.
- Recuperar carrinhos abandonados.
- Realizar estratégias de remarketing através das pushs do Reskyt.
- Enviar uma felicitação de aniversário para os contatos.
- Enviar um desconto pelo aniversário da primeira compra.
2. O que você poderá fazer com Connectif no Reskyt?
Com esta extensão, a partir do Connectif você poderá criar estratégias automatizadas para enviar notificações push pelo app Reskyt.
Além disso, poderá coletar a atividade do contato no Reskyt.
3. Quais dados do Connectif você poderá usar no Reskyt?
Além disso, no Reskyt você poderá aproveitar todas as informações coletadas no perfil 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 ter em mente
Para poder integrar sua conta Connectif com Reskyt e automatizar o envio de notificações push nativas, você precisará:
Solicitar a Reskyt a ativação da API e seu valor, para poder utilizá-la.
Além disso, você deve considerar algumas propriedades das notificações push móveis enviadas pelo 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 pushs móveis não possuem estatísticas nem análises de envios, aberturas ou cliques.
- O número de cliques poderia ser recuperado por meio de opções UTM no link, mas não é um valor coletado por padrão.
- O contato terá no máximo um dispositivo, pois só pode ser armazenado um token no campo personalizado.
- Dois ou mais contatos podem ter o mesmo token do Reskyt, pois podem, por exemplo, iniciar várias sessões no mesmo dispositivo.
PASSO 1: Criação do campo personalizado que armazenará o token do Reskyt
(Nesta seção será criado o campo personalizado que coletará o Token do Reskyt, ou seja, o identificador do contato no App).
1. Vá para "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.
Para que a integração funcione e o token seja armazenado no Connectif, é importante que o campo personalizado tenha este nome e este ID.
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 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 no Reskyt via inline).
4. Vá para 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ó disparador "Ao visitar página" para que o workflow seja ativado no momento em que um contato visitar 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 do nó "Ao visitar página" e arraste-o para a coluna esquerda do painel central.
10. Selecione, da coluna direita, o valor Literal e arraste-o para o painel central, à coluna direita. Em seguida, insira neste valor o texto "rktwebview".
O valor indicado é o que o Reskyt atribui por padrão. Você pode modificá-lo, mas se fizer isso deverá indicar neste campo o valor que você atribuiu em vez de "rktwebview".
11. Clique em Atualizar.
Dessa forma, o Connectif verificará que, durante a navegação, a página contém o valor "rktwebview" no parâmetro User Agent. Essa informação é enviada diretamente pelo Reskyt para indicar que um contato está navegando através do seu aplicativo.
12. Adicione o nó do tipo ação "Enviar conteúdo web" para inserir o Script que verificará a atividade do contato pelo Reskyt.
13. Não edite a ligação deste 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 o 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");
if (!reskytToken) {
return;
}
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>Este Script coleta o token do Reskyt de um cookie e o armazena no campo personalizado "reskyt-token".
17. Clique em Salvar para manter as modificações e em Voltar ao seletor para retornar e finalizar a configuração do nó.
18. Uma vez selecionado o conteúdo Inline que você acabou de criar, clique em Próximo .
19. Em Configuração, adicione o seletor adequado para mostrar 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 mostrar pushes no Reskyt
(Nesta seção será criado o evento que enviará a informação do Connectif para o Reskyt para permitir que as notificações push sejam exibidas dentro do App).
22. Acesse Configuração da loja no menu lateral esquerdo.
23. Na aba de seleção, 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. Nesta tela, atribua um nome ao evento.
27. No campo URL do Webhook para enviar a mensagem, cole a URL da API do Reskyt para enviar notificações push. Neste caso, a URL é "https://push.api.reskyt.com/push/send".
Se precisar de mais informações sobre a API do Reskyt, acesse sua documentação.
28. Clique em Adicionar um novo cabeçalho e atribua o Nome "x-api-key" e, no Valor, insira o valor da API do Reskyt.
Você deverá solicitar este valor ao Reskyt, assim como a ativação da API, para poder usá-la.
29. Clique em Adicionar um novo campo para criar cada um dos campos personalizados e complete suas informações:
- Crie um campo com nome e 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 uma oferta, para que pare de ser enviada quando a oferta terminar.
- Crie um campo com nome e ID "pictureUrl" do tipo Texto.
- Crie um campo com nome e ID "title" do tipo Texto e marque-o como obrigatório.
- Crie um campo com nome e 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 nome e ID "url" do tipo Texto.
- Crie um campo com nome e ID "utmCampaign" do tipo Texto.
- Crie um campo com nome e ID "heading" do tipo Texto e marque-o como obrigatório.
30. Clique em Salvar.
PASSO 4: Criação do workflow para enviar uma notificação push no Reskyt
(Nesta seção será criada a estratégia que enviará uma notificação push para o app Reskyt).
Recomendamos criar um segmento dinâmico plus para filtrar os contatos que não tenham o campo personalizado reskyt-token vazio. Assim, a estratégia será ativada apenas para os contatos do Reskyt, evitando que o Connectif precise buscar em toda sua base de contatos.
31. Vá para 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 do Reskyt.
34. Procure o nó do tipo ação que você criou ao fazer sua integração com 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 faça coincidir com o valor "Tokens" da coluna direita. Os demais valores, associe a um campo Literal para dar a forma e informação que sua push conterá no Reskyt.
O campo dateEnd deve estar no formato Timestamp. Você pode usar este conversor para obter o formato da data que deseja inserir. Além disso, o Reskyt define como data limite 2 meses após o envio.
36. Clique em Atualizar para salvar a configuração do nó e ative seu workflow.
Sucesso!
A integração da sua conta Connectif com Reskyt está pronta.
Continue aprendendo!
Para aproveitar todo o potencial da sua conta no Connectif, recomendamos continuar com os seguintes artigos:
Integração personalizada para receber dados, para aprender como usar informações que não são registradas por padrão na plataforma.
Webhooks predefinidos, para integrar sua conta Connectif com WhatsApp, Doofinder e outros webhooks do seu site.
Casos de Uso, para obter ideias e modelos de estratégias que você pode aplicar em sua Loja.
Integrações via API, para administrar eventos como registros de compras ou cadastros de contatos.