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

# Gmail

> Sincronizza email con i record Arya, invia da Arya, traccia apertura e reply.

<Frame>
  <img src="https://mintcdn.com/agevole/cM9eEPJE8FVhTNOb/images/integrazioni/gmail/shared/tile.svg?fit=max&auto=format&n=cM9eEPJE8FVhTNOb&q=85&s=a634a4bfcb809832052023ea4820155d" alt="Tile integrazione Gmail nelle impostazioni Arya" width="1200" height="720" data-path="images/integrazioni/gmail/shared/tile.svg" />
</Frame>

## Cosa fa

Collega la tua casella Gmail ad Arya per tracciare automaticamente tutte le email scambiate con contatti e deal. Puoi inviare email direttamente da Arya, vedere thread nel timeline del record, ricevere notifiche su reply e aperture. L'integrazione supporta Google Workspace e Gmail personale.

## Prerequisiti

<Note>
  * Account attivo su Gmail
  * Ruolo **Admin** o **Manager** su Arya per collegare l'integrazione
  * Autorizzazione OAuth (o API key, dove applicabile)
</Note>

## Collega Gmail

<Steps>
  <Step title="Vai a Impostazioni → Integrazioni">Cerca **Gmail** nella galleria e click **Connetti**.</Step>
  <Step title="Autorizza via OAuth">Ti apre la pagina di login di Gmail. Concedi i permessi richiesti.</Step>
  <Step title="Conferma in Arya">Arya testa la connessione. Se ok, vedi "Connesso" in verde.</Step>
  <Step title="Configura preferenze (opzionale)">Frequenza sync, filtri, mapping campi. Da **Impostazioni → Integrazioni → \[Gmail] → Configura**.</Step>
</Steps>

## Cosa sincronizza

| Direzione    | Entità                                            |
| ------------ | ------------------------------------------------- |
| Gmail → Arya | Email ricevute/inviate → timeline contatto e deal |
| Arya → Gmail | Email composte in Arya vengono inviate via Gmail  |
| Gmail → Arya | Firma email importata come firma workspace        |

## Uso nei workflow

Una volta collegata, Gmail appare come azione nel [workflow builder](/it/automazioni/workflow-builder). Puoi:

* Triggerare workflow da eventi Gmail
* Usare Gmail come azione (es. crea record, invia messaggio)

## Risoluzione dei problemi

<AccordionGroup>
  <Accordion title="Errore di autorizzazione">
    Token scaduto o revocato. Disconnetti e riconnetti.
  </Accordion>

  <Accordion title="Sync lenta o fallita">
    Controlla quota API del servizio (rate limit). Riduci frequenza se superi quota.
  </Accordion>

  <Accordion title="Dati non sincronizzati">
    Verifica mapping campi e filtri. Prova sync manuale da **⋯ → Sincronizza ora**.
  </Accordion>

  <Accordion title="Errori di duplicato">
    Arya usa chiavi univoche per matching. Configura chiave (email, ID esterno) in **Impostazioni → Sync**.
  </Accordion>
</AccordionGroup>

## Disconnetti

<Warning>
  La disconnessione interrompe la sincronizzazione immediatamente. I dati già importati restano nel workspace.
</Warning>

<Steps>
  <Step title="Vai a Impostazioni → Integrazioni">Trova la card Gmail.</Step>
  <Step title="Click Disconnetti">Conferma. L'access token viene revocato.</Step>
</Steps>