A integração via 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 devem ser integrados através de outras opções, etiquetas HTML ou eventos JavaScript.
Para realizar esse tipo de integração, você precisará de um especialista com conhecimentos de programação, para 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
Em relação às vantagens:
- Não depende do cliente, pois será uma chamada HTTP onde você poderá controlar a resposta recebida para garantir que o evento chegou e foi processado corretamente.
- É possível realizar importações em massa. Enquanto nas outras opções as atualizações são feitas uma a uma.
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 para a API permitido por minuto, portanto, para operações em massa, recomenda-se utilizar a API de importações, onde uma única chamada pode sincronizar vários elementos.
- Não é possível integrar todos os eventos via API, sendo necessário combinar essa 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 ele carregue em todas as páginas e permita integração através 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 os demais eventos por 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 do contato em um momento específico..
A sincronização do catálogo de produtos será realizada via API, então 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 "Inscrição na newsletter": para indicar que um contato se inscreveu no boletim informativo.
3.2. Eventos enviados via JavaScript:
- Notificação de página visitada: para informar que o contato visitou uma página durante a navegação no site.
- Notificação de produto visitado: para informar que o contato visitou um produto específico durante a navegação no site.
- Notificação de informações do carrinho: para descrever o carrinho de compras que o contato possui em um determinado momento..
- 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 inscrição na newsletter: para indicar que um contato se inscreveu no boletim informativo.
5. Configurar as Web Push
Para concluir a integração, você também deve configurar o Service Worker para poder receber inscrições para Web Push e enviar notificações para seus contatos.
- Comece a gerenciar as notificações Web Push.
6. Validar a integração
Depois de implementar o envio de informações para o Connectif, o próximo passo será validar se a integração foi realizada corretamente.
Parabéns!
Você chegou ao final da lição.
Ficou com dúvidas?
Lembre-se que você tem à disposição nossos especialistas em Connectif. Para contatá-los, basta abrir um ticket de suporte clicando no botão azul "Ajuda" no seu dashboard.
Continue aprendendo!
Para aproveitar ao máximo sua conta no Connectif, recomendamos que continue com os seguintes artigos:
-
Onboarding, para adquirir habilidades com nossa interface.
-
Workflows iniciais, para implementar suas primeiras estratégias na conta.