Integración personalizada para recibir datos desde sistemas externos

En Connectif es posible recibir datos desde sistemas externos para hacer uso de información que no es registrada por defecto en la plataforma. Mediante una integración personalizada, podrás sincronizar los datos de tus contactos en función de eventos generados en otras plataformas.

En este artículo, aprenderás cómo crear una integración personalizada para recibir datos.

  

Tiempo de implementación: 20 minutos.
Dificultad: Media
¿Cuándo utilizarlo?: Cuando sea necesario recibir en Connectif datos generados en sistemas o aplicaciones externos.

 

PASO 1 - Creación de la integración personalizada

1. Accede a "Integraciones > Personalizadas" y haz clic sobre  Crear nueva integración.

Integraci_n_personalizada_para_recibir_datos_-_1.png

 

En caso de que trabajes con un ERP, te recomendamos seguir estos pasos para sincronizar los datos con tu cuenta de Connectif.

2. Establece el campo "Nombre" para identificar la integración.

3. (Opcional) Personaliza el color, incluye una descripción o categoriza la integración.

Integraci_n_personalizada_para_recibir_datos_-_2A.png

4. Haz clic en  Guardar.

5. En la pestaña Recibir datos, haz clic en  Crear nuevo evento de recepción.

Integraci_n_personalizada_para_recibir_datos_-_2B.png

 

PASO 2 - Configuración del evento "Recibir Datos"

(En este apartado se van a configurar los campos donde se van a almacenar los datos recibidos).

6. Haz clic en   Añadir un nuevo campo para crear un campo personalizado y rellena los campos necesarios en el bloque derecho.

  

Para saber más sobre campos personalizados, haz clic aquí.

 

Es importante que el campo email sea de tipo email y sea marcado como Obligatorio y Es clave primaria, ya que se utilizará para identificar al contacto.

7. Repite la acción indicada en el punto anterior tantas veces como datos quieras recibir. 

Integraci_n_personalizada_para_recibir_datos_-_3.png

8. Haz clic en  Guardar y, en la pantalla de confirmación, haz clic en  Volver al listado de eventos.

Integraci_n_personalizada_para_recibir_datos_-_4.png

 

PASO 3 - Obtención del endpoint de notificación

(En este apartado, se explica cómo generar la dirección para notificar el tipo de evento creado, el endpoint).

  

El funcionamiento del endpoint es análogo al concepto de webhook: es un sistema que espera a que ocurra un evento y reacciona transfieriendo los datos a otra aplicación o sistema, en este caso a Connectif, usando una llamada HTTP.

9. En la pestaña Recibir datos, pulsa sobre  Editar.

Integraci_n_personalizada_para_recibir_datos_-_5.png

10. Haz clic en  Copiar URL para recoger en el portapapeles la dirección del endpoint.

Integraci_n_personalizada_para_recibir_datos_-_6.png

 

PASO 4 - Envío de datos a Connectif

(En este apartado se explica cómo establecer la comunicación con el endpoint y enviar datos).

11. Realiza la llamada al endpoint para notificarle los datos del evento. La siguiente captura es una llamada JSON realizada con Postman, siguiendo el ejemplo que ilustra el artículo.

 

Aprende cómo notificar eventos personalizados vía JavaScript en este artículo.

Integraci_n_personalizada_para_recibir_datos_-_7.png

 

La llamada debe ser una petición POST al endpoint seleccionado con formato JSON. En el body de la llamada es necesario especificar los IDs de los campos configurados en el evento.

 

PASO 5 - Sincronización de los datos con la información del contacto

(En este apartado se explica cómo sincronizar los datos en Connectif a través de un workflow).

12. Accede a “Workflows”, haz clic en  Crear nuevo workflow y selecciona Crear workflow en blanco.

13. Crea la estructura de tu workflow con el nodo de tipo disparador “Disparador [nombre de tu integración]” y el nodo de tipo acción “Establecer campo”.

Integraci_n_personalizada_para_recibir_datos_-_8.png

14. En el nodo “Disparador Recibir datos de…”, haz clic en  (Editar configuración del nodo).

15. Comprueba que los datos que recoge el nodo "Disparador Recibir datos de...", provenientes del evento en el sistema externo, son los adecuados.

Integraci_n_personalizada_para_recibir_datos_-_10.png

  

Si los datos no fueran los adecuados puedes editarlos desde la configuración del evento de recepción (PASO 2).

16. Haz clic en  Guardar.

17. En el nodo “Establecer campo”, haz clic en  (Editar configuración del nodo).

18. Relaciona las variables para asignar la información que recoge la integración personalizada a los campos de contacto que correspondan.

Integraci_n_personalizada_para_recibir_datos_-_9.png

  

Para aprender más sobre cómo asignar variables en el nodo "Establecer campo", haz clic aquí.

19. Haz clic en  Actualizar.

Integraci_n_personalizada_para_recibir_datos_-_11.png

20. En el workflow, haz clic en  Guardar para guardar los cambios y en  Iniciar para activarlo.

 

Extra: Creación de un Segmento Dinámico Plus de la integración

Con Connectif, podrás crear un Segmento Dinámico Plus para filtrar por las actividades y campos relacionados con las integración personalizada.

 

Si quieres aprender cómo crear un Segmento Dinámico Plus con los contactos de tu integración, revisa este artículo.

Una vez crees un segmento de contactos de la integración personalizada, esta no podrá eliminarse. Además, si alguno de sus campos se está usando como condición de segmentación, tampoco podrá borrarse ni editarse. 

 

 

 ¡Éxito!
Tu Integración personalizada está lista para recibir datos.


¡Sigue aprendiendo!

Para aprovechar todo el potencial de tu cuenta en Connectif, te recomendamos continuar con los siguientes artículos:

¿Fue útil este artículo?
Usuarios a los que les pareció útil: 0 de 0