> ## Documentation Index
> Fetch the complete documentation index at: https://wavecnct.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Salesforce

> Sincronizza i contatti Wave in Salesforce come Lead o Contatti

<Info>
  Disponibile nei piani **Pro**, **Teams** ed **Enterprise**.
</Info>

L'integrazione con Salesforce sincronizza i contatti Wave in Salesforce come Lead o Contatti, a tua scelta durante la configurazione. Wave utilizza un campo ID esterno personalizzato per effettuare upsert dei record, evitando i duplicati anche se un record esiste già. Sono supportati sia gli ambienti Salesforce di produzione che quelli sandbox.

## Come connettersi

<Steps>
  <Step title="Apri l'integrazione">
    Vai su **Integrazioni → Salesforce**.
  </Step>

  <Step title="Scegli un tipo di record">
    Scegli se sincronizzare i contatti come **Lead** o **Contatti**.
  </Step>

  <Step title="Abilita la sincronizzazione automatica (facoltativo)">
    Attiva **Sincronizzazione automatica** per importare immediatamente tutti i contatti Wave esistenti.
  </Step>

  <Step title="Connetti Salesforce">
    Clicca su **Connetti** e accedi al tuo account Salesforce.
  </Step>
</Steps>

Wave richiede accesso offline (per mantenere attiva la connessione senza accessi ripetuti) e accesso in lettura/scrittura per creare e aggiornare i record in Salesforce.

## Cosa viene sincronizzato

| Campo Wave                | Campo Salesforce                     |        Lead       | Contatti |
| ------------------------- | ------------------------------------ | :---------------: | :------: |
| Nome                      | `FirstName`                          |         Sì        |    Sì    |
| Cognome                   | `LastName`                           |         Sì        |    Sì    |
| Email principale          | `Email`                              |         Sì        |    Sì    |
| Telefono principale       | `Phone`                              |         Sì        |    Sì    |
| Titolo professionale      | `Title`                              |         Sì        |    Sì    |
| Azienda                   | `Company`                            | Sì (obbligatorio) |     -    |
| Nota contatto             | `Description`                        |         Sì        |    Sì    |
| Fonte lead                | `LeadSource` = "Wave Connect"        |         Sì        |     -    |
| Membro del team assegnato | `OwnerId` (corrispondenza per email) |         Sì        |    Sì    |

**Direzione di sincronizzazione**: Wave → Salesforce (solo in uscita)

**Quando si sincronizza**: In tempo reale alla creazione, aggiornamento o eliminazione del contatto

## Funzionalità

* **Lead o Contatti**: scegli il tipo di record Salesforce più adatto al tuo flusso di lavoro.
* **Supporto sandbox**: connettiti a un ambiente sandbox Salesforce per i test.
* **Sincronizzazione automatica alla connessione**: importa tutti i contatti Wave esistenti alla prima connessione.
* **Deduplicazione**: un campo ID esterno personalizzato (`WaveConnectId__c`) viene creato automaticamente e utilizzato per gli upsert, così la risincronizzazione non crea mai duplicati.
* **Assegnazione del proprietario**: i contatti vengono assegnati all'utente Salesforce la cui email corrisponde al membro del team Wave.

## Aggiunta manuale del campo ID esterno

Wave di norma crea automaticamente il campo ID esterno `WaveConnectId__c` quando ti connetti. Questo passaggio è necessario solo se ti connetti **senza un account amministratore Salesforce**, poiché la creazione di un campo personalizzato richiede autorizzazioni di amministratore. In quel caso, chiedi al tuo amministratore Salesforce di aggiungere il campo manualmente come backup.

<Steps>
  <Step title="Apri l'oggetto Lead">
    In **Configurazione** di Salesforce, apri **Gestione oggetti** e seleziona l'oggetto **Lead**.
  </Step>

  <Step title="Verifica se il campo esiste">
    Sotto **Campi e relazioni**, controlla se `WaveConnectId__c` esiste già.
  </Step>

  <Step title="Crea il campo">
    Se non esiste, clicca su **Nuovo**, seleziona **Testo** come tipo di campo e assegnagli un nome in modo che il nome API sia `WaveConnectId__c`.
  </Step>

  <Step title="Imposta la sicurezza a livello di campo">
    Verifica che **Utente standard** abbia accesso in lettura/scrittura al campo.
  </Step>

  <Step title="Aggiungi ai layout di pagina e salva">
    Aggiungi il campo ai layout di pagina pertinenti, quindi salva.
  </Step>
</Steps>

<Note>
  Se il campo esiste già, aprilo e seleziona **Imposta sicurezza a livello di campo** per verificare che **Utente standard** abbia accesso in lettura/scrittura. Per i dettagli completi, consulta la [guida alla configurazione di Salesforce](https://support.wavecnct.com/en/articles/10492839-salesforce).
</Note>

## Limitazioni e requisiti

* Il campo personalizzato `WaveConnectId__c` viene creato automaticamente sul tuo account Salesforce. Non eliminarlo né rinominarlo. Viene utilizzato per la deduplicazione.
* Per i Lead, il campo `Company` è obbligatorio in Salesforce. Se un contatto Wave non ha un'azienda, viene impostato per default su `N/A`.
* Se Salesforce rileva un duplicato tramite le sue regole di duplicazione, Wave sovrascrive la regola e salva il record.
* La corrispondenza del proprietario avviene per email. Se non viene trovato nessun utente Salesforce corrispondente, il contatto viene salvato senza proprietario.

## Disconnessione

Vai su **Integrazioni → Salesforce** e clicca su **Disconnetti**. Questo rimuove l'integrazione e revoca l'accesso di Wave. I record già sincronizzati con Salesforce non vengono eliminati.