> ## 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.

# Contatti Outlook

> Salva i contatti Wave in Microsoft Outlook, incluse le foto

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

L'integrazione con i Contatti Outlook sincronizza i contatti Wave in Microsoft Outlook / Microsoft 365 Contacts, incluse le foto dei contatti. Supporta due modalità: **individuale** (il tuo account Outlook personale) e **organizzazione** (una connessione amministrativa che distribuisce automaticamente i contatti sincronizzati a tutti i membri del team).

## Come connettersi

### Individuale (Outlook personale)

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

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

  <Step title="Connetti Outlook">
    Clicca su **Connetti** e accedi con il tuo account Microsoft.
  </Step>
</Steps>

### Organizzazione (Outlook di tutti i membri del team)

<Steps>
  <Step title="Apri l'integrazione come amministratore">
    Un amministratore va su **Integrazioni → Contatti Outlook**.
  </Step>

  <Step title="Connetti con l'organizzazione">
    Clicca su **Connetti con l'organizzazione** e accedi con un account amministratore Azure AD.
  </Step>

  <Step title="Concedi il consenso amministrativo">
    Concedi il consenso amministrativo affinché Wave possa sincronizzare i contatti in Outlook di ogni membro del team.
  </Step>
</Steps>

Wave richiede accesso offline (per mantenere attiva la connessione) e accesso in lettura/scrittura per creare e aggiornare i contatti in Outlook.

## Cosa viene sincronizzato

| Campo Wave                    | Campo Outlook                |
| ----------------------------- | ---------------------------- |
| Nome                          | `givenName`                  |
| Cognome                       | `surname`                    |
| Nome visualizzato             | `displayName`                |
| Titolo professionale          | `jobTitle`                   |
| Azienda                       | `companyName`                |
| Telefono principale (mobile)  | `mobilePhone`                |
| Telefono di lavoro            | `businessPhones`             |
| Altri telefoni                | `homePhones`                 |
| Fino a 3 email                | `emailAddresses`             |
| Via, città, stato, CAP, paese | `businessAddress`            |
| Sito web                      | `businessHomePage`           |
| Note contatto                 | `personalNotes`              |
| Foto contatto                 | Foto contatto Outlook (JPEG) |

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

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

## Funzionalità

* **Modalità organizzazione**: una singola connessione amministrativa sincronizza i contatti in Outlook di ogni membro del team idoneo (utenti la cui email esiste nel tenant Azure AD connesso).
* **Foto dei contatti**: le foto del profilo vengono sincronizzate e convertite in JPEG per la compatibilità con Outlook.
* **Sincronizzazione automatica alla connessione**: importa tutti i contatti esistenti alla prima connessione tramite l'API batch Microsoft Graph.
* **Deduplicazione**: i contatti vengono identificati tramite una proprietà estesa specifica di Wave, quindi gli aggiornamenti non creano mai duplicati.

## Limitazioni e requisiti

* Outlook limita i contatti a 3 indirizzi email. L'email principale è sempre elencata per prima.
* In modalità organizzazione, solo gli utenti la cui email esiste nel tenant Azure AD connesso ricevono i contatti sincronizzati.
* La modalità organizzazione richiede il consenso amministrativo di Azure AD.

## Disconnessione

Vai su **Integrazioni → Contatti Outlook** e clicca su **Disconnetti**. Questo rimuove l'integrazione. I contatti già sincronizzati in Outlook non vengono eliminati.
