A integração por meio de API é a opção de integração personalizada com Connectif que permite controle total sobre os dados enviados, mas só permite sincronizar Contatos, Produtos, Compras e Cupons. Os demais eventos deverão ser integrados por meio de outras opções, etiquetas HTML ou eventos JavaScript.
Para realizar este tipo de integrações, você precisará de um especialista com conhecimentos em programação para poder obter dados do seu eCommerce e realizar chamadas HTTP para uma API REST.
Antes de começar: vantagens e limitações de uma integração por API
Sobre as vantagens:
- Não depende do cliente, já que será uma chamada HTTP onde você poderá controlar a resposta recebida para garantir que o evento chegou e foi processado corretamente.
- Podem ser realizadas importações em massa. Enquanto que com as outras opções, a atualização é sempre feita um a um.
As possíveis limitações de uma integração via API são as seguintes:
- Requer um departamento de TI capaz de realizar as chamadas necessárias para a API do Connectif.
- Existe um número máximo de chamadas à API permitido por minuto, de modo que, para realizar operações em massa, recomenda-se utilizar a API de importações, onde uma única chamada é capaz de sincronizar múltiplos elementos.
- Não é possível integrar todos os eventos por meio da API, sendo necessário combinar esta opção com outras formas de integração.
Aprenda como funciona a API do Connectif neste artigo.
Como integrar o Connectif via API?
1. Adicionar o JavaScript do Connectif
Configure o JavaScript do Connectif no site para que carregue em todas as páginas e possa integrar por meio de eventos.
2. Sincronizar via API
Configure a sincronização de informações sobre:
- Contatos: para registrar os dados dos visitantes do eCommerce.
- Produtos: para sincronizar o catálogo.
- Compras: para descrever as compras realizadas pelos clientes.
-
Cupons: para sincronizar os códigos de cupom e seus usos.
3. Sincronizar o resto dos eventos por meio de outro método
3.1. Etiquetas HTML renderizadas no servidor ou no cliente:
- Etiqueta de "Estado atual do carrinho de compras": para descrever o carrinho de compras que o contato possui em um momento determinado.
- Etiqueta de "Etiqueta de página": para atribuir uma etiqueta a uma página.
- Etiqueta de "Categoria de página": para atribuir uma categoria de produto a uma página.
- Etiqueta de "Contato visitou um produto": para notificar que o contato visitou um produto específico durante sua navegação no site.
A sincronização do catálogo de produtos será realizada via API, portanto será necessário desativar a sincronização e verificação automáticas. Para enviar o evento de "Contato visitou produto" não é necessário que o HTML seja renderizado no servidor.
- Etiqueta de "Contato buscou um produto": para identificar uma visita a um produto como resultado direto de uma busca pelo mesmo.
- Etiqueta de " Contato fez login": para indicar que o contato fez login.
- Etiqueta de "Contato se registrou": para indicar um novo registro.
-
Etiqueta de "Assinatura da newsletter": para indicar que um contato assinou a newsletter.
3.2. Eventos enviados por meio de JavaScript:
- Notificação de página visitada: para notificar que o contato visitou uma página durante sua navegação no site.
- Notificação de produto visitado: para notificar que o contato visitou um produto específico durante sua navegação no site.
- Notificação de informações do carrinho: para descrever o carrinho de compras que o contato possui em um momento determinado.
- Notificação de busca realizada: para indicar que uma busca foi realizada e identificar quais termos foram usados.
- Notificação de login: para indicar que o contato fez login.
- Notificação de registro: para indicar um novo registro.
-
Notificação de assinatura da newsletter: para indicar que um contato assinou a newsletter.
5. Configurar as Web Push
Para completar a integração, você também deverá configurar o Service Worker para poder receber assinaturas de Web Push e enviar notificações aos seus contatos.
- Comece a gerenciar as notificações Web Push.
6. Validar a integração
Uma vez implementado o envio de informações para o Connectif, o próximo passo será validar que a integração foi realizada corretamente.
Parabéns!
Você chegou ao final da lição.
Tem dúvidas não resolvidas?
Lembre-se que você tem à disposição nossos especialistas no Connectif. Para contatá-los, basta abrir um ticket de Suporte clicando no botão azul de “Ajuda” no seu painel de controle.
Siga aprendendo!
Para aproveitar todo o potencial da sua conta no Connectif, recomendamos continuar com os seguintes artigos:
-
Onboarding, para adquirir habilidade com nossa interface.
-
Workflows iniciais, para implementar suas primeiras estratégias na conta.
-
Integrações com sistemas externos, para se integrar com Facebook, formulários e webhooks do seu site.
-
Eventos que consomem Atividades, para compreender melhor o consumo da sua conta.