# Integrazioni private: tutto quello che devi sapere

> Scopri come usare le integrazioni private per connettere in modo sicuro il tuo account Futuria CRM ad applicazioni di terze parti tramite API. Guida com...

Autore: Agente Futuria · Pubblicato: 3 luglio 2026 · Lettura: 7 min di lettura

Fonte: https://futuriamarketing.com/supporto/guida-integrazioni-private/

---

Le integrazioni private ti permettono di creare connessioni personalizzate e sicure tra il tuo account Futuria CRM e qualsiasi applicazione di terze parti. Questa funzionalità è ideale per strumenti interni, flussi di lavoro automatizzati e sistemi personalizzati che necessitano di accesso API senza dover creare un'app pubblica completa.

## Cosa sono le integrazioni private?

Le integrazioni private ti consentono di creare potenti integrazioni personalizzate tra il tuo account Futuria CRM e qualsiasi altra app di terze parti.

Se desideri integrare il tuo account Futuria CRM con un'app esterna, hai due opzioni:

- Trovare e installare l'app pertinente dall'App Marketplace.
- Costruire la tua integrazione privata, da solo o con l'aiuto di uno sviluppatore, utilizzando le API.

Le integrazioni private ti aiutano a realizzare la seconda opzione in modo sicuro.

I principali vantaggi dell'utilizzo delle integrazioni private sono:

- **Semplicità**: genera i token per le integrazioni private dalle impostazioni del tuo account e gestiscili con facilità.
- **Sicurezza**: puoi limitare gli ambiti e le autorizzazioni a cui uno sviluppatore può accedere nel tuo account.

## Qual è la differenza tra integrazioni private e chiavi API?

In parole semplici, le integrazioni private sono un'alternativa più potente e sicura alle chiavi API tradizionali.

**Integrazioni PrivateChiavi APIPiù sicure**: puoi limitare gli ambiti e le autorizzazioni a cui uno sviluppatore può accedere nel tuo account.**Meno sicure**: uno sviluppatore ottiene accesso illimitato a tutti i dati del tuo account.**Moderne**: le integrazioni private ti permettono di accedere all'API v2.0, che è all'avanguardia.**Obsolete**: le chiavi API funzionano con l'API v1.0, che ha raggiunto la fine del suo ciclo di vita e non è più mantenuta.**Più funzionalità**: l'API v2.0 offre API più potenti.**Meno funzionalità**: l'API v1.0 ha un numero limitato di API.

## Perché i token di integrazione privata sono raccomandati per le nuove credenziali

I Token di Integrazione Privata (PIT) sono il sostituto consigliato per le vecchie chiavi API perché forniscono una gestione degli accessi più sicura e flessibile.

Le vecchie chiavi API che rimangono inutilizzate per più di 90 giorni potrebbero essere contrassegnate come "Scadute" nelle impostazioni. Poiché la creazione di nuove chiavi legacy v1 non è più supportata, è necessario utilizzare i PIT per qualsiasi nuova credenziale o per migrare le vecchie integrazioni a un modello di accesso più sicuro.

Se utilizzi ancora una vecchia chiave API, Futuria CRM consiglia di migrare tale integrazione a un Token di Integrazione Privata il prima possibile.

![Tabella di confronto tra Token di Integrazione Privata e Chiavi API legacy in Futuria CRM.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/6e20df53-58fd-4a5d-b594-3e20923a7dca.png)

## Qual è la differenza tra integrazioni private e token di accesso OAuth2?

In parole semplici, le integrazioni private sono token di accesso OAuth2 statici e fissi.

**Integrazioni PrivateToken di AccessoGenerati dall'interfaccia utente**: il token di integrazione privata può essere generato facilmente dall'interfaccia.**Generazione programmatica**: i token API vengono generati scambiando un codice di accesso OAuth tramite l'API Get Access Token.**Statici/Fissi**: i token di integrazione privata sono statici e non si aggiornano automaticamente, a meno che non li ruoti manualmente dall'interfaccia.**Aggiornati quotidianamente**: i token di accesso scadono ogni giorno e devono essere aggiornati.

## Come si usano le integrazioni private?

I token di integrazione privata vengono utilizzati nell'header di autorizzazione, proprio come gli altri token di accesso.

Ad esempio, per ottenere i dettagli di un account, puoi utilizzare l'API corrispondente con il Token di Integrazione Privata nell'header di autorizzazione.

```
curl --request GET \
  --url https://services.futuriacrm.com/locations/ve9EPM428h8vShlRW1KT \
  --header 'Accept: application/json' \
  --header 'Authorization: <IL_TUO_TOKEN_DI_INTEGRAZIONE_PRIVATA>' \
  --header 'Version: 2021-07-28'
```

## Testare un'integrazione privata con chiamate API

Una volta creata la tua integrazione privata, potresti volerla testare inviando dati a un endpoint API. Per farlo, avrai bisogno dell'URL corretto dell'endpoint API.

Ecco un esempio di come testare l'integrazione aggiungendo un nuovo contatto:

```
curl --request POST \
  --url https://services.futuriacrm.com/contacts/ \
  --header 'Authorization: <IL_TUO_TOKEN_DI_INTEGRAZIONE_PRIVATA>' \
  --header 'Content-Type: application/json' \
  --header 'Version: 2021-07-28' \
  --data '{
    "firstName": "John",
    "lastName": "Doe",
    "email": "john.doe@example.com",
    "phone": "+1234567890",
    "locationId": "LOCATION_ID"
  }'
```

Assicurati di:

- Sostituire `LOCATION\_ID` con l'ID effettivo dell'account.
- Sostituire il valore di `Authorization` con il tuo token di integrazione privata generato.

## Dove trovo le integrazioni private?

Puoi trovare le integrazioni private nelle impostazioni del tuo account. Se non le vedi, assicurati di aver abilitato la funzionalità nella sezione Labs.

![Posizione della voce 'Integrazioni Private' nel menu Impostazioni di Futuria CRM.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/6554cfa1-9ef9-4246-a096-ae61c54973a5.png)

## Come creo una nuova integrazione privata?

**Passaggio 1:** Clicca su "Crea nuova integrazione".

![Pulsante 'Crea nuova integrazione' nella sezione Integrazioni Private di Futuria CRM.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/354b0385-0660-4fdb-a882-a806c458ea40.png)

**Passaggio 2:** Assegna un nome e una descrizione alla tua integrazione privata per aiutare te e il tuo team a identificarne lo scopo.

![Finestra per inserire nome e descrizione di una nuova integrazione privata.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/9834bd4e-484e-477f-8475-390ab056e07b.png)

**Passaggio 3:** Seleziona gli ambiti e le autorizzazioni a cui vuoi che l'integrazione privata abbia accesso nel tuo account. Assicurati di selezionare solo gli ambiti necessari per una maggiore sicurezza dei dati.

![Selezione degli ambiti e delle autorizzazioni per un'integrazione privata in Futuria CRM.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/771c7d20-863a-414d-be53-fd84c260440d.png)

**Passaggio 4:** Copia il token generato e condividilo con lo sviluppatore della tua app di terze parti.

Assicurati di condividere il token solo con persone di fiducia. **Non condividerlo pubblicamente.**

**Nota:** non dimenticare di copiare il token generato, poiché non potrai visualizzarlo di nuovo in seguito.

![Token di integrazione privata generato e pronto per essere copiato.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/1543a8ab-b6ae-4b07-949a-3be8e6deda7f.png)

## Quali sono le migliori pratiche per mantenere la sicurezza del mio token di integrazione privata?

Ti consigliamo di ruotare i tuoi token di integrazione privata ogni 90 giorni. Ecco come puoi farlo.

**Passaggio 1:** Vai su Integrazioni Private nelle impostazioni e clicca sull'integrazione che hai creato.

![Dettagli di un'integrazione privata esistente con opzioni di gestione.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/c66ae3c6-24d1-4f5f-8c40-cb47a6771c0f.png)

**Passaggio 2:** Clicca su "Ruota e fai scadere questo token più tardi".

![Pulsante 'Ruota e fai scadere questo token più tardi' per la gestione del token.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/84e003df-78df-4e5e-baae-988df283839f.png)

**Passaggio 3:** Clicca su "Continua" nel messaggio di avviso se sei sicuro di voler procedere con la rotazione.

![Messaggio di avviso per la conferma della rotazione del token.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/2062ed86-3527-47a8-be46-5d79869d0ce6.png)

**Passaggio 4:** **Copia il nuovo token e aggiornalo nella tua app di terze parti.**

Avrai una finestra di 7 giorni in cui sia il vecchio che il nuovo token continueranno a funzionare. Dopo 7 giorni, il vecchio token scadrà. In questa finestra di tempo, avrai la possibilità di:

- "Annulla rotazione" se, ad esempio, il tuo sviluppatore ha bisogno di più tempo per aggiornare il token sull'app di terze parti.
- "Fai scadere ora", se, ad esempio, l'app di terze parti è già stata aggiornata con il nuovo token.

**Nota:** non dimenticare di copiare il token generato, poiché non potrai visualizzarlo di nuovo in seguito.

![Nuovo token generato dopo la rotazione, con opzioni per annullare o far scadere subito il vecchio.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/e1ee30be-9879-410e-8c61-31d2815d4d4d.png)

## Il token è stato compromesso?

**Passaggio 1: Vai su Integrazioni Private nelle impostazioni e clicca sull'integrazione che hai creato.**

![Dettagli di un'integrazione privata esistente con opzioni di gestione.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/39e4f0b8-9bc6-48f3-b128-77e3aaf8f213.png)

**Passaggio 2: Clicca su "Ruota e fai scadere questo token ora".**

![Pulsante 'Ruota e fai scadere questo token ora' per la gestione del token.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/9de355a4-28f0-4556-8f97-0a53aa29812d.png)

**Passaggio 3: Clicca su "Continua" nel messaggio di avviso se sei sicuro di voler procedere con la rotazione.**

![Messaggio di avviso per la conferma della rotazione immediata del token.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/b695e44c-dc0e-4da8-a106-0d32c2fbf8f0.png)

**Passaggio 4: Copia il nuovo token e aggiornalo sulla tua app di terze parti.**

**Nota:** non dimenticare di copiare il token generato, poiché non potrai visualizzarlo di nuovo in seguito.

![Nuovo token di integrazione privata generato dopo la rotazione immediata.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/c9e39546-a68f-45a0-963c-2e7da107487a.png)

## Posso modificare le autorizzazioni dell'integrazione privata senza aggiornare il token?

Sì, puoi modificare il nome, la descrizione e gli ambiti/autorizzazioni dell'integrazione privata in qualsiasi momento dopo averla creata. Ecco come fare.

**Passaggio 1: Vai su Integrazioni Private nelle impostazioni e seleziona "Modifica" dal menu a tre punti.**

![Menu contestuale di un'integrazione privata con l'opzione 'Modifica' evidenziata.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/51b07d6a-7764-4178-9ed1-e179e78ece2e.png)

**Passaggio 2: Se necessario, aggiorna il nome e la descrizione dell'integrazione privata. Clicca su "Avanti".**

![Finestra di modifica del nome e della descrizione di un'integrazione privata.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/0b8ef430-86d9-45f5-af89-4087afba1a15.png)

**Passaggio 3: Se necessario, aggiorna gli ambiti/autorizzazioni a cui vuoi che l'integrazione privata abbia accesso nel tuo account.**

Assicurati di selezionare solo gli ambiti necessari per una maggiore sicurezza dei dati. Clicca su "Aggiorna" per salvare le modifiche.

![Finestra di modifica degli ambiti e delle autorizzazioni di un'integrazione privata.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/3af92b80-3d76-4c0e-98ac-be1d07cba377.png)

Gli utenti possono creare fino a **5 Token di Integrazione Privata (PIT)** per il proprio account.

**Nota:** l'aggiornamento dei dettagli dell'integrazione privata non genera un nuovo token. Il token esistente continuerà a funzionare.

## Come elimino l'integrazione privata quando non ne ho più bisogno?

Puoi eliminare l'integrazione privata quando non utilizzi più l'app di terze parti. Per farlo, vai su Integrazioni Private nelle impostazioni e seleziona "Elimina" dal menu a tre punti.

![Menu contestuale di un'integrazione privata con l'opzione 'Elimina' evidenziata.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/752452da-5dd9-47f8-baa6-4eeda3e2fd2c.png)

![Impostazioni di autorizzazione per le integrazioni private a livello di utente.](https://assets.cdn.filesafe.space/jOFcdS1QIxGsOiKRyQti/media/60396a03-b447-4ba5-a83a-70dbf648db8a.png)