Integração com Spoki

Sincronize sua conta do Connectif com a ferramenta Spoki para criar campanhas de mensagens diretas no WhatsApp personalizadas para cada contato.

Neste artigo, você aprenderá como integrar sua conta do Connectif com o Spoki e automatizar o envio de mensagens quando o contato abandonar o carrinho. 

  

Tempo de implementação: 1h.
Dificuldade: Intermediário
Quando usar?:
Para criar campanhas com WhatsApp.

 

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 mensagens que ajudarão a alcançar seus objetivos.

Antes de começar: requisitos prévios

Para integrar sua conta do Connectif com o Spoki e automatizar campanhas de WhatsApp, você precisará de:

Você encontrará mais informações sobre como criar seus templates na área de "Templates" do Spoki, clicando no botão de  (informação).

Spoki_-_1-min.png

 

Ao criar seu template, é fundamental indicar quais campos dinâmicos ele terá, pois serão os campos enviados pelo Connectif com as informações personalizadas para o usuário.

Nos templates, existem dois tipos de campos:

  • Campos de Registro: fornecidos pelo Spoki.
  • Campos Dinâmicos: campos personalizados. Estes devem sempre estar em letras maiúsculas. No template de exemplo, existem dois campos dinâmicos:
    • CHECKOUT URL (URL do checkout).
    • TOTAL AMOUNT (quantidade total de itens).

Spoki_-_24-min.png

 

PASSO 1. Criação da automação no Spoki

1. Acesse sua conta no Spoki.

2. Vá para a seção Automations.

3. Clique em New.

Spoki_-_2-min.png

4. Atribua um nome à sua automação.

5. Clique em   Add Boot Step.

Spoki_-_3-min.png

6. Na janela que se abrir, selecione Integration e procure por Connectif.

Spoki_-_4-min.png

7. Guarde a URL que será exibida, essa será a URL do WebHook que você utilizará posteriormente no Connectif.

 

Guarde este endereço! Este é o endpoint onde as informações enviadas do Connectif serão recebidas, permitindo que você personalize suas mensagens automaticamente. 

Spoki_-_5-min.png

PASSO 2. Seleção do template da mensagem no Spoki

8. Clique em Your Automatic Action.

Spoki_-_6-min.png

9. Em Action Type, filtre por Template.

10. Selecione em When o período de espera para que a ação seja ativada após o disparador ser acionado (neste caso, pelo Connectif).

11. No campo de pesquisa, filtre e selecione o template que deseja enviar.

12. Clique em Add.

Spoki_-_7-min.png

13. Salve as alterações.

 

PASO 3. Criação da integração no Connectif 

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

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

Integracao com Spoki 2023 - 0-min.png

16. Defina o campo "Nome da integração" para identificar a integração.

17. (Opcional) Personalize a cor, inclua uma descrição ou categorize a integração.

Integracao com Spoki 2023 - 1-min.png

18. Clique em  Atualizar.

 

PASO 4. Criação do evento de envio

(Nesta seção, serão configurados os campos que serão compartilhados com o WhatsApp).

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

19. Dentro desta tela, atribua um nome ao evento.

20. Adicione a URL do endpoint que você encontrou anteriormente no Spoki (passo 1) no campo "Webhook URL onde enviar a mensagem".

Integracao com Spoki 2023 - 2-min.png

 

4.1. Criação da estrutura da mensagem no Connectif

(Nesta seção, serão configuradas as propriedades da mensagem que será enviada, com base no template do Spoki. No exemplo, é documentada a criação de uma estrutura real e prática de uma mensagem).

21. Para enviar as informações para o Spoki, é necessário replicar a estrutura do JSON do template. No exemplo do template “Contact Data”, o arquivo JSON a ser replicado é:

{
"phone": "+393931256677", //obrigatório
"first_name": "Maria",
"email": "maria.ross@example.com",
}

22. Clique em   Adicionar novo campo.

Integracao com Spoki 2023 - 3-min.png

23. Selecione o tipo de campo (texto, e-mail, etc.).

 

Encontre mais informações sobre os campos de contato neste artigo.

24. Adicione um Nome e uma ID.

25. Marque, nos campos necessários, a caixa Ativar opções JSON.

  

É necessário ativar as opções JSON quando for preciso enviar valores de objetos aninhados no JSON, ou seja, quando for necessário simular uma estrutura complexa com objetos aninhados ou arrays.

26. Copie o caminho e cole no Connectif.

27. Edite o caminho, substituindo o (x.) no início e os (.) por barras invertidas.

 

Por exemplo, se o caminho JSON for x.custom_fields.TOTAL_AMOUNT, você deve alterá-lo para /custom_fields./TOTAL_AMOUNT.

28. Atribua um nome e uma ID ao campo.

 

DICA PRO: atribua o mesmo nome ao campo no Connectif e ao caminho JSON para facilitar a localização.

Integracao com Spoki 2023 - 4-min.png

29. Repita este passo com todas as propriedades que serão transmitidas, até que tenha replicado o template.

30. Clique em   Salvar para registrar todos os campos.

Integracao com Spoki 2023 - 5-min.png

 

PASO 5. Criação do workflow para automatizar o envio de mensagens no WhatsApp 

(Nesta seção, explicaremos como enviar os dados do Connectif através de um workflow).

31. Acesse Workflows e clique em    Criar novo workflow.

Integracao com Spoki 2023 - 6-min.png

32. Selecione um novo workflow em branco.

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

36. Adicione o nó disparador "Ao abandonar o carrinho" para que o workflow seja ativado no momento em que um visitante do seu site adicione produtos ao carrinho e não complete a compra.

Integracao com Spoki 2023 - 7-min.png

37. Edite o nó para remover as limitações e clique em   Atualizar.

Integracao com Spoki 2023 - 8-min.png

38. Procure o nó do tipo ação que você criou ao fazer sua integração com Spoki (passo 4) e adicione-o ao seu workflow.

  

Quando o contato abandonar o carrinho, queremos informar o evento ao Spoki. 

Integracao com Spoki 2023 - 9-min.png

39. Configure o nó atribuindo as variáveis aos respectivos valores:

  • As variáveis do contato (nome, sobrenome, telefone e e-mail) vêm da informação do Contato.
  • A informação da propriedade do carrinho (TOTAL AMOUNT) é obtida através do nó Ao abandonar o carrinho.
  • A URL do checkout é definida manualmente por meio de um valor do tipo Literal.

Integracao com Spoki 2023 - 10-min.png

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

41. No workflow, clique em  Salvar para salvar as alterações e em  Iniciar para ativá-lo.

 

 

Sucesso!
A integração da sua conta do Connectif com o Spoki está pronta.

 


Continue aprendendo!

Para aproveitar ao máximo sua conta no Connectif, recomendamos continuar com os seguintes artigos: