Integrazione personalizzata per ricevere dati da sistemi esterni

In Connectif è possibile ricevere dati da sistemi esterni per utilizzare informazioni non registrate di default sulla piattaforma. Tramite un'integrazione personalizzata, puoi sincronizzare i dati dei tuoi contatti in base agli eventi generati da altre piattaforme.

In questo articolo imparerai come creare un'integrazione personalizzata per ricevere dati.

  

Tempo di implementazione: 20 minuti.
Difficoltà: Media
Quando utilizzarlo: Quando è necessario ricevere in Connectif dati generati da sistemi o applicazioni esterne.

 

PASSO 1 - Creazione dell'integrazione personalizzata

1. Accedi a "Integrazioni > Personalizzate" e fai clic su  Crea nuova integrazione.

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 1-min.png

 

Se lavori con un ERP, ti consigliamo di seguire questi passaggi per sincronizzare i dati con il tuo account Connectif.

2. Imposta il campo "Nome" per identificare l'integrazione.

3. (Opzionale) Personalizza il colore, aggiungi una descrizione o categorizza l'integrazione.

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 2-min (1).png

4. Fai clic su  Salva.

5. Nella scheda Ricevere dati, fai clic su  Crea nuovo evento di ricezione.

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 3-min.png

 

PASSO 2 - Configurazione dell'evento "Ricevere Dati"

(In questa sezione verranno configurati i campi in cui memorizzare i dati ricevuti).

6. Fai clic su   Aggiungi un nuovo campo per creare un campo personalizzato e compila i campi necessari nel blocco a destra.

  

Per saperne di più sui campi personalizzati, fai clic qui.

 

È importante che il campo email sia di tipo email e sia contrassegnato come Obbligatorio e Chiave primaria, poiché verrà utilizzato per identificare il contatto.

7. Ripeti l'azione indicata nel punto precedente tante volte quanti sono i dati che vuoi ricevere. 

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 4-min.png

8. Fai clic su  Salva e, nella schermata di conferma, fai clic su  Torna all'elenco degli eventi.

 

PASSO 3 - Ottenimento dell'endpoint di notifica

(In questa sezione si spiega come generare l'indirizzo per notificare il tipo di evento creato, l'endpoint).

  

Il funzionamento dell'endpoint è analogo al concetto di webhook: è un sistema che attende il verificarsi di un evento e reagisce trasferendo i dati a un'altra applicazione o sistema, in questo caso a Connectif, usando una chiamata HTTP.

9. Nella scheda Ricevere dati, clicca su  Modifica.

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 6-min.png

10. Clicca su  Copia URL per copiare l'indirizzo dell'endpoint negli appunti.

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 7-min (2).png

 

PASSO 4 - Invio di dati a Connectif

(In questa sezione si spiega come stabilire la comunicazione con l'endpoint e inviare i dati).

11. Effettua la chiamata all'endpoint per notificare i dati dell'evento. La seguente schermata mostra una chiamata JSON realizzata con Postman, seguendo l'esempio illustrato nell'articolo.

 

Scopri come notificare eventi personalizzati via JavaScript in questo articolo.

Integrazione_personalizzata_per_ricevere_dati_-_7.png

 

La chiamata deve essere una richiesta POST all'endpoint selezionato con formato JSON. Nel corpo della chiamata è necessario specificare gli ID dei campi configurati nell'evento.

 

PASSO 5 - Sincronizzazione dei dati con le informazioni del contatto

(In questa sezione si spiega come sincronizzare i dati in Connectif tramite un workflow).

12. Accedi a “Workflows”, clicca su  Crea nuovo workflow e seleziona Crea workflow vuoto.

13. Crea la struttura del tuo workflow con il nodo di tipo trigger “Trigger [nome della tua integrazione]” e il nodo di tipo azione “Imposta campo”.

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 8-min.png

14. Nel nodo “Trigger Ricevere dati da…”, clicca su  (Modifica configurazione del nodo).

15. Verifica che i dati raccolti dal nodo "Trigger Ricevere dati da...", provenienti dall'evento nel sistema esterno, siano corretti.

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 9-min.png

  

Se i dati non fossero corretti, puoi modificarli dalla configurazione dell'evento di ricezione (PASSO 2).

16. Fai clic su  Salva.

17. Nel nodo “Imposta campo”, fai clic su  (Modifica configurazione del nodo).

18. Collega le variabili per assegnare le informazioni raccolte dall'integrazione personalizzata ai campi di contatto corrispondenti.

Integrazione personalizzata per ricevere dati da sistemi esterni (interfaccia 2024) - 10-min.png

  

Per saperne di più su come assegnare variabili nel nodo "Imposta campo", fai clic qui.

19. Fai clic su  Aggiorna.

20. Nel workflow, fai clic su  Salva per salvare le modifiche e su  Avvia per attivarlo.

 

Extra: Creazione di un Segmento Dinamico Plus dell'integrazione

Con Connectif, puoi creare un Segmento Dinamico Plus per filtrare in base alle attività e ai campi correlati all'integrazione personalizzata.

 

Se vuoi imparare come creare un Segmento Dinamico Plus con i contatti della tua integrazione, consulta questo articolo.

Una volta creato un segmento di contatti dell'integrazione personalizzata, questo non potrà essere eliminato. Inoltre, se uno dei suoi campi viene utilizzato come condizione di segmentazione, non potrà essere né eliminato né modificato. 

 

 

 Successo!
La tua integrazione personalizzata è pronta per ricevere dati.


Continua a imparare!

Per sfruttare al massimo il potenziale del tuo account Connectif, ti consigliamo di continuare con i seguenti articoli: