No Connectif é possível receber dados de sistemas externos para utilizar informações que não são registradas por padrão na plataforma. Por meio de uma integração personalizada, você poderá sincronizar os dados dos seus contatos com base em eventos gerados em outras plataformas.
Neste artigo, você aprenderá como criar uma integração personalizada para receber dados.
Tempo de implementação: 20 minutos.
Dificuldade: Média
Quando usar?: Quando for necessário receber no Connectif dados gerados em sistemas ou aplicações externas.
PASSO 1 - Criação da integração personalizada
1. Acesse "Integrações > Personalizadas" e clique em Criar nova integração.
Caso esteja trabalhando com um ERP, recomendamos seguir estas etapas para sincronizar os dados com sua conta do Connectif.
2. Defina o campo "Nome" para identificar a integração.
3. (Opcional) Personalize a cor, inclua uma descrição ou categorize a integração.
4. Clique em Salvar.
5. Na aba Receber dados, clique em Criar novo evento de recepção.
PASSO 2 - Configuração do evento "Receber Dados"
(Nesta seção, serão configurados os campos onde os dados recebidos serão armazenados).
6. Clique em Adicionar um novo campo para criar um campo personalizado e preencha os campos necessários no bloco direito.
Para saber mais sobre campos personalizados, clique aqui.
É importante que o campo de e-mail seja do tipo "e-mail" e esteja marcado como Obrigatório e É chave primária, pois será utilizado para identificar o contato.
7. Repita a ação indicada no passo anterior quantas vezes forem necessárias para receber todos os dados.
8. Clique em Salvar e, na tela de confirmação, clique em Voltar à lista de eventos.
PASSO 3 - Obtenção do endpoint de notificação
(Nesta seção, explicaremos como gerar o endereço para notificar o tipo de evento criado, o endpoint).
O funcionamento do endpoint é análogo ao conceito de webhook: é um sistema que aguarda a ocorrência de um evento e reage transferindo os dados para outra aplicação ou sistema, neste caso para o Connectif, usando uma chamada HTTP.
9. Na aba Receber dados, clique em Editar.
10. Clique em Copiar URL para salvar no clipboard o endereço do endpoint.
PASSO 4 - Envio de dados para o Connectif
(Nesta seção, explicamos como estabelecer a comunicação com o endpoint e enviar dados).
11. Realize a chamada ao endpoint para notificar os dados do evento. A imagem a seguir mostra uma chamada JSON realizada com o Postman, seguindo o exemplo ilustrado no artigo.
Aprenda como notificar eventos personalizados via JavaScript neste artigo.
A chamada deve ser uma requisição POST para o endpoint selecionado com o formato JSON. No corpo da chamada, é necessário especificar os IDs dos campos configurados no evento.
PASSO 5 - Sincronização dos dados com as informações do contato
(Nesta seção, explicamos como sincronizar os dados no Connectif através de um workflow).
12. Acesse “Workflows”, clique em Criar novo workflow e selecione Criar workflow em branco.
13. Crie a estrutura do seu workflow com o nó do tipo disparador “Disparador [nome da sua integração]” e o nó do tipo ação “Definir campo”.
14. No nó “Disparador Receber dados de…”, clique em (Editar configuração do nó).
15. Verifique se os dados coletados pelo nó "Disparador Receber dados de...", provenientes do evento no sistema externo, estão corretos.
Se os dados não forem adequados, você pode editá-los na configuração do evento de recepção (PASSO 2).
16. Clique em Salvar.
17. No nó “Definir campo”, clique em (Editar configuração do nó).
18. Relacione as variáveis para atribuir as informações coletadas pela integração personalizada aos campos de contato correspondentes.
Para aprender mais sobre como atribuir variáveis no nó "Definir campo", clique aqui.
19. Clique em Atualizar.
20. No workflow, clique em Salvar para salvar as alterações e em Iniciar para ativá-lo.
Extra: Criação de um Segmento Dinâmico Plus da integração
Com o Connectif, você pode criar um Segmento Dinâmico Plus para filtrar atividades e campos relacionados à integração personalizada.
Se você quiser aprender como criar um Segmento Dinâmico Plus com os contatos da sua integração, confira este artigo.
Uma vez que você criar um segmento de contatos da integração personalizada, este não poderá ser excluído. Além disso, se algum de seus campos estiver sendo usado como condição de segmentação, ele também não poderá ser apagado ou editado.
Sucesso!
Sua integração personalizada está pronta para receber dados.
Continue aprendendo!
Para aproveitar ao máximo sua conta no Connectif, recomendamos continuar com os seguintes artigos:
- Integração personalizada para enviar dados, para enviar dados do Connectif para sistemas ou aplicações externas.
- Detectar e reagir a links web criados fora do Connectif, para identificar e reagir aos cliques em qualquer link do seu site.
-
Integração com Facebook e Instagram, para gerenciar as audiências da sua conta de Facebook Ads com o Connectif.
-
Formulários integrados, para detectar e coletar no Connectif formulários já existentes no seu site.