Integração personalizada para receber dados de sistemas externos

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.

Integração personalizada para receber dados de sistemas externos (interface 2024) - 1-min.png

 

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.

Integração personalizada para receber dados de sistemas externos (interface 2024) - 2-min (1).png

4. Clique em  Salvar.

5. Na aba Receber dados, clique em  Criar novo evento de recepção.

Integração personalizada para receber dados de sistemas externos (interface 2024) - 3-min.png

 

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. 

Integração personalizada para receber dados de sistemas externos (interface 2024) - 4-min.png

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.

Integração personalizada para receber dados de sistemas externos (interface 2024) - 6-min.png

10. Clique em  Copiar URL para salvar no clipboard o endereço do endpoint.

Integração personalizada para receber dados de sistemas externos (interface 2024) - 7-min (2).png

 

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.

Integracao_personalizada_para_receber_dados_-_7.png

 

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”.

Integração personalizada para receber dados de sistemas externos (interface 2024) - 8-min.png

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.

Integração personalizada para receber dados de sistemas externos (interface 2024) - 9-min.png

  

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.

Integração personalizada para receber dados de sistemas externos (interface 2024) - 10-min.png

  

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: