Nelle prime lezioni di questo corso abbiamo esplorato i concetti fondamentali delle automazioni e la struttura di un flusso di lavoro. Ora è il momento di fare un passo avanti e guardare dentro i tubi in cui scorrono le nostre informazioni. Quando colleghi un modulo di contatto a un foglio di calcolo o a un CRM, come fanno i dati a passare da un punto A a un punto B senza perdersi o mescolarsi?

La risposta sta in un formato standard chiamato JSON e nel processo di mappatura dei dati (data mapping). Non lasciarti spaventare dai termini tecnici: in questa lezione capiremo esattamente come leggere queste strutture e come domarle all'interno dei tuoi strumenti no-code e low-code preferiti.

---

Cos'è il JSON e perché ti serve conoscerlo

Nelle piattaforme di automazione come Make, n8n o Zapier, le applicazioni comunicano tra loro scambiandosi messaggi di testo strutturati. Il formato standard più utilizzato al mondo per questi messaggi è il JSON (JavaScript Object Notation).

Anche se il nome contiene "JavaScript", non hai bisogno di saper programmare per usarlo. Pensa al JSON semplicemente come a un modo organizzato di scrivere informazioni usando delle etichette, molto simile a un modulo cartaceo in cui ogni riga ha un nome e uno spazio per la risposta.

La struttura base: Chiave e Valore

Il JSON si basa su coppie di chiave (key) e valore (value) racchiuse tra parentesi graffe {}. Ecco un esempio estremamente semplice:

{
  "nome": "Alessandro",
  "ruolo": "Automation Specialist",
  "anni_esperienza": 5
}

In questo blocco:

  • "nome", "ruolo" e "anni_esperienza" sono le chiavi (le etichette).
  • "Alessandro", "Automation Specialist" e 5 sono i valori (i dati effettivi).

---

Strutture dati avanzate: Oggetti nidificati e Array

I dati reali sono spesso più complessi di una semplice lista piatta. Per questo motivo, il JSON permette di organizzare le informazioni in due modi fondamentali: gli oggetti nidificati e gli array (o liste).

1. Oggetti nidificati (Nested Objects)

Un valore può essere a sua volta un intero gruppo di chiavi e valori. Questo serve a raggruppare informazioni correlate. Ad esempio, i dati di contatto di un cliente:

{
  "nome": "Alessandro",
  "contatti": {
    "email": "alessandro@example.com",
    "telefono": "+39 333 1234567"
  }
}

Qui, la chiave contatti contiene un "sotto-oggetto" con le chiavi email e telefono.

2. Array (Liste di elementi)

Un array è semplicemente una lista di elementi racchiusa tra parentesi quadre []. Può contenere una lista di testi, di numeri o persino una lista di altri oggetti JSON. Ad esempio, i tag associati a un cliente o i prodotti in un ordine:

{
  "id_ordine": 9876,
  "prodotti": ["Consulenza AI", "Setup CRM", "Licenza Software"]
}

---

La Mappatura dei Dati (Data Mapping)

Ora che sai come sono strutturati i dati, passiamo alla pratica. Cos'è la mappatura?

Mappare significa collegare una chiave di output di un modulo precedente a un campo di input di un modulo successivo.

Immagina di ricevere un lead da un modulo Typeform e di volerlo inserire in un foglio Google. Il modulo Typeform ti invierà un JSON simile a questo:

{
  "nome_utente": "Giulia",
  "indirizzo_email": "giulia@example.com"
}

Nel tuo strumento di automazione, quando configurerai l'azione "Crea riga su Google Sheets", non scriverai a mano "Giulia". Al contrario, farai clic sul campo "Nome" del foglio di calcolo e selezionerai l'etichetta dinamica (spesso rappresentata come una "pillola" colorata o una variabile) corrispondente a nome_utente.

In questo modo, ogni volta che l'automazione viene eseguita con dati diversi, il sistema saprà esattamente dove andare a prendere l'informazione corretta.

---

I 3 errori più comuni nella mappatura dei dati

Anche i professionisti a volte commettono errori di mappatura. Ecco i tre più frequenti da evitare:

  1. Confondere Tipi di Dati Diversi: Se un'applicazione si aspetta un numero (es. 15) e tu le invii un testo (es. "quindici"), l'automazione si bloccherà restituendo un errore di tipo (Type Mismatch).
  2. Mappare un intero Array in un campo di testo singolo: Se provi a inserire una lista di prodotti ["A", "B", "C"] in un campo di testo che si aspetta un singolo nome, potresti ottenere un testo illeggibile o un errore. Impara a usare funzioni di formattazione (come il "Join") per unire gli elementi di una lista prima di mapparli.
  3. Mancanza di dati (Null/Empty): Se mappi una chiave che in alcune esecuzioni potrebbe essere vuota (es. il secondo indirizzo di spedizione), assicurati che l'applicazione di destinazione possa accettare valori vuoti senza andare in errore.

---

Esercizio Pratico: Decodifica e Mappa

Metti alla prova quello che hai appena imparato. Guarda questo JSON che rappresenta la notifica di un pagamento ricevuto da uno store online:

{
  "transazione_id": "TXN-55421",
  "importo": 120.50,
  "valuta": "EUR",
  "acquirente": {
    "nome_completo": "Marco Verdi",
    "spedizione": {
      "citta": "Milano",
      "cap": "20121"
"    }
  }
}

Rispondi a queste domande (le risposte sono subito sotto):

  1. Qual è il valore associato alla chiave importo?
  2. Se volessi mappare la città di spedizione su un CRM, quale percorso di chiavi dovresti seguire all'interno dell'oggetto?
  3. Il valore associato a importo è un testo o un numero?

Risposte dell'esercizio:

  1. Il valore è 120.50.
  2. Dovresti seguire il percorso nidificato: acquirente → spedizione → citta (nelle piattaforme no-code lo vedrai spesso rappresentato come acquirente.spedizione.citta).
  3. È un numero (lo capisci perché non è racchiuso tra virgolette "").

Ora che sai leggere il JSON e capisci come i dati vengono strutturati e mappati, non avrai più paura quando vedrai parentesi graffe o flussi di dati complessi nei tuoi scenari di automazione. Sei pronto per affrontare l'integrazione di qualsiasi API!