Guida Utente

download Installazione

Prerequisiti

• Browser Chrome: Versione 88 o superiore
• Istanza Odoo: Versione 14.0 o superiore (on-premise, Odoo.sh o Odoo Online piano Custom)

Installazione Passo per Passo

1. Visita Chrome Web Store
   Vai a Integrazione Odoo per Gmail o cerca "Odoo Integration for Gmail" nel Chrome Web Store.
2. Aggiungi a Chrome
   Clicca il pulsante "Aggiungi a Chrome" e rivedi i permessi richiesti.
3. Verifica Installazione
   Vedrai un messaggio di conferma e l'icona dell'estensione apparirà nella barra degli strumenti di Chrome.
4. Fissa l'Estensione (Consigliato)
   Clicca l'icona del puzzle nella barra degli strumenti di Chrome, trova "Odoo Integration for Gmail" e clicca l'icona della puntina.

settings Configurazione

Configurazione Iniziale

1. Apri Gmail
   Vai a mail.google.com e apri qualsiasi email per vedere la barra laterale.
2. Inserisci URL Odoo
   Inserisci l'URL della tua istanza Odoo (es. https://tuaazienda.odoo.com). Usa HTTPS e non includere una barra finale.
3. Inserisci Chiave API
   Accedi a Odoo, vai in Preferenze, clicca la scheda Sicurezza Account, sotto Chiavi API clicca Nuova Chiave API, dagli un nome, seleziona Chiave Persistente e copia la chiave.
4. Connetti
   Clicca Connetti e l'estensione verificherà le tue credenziali.

Aggiornamento Configurazione

Per cambiare il tuo URL Odoo o la chiave API:

1. Clicca il pulsante menu (tre punti verticali ⋮) nella barra laterale
2. Seleziona Esci
3. Inserisci le tue nuove credenziali

star Panoramica Funzionalità

Piano FREE Gratis

• Visualizzazione Contatti: Visualizza le informazioni dei partner Odoo direttamente in Gmail
• Rilevamento Intelligente Contatti: Identifica automaticamente mittente o destinatario
• Logging Email: Registra email su Odoo con allegati
• Creazione Record: Crea lead, partner, attività e ticket
• Visualizzazione Record Limitata: Visualizza le prime 5 opportunità, attività e ticket
• Aggiorna: Aggiorna manualmente i dati del contatto
• Indicatore Tempo di Caricamento: Vedi quanto velocemente si è caricata la barra laterale

Piano PLUS Plus

Tutto quello di FREE, più:

• Ricerca Avanzata: Cerca tra tutte le opportunità, attività e ticket (fino a 50 risultati)
• Schede Contatto/Azienda: Passa tra informazioni contatto e azienda
• Contatti Correlati: Trova colleghi della stessa azienda
• Approfondimenti Finanziari: Visualizza fatturazione, crediti e debiti
• Pannello Impostazioni: Personalizza le sezioni visibili
• Livelli di Citazione: Controlla quanta cronologia della conversazione includere nel logging
• Raggruppamento dei Record: Raggruppa opportunità, attività e ticket per fase o stato
• Partecipanti Email: Visualizza le informazioni di contatto Odoo di tutti i partecipanti email
• Attività Recenti: Visualizza i messaggi recenti dalle conversazioni Odoo per ogni contatto
• Organizzazione Notifiche: Identifica e organizza le email di notifica Odoo con badge dei moduli, rilevamento delle menzioni e filtro rapido
• Auto-logging: Link a Gmail thread to one or more Odoo records and have every new email logged automatically into their chatter (currently in private beta)
• Multi-Company Support: Switch between the companies you have access to in Odoo, with cross-company contact lookup when an email matches a partner that lives in a different company

credit_card Gestione Abbonamento

Come Abbonarsi a PLUS

1. Clicca "Passa a PLUS" dal menu della barra laterale (tre punti nell'intestazione)
2. Completa il processo di checkout su Polar
3. Ricevi la tua chiave di licenza via email

Attivazione della Licenza

Inserisci la tua chiave di licenza in uno di questi modi:

• Apparirà un modale subito dopo il checkout - inserisci la tua licenza lì
• Vai a Impostazioni > Account > Attiva Licenza
• Clicca di nuovo "Passa a PLUS" e seleziona "Ho già una licenza"

Come Annullare l'Abbonamento

Puoi annullare il tuo abbonamento PLUS in qualsiasi momento:

1. Vai al portale clienti Polar (link nell'email di acquisto)
2. Accedi con l'email usata per l'abbonamento
3. Clicca "Annulla Abbonamento" nei dettagli del tuo abbonamento

Le tue funzionalità PLUS rimarranno attive fino alla fine del periodo di fatturazione corrente.

mail Logging Email

Come Registrare un'Email

1. Apri l'email che vuoi registrare
2. Visualizza il contatto nella barra laterale
3. Trova il record in cui vuoi registrare (opportunità, attività o ticket)
4. Clicca l'icona della busta accanto al record
5. Il pulsante diventa un segno di spunta verde quando registrato

Cosa Viene Registrato

• Oggetto email (nell'intestazione)
• Corpo email (formattato HTML)
• Informazioni mittente/destinatario
• Data e ora
• Tutti gli allegati (file, immagini, PDF)
• Footer "Registrato da Gmail Inbox"

Rilevamento Duplicati

L'estensione ha due livelli di rilevamento duplicati:

1. Indicatore visivo (0-6 ore): Ti aiuta a identificare a colpo d'occhio quali record hanno già questa email
2. Validazione lato server (sempre): Odoo previene i duplicati anche se l'indicatore visivo è scaduto

sync Auto-logging Plus

Auto-logging links a Gmail thread to one or more Odoo records so that every new email in that thread is logged into the record's chatter automatically — no need to click the envelope icon for each reply.

Requirements

• PLUS plan (and beta access during private beta)
• Gmail API connection (granted from Settings > Auto-logging > Connect)
• Auto-logging toggle enabled in Settings > Auto-logging

How to Activate Auto-logging on a Thread

1. Open the email thread in Gmail and view the contact in the sidebar
2. Find the record you want to track (opportunity, task, ticket, or contact)
3. Click the sync icon next to the record. The icon turns green when active and a confirmation toast appears
4. From now on, every new email in this thread is logged automatically into the chatter of that record

What Gets Logged

Each new email is added as an internal note in the record's chatter, with:

• A Gmail-style header (From, To, Date, Subject)
• The email body without quoted history
• The original date of the email (not the time it was processed)
• Linked partners — recipients are matched in Odoo by email and attached to the message
• An "Auto-logged from Gmail" footer linking back to the extension

Linking a Thread to Several Records

You can activate auto-logging for the same thread on multiple records (for example, an opportunity and a task related to the same conversation):

• 1 thread → 1 record: standard case.
• 1 thread → several records: every new email is logged on each linked record sequentially.
• The same record cannot be linked twice from the same thread — duplicates are rejected.

Managing Active Auto-logs

From the sidebar (per thread)

When the open thread has any active mappings, an "Auto-logging (N)" section appears at the top of the sidebar:

• Click the section to expand it and see every record linked to the current thread
• Click on a record's name to open it in Odoo
• Click the ✕ button to deactivate auto-logging for that specific record

From Settings (across all threads)

Open Settings > Auto-logging to manage every active mapping:

• Enable or disable auto-logging globally with a single toggle
• Connect or reconnect the Gmail API
• See the list of active mappings, the count, and the time of the last successful check
• Deactivate all mappings at once with the "Deactivate all" button

Limits & Edge Cases

• Not retroactive: Only emails that arrive after activation are logged. Existing emails must be logged manually.
• Auto-cleanup after 90 days: A mapping with no new email activity for 90 days is removed automatically. Activate it again to resume tracking.
• Record deleted in Odoo: If the linked record is deleted in Odoo, the mapping is removed automatically the next time the extension tries to log into it.
• Gmail disconnected: If the Gmail API connection expires or is revoked, auto-logging stops for all threads until you reconnect from Settings > Auto-logging.

groups Lavorare con i contatti correlati Plus

La sezione Contatti correlati nella barra laterale elenca i colleghi della stessa azienda del mittente dell'email. Da lì puoi eseguire azioni rapide su ogni contatto senza uscire da Gmail.

Aprire un contatto in Odoo

Clicca in qualsiasi punto della scheda del contatto — l'avatar, il nome o la mansione — per aprire la sua scheda in Odoo in una nuova scheda.

Inviare una nuova email a un contatto

Clicca sull'icona dell'email accanto all'indirizzo del contatto. Se non hai nessuna bozza aperta, Gmail apre una nuova finestra di composizione con quell'indirizzo precompilato nel campo A.

Aggiungere un contatto a un'email che stai già scrivendo

Se hai già aperta una finestra di composizione di Gmail quando clicchi sull'icona dell'email, il contatto viene aggiunto come destinatario di quella bozza invece di aprirne una nuova. L'estensione decide dove: se il campo A è vuoto, il contatto va lì; se contiene già qualcuno, il contatto viene aggiunto in CC e la finestra di composizione viene ridotta a icona così puoi continuare a cliccare su altri contatti per costruire la lista dei destinatari.

Copiare l'email o il telefono di un contatto

Clicca sul testo dell'email o del telefono — non sull'icona accanto — per copiarlo negli appunti. Una piccola notifica conferma la copia.

Chiamare un contatto

Clicca sull'icona del telefono per avviare una chiamata. L'azione viene delegata all'app che il tuo sistema ha associato ai numeri di telefono — il dialer del tuo cellulare, FaceTime, Skype, Microsoft Teams, ecc. Se non hai nessuna app configurata, il clic non fa nulla.

history Navigare nelle attività recenti Plus

La sezione Attività recenti mostra gli ultimi messaggi e conversazioni dalla scheda del contatto in Odoo, in modo che tu possa vedere cosa è stato detto senza uscire da Gmail.

Vedere esattamente quando è avvenuta un'attività

Ogni voce mostra una data relativa come "5 giorni fa". Passa il mouse sulla data per vedere il giorno e l'ora esatti, formattati secondo la lingua del tuo browser.

Saltare a un messaggio specifico in Odoo

Clicca su una voce delle Attività recenti per aprire la scheda Odoo correlata in una nuova scheda del browser. Su Odoo 18 e successivi, il clic va un passo oltre: Odoo scorre fino a quel messaggio esatto e lo evidenzia. Su Odoo 16 e 17 la scheda si apre normalmente — il clic ti risparmia comunque la navigazione, ma dovrai scorrere tu per trovare il messaggio.

handshake Gestione Opportunità

Visualizzazione Opportunità

Quali record vengono mostrati:

• Opportunità collegate al contatto (per partner_id)
• Ordinate per data di creazione (più recenti prima)

Creare Lead dalle Email

Converti una conversazione email in un'opportunità Odoo con un clic:

1. Apri l'email che vuoi convertire in lead
2. Visualizza il contatto nella barra laterale
3. Scorri fino alla sezione Opportunità
4. Clicca il pulsante "Crea"

Cosa succede automaticamente:

• Il lead viene creato con l'oggetto dell'email come nome
• Il contenuto del corpo email viene aggiunto come descrizione
• Il contatto dalla barra laterale viene collegato
• Il lead si apre in Odoo in una nuova scheda per modifiche aggiuntive

task Attività e Ticket

Gestione Attività

Requisiti: Modulo Odoo Project installato

Quali record vengono mostrati:

• Attività collegate al contatto (tramite partner_id)
• Esclude attività completate o cancellate
• Ordinate per data di creazione (più recenti prima)

Gestione Ticket Helpdesk

Requisiti: Modulo Odoo Helpdesk (solo Enterprise)

notifications Organizzazione Notifiche Plus

Organizza le email di notifica Odoo direttamente nella tua casella di posta Gmail. L'estensione identifica le email di notifica da Odoo e aggiunge badge visivi per vedere istantaneamente a quale modulo appartengono e se sei stato menzionato.

Prerequisito: Attivare le Notifiche via Email in Odoo

Affinché questa funzione funzioni, il tuo utente Odoo deve essere configurato per ricevere notifiche via email (non nella posta di Odoo):

1. In Odoo, vai al tuo Profilo (menu in alto a destra > Il Mio Profilo)
2. In Preferenze, trova l'impostazione "Notifica"
3. Seleziona "Gestisci via email" (invece di "Gestisci in Odoo")

Configurazione

1. Trova la tua email di notifica in Odoo
   Controlla un'email di notifica Odoo recente in Gmail e guarda l'indirizzo del mittente (es: notifications@tuaazienda.com). In alternativa, chiedi al tuo amministratore Odoo l'email di notifica in uscita.
2. Apri le Impostazioni dell'estensione
   Nella barra laterale di Gmail, clicca il pulsante menu (tre punti verticali) e seleziona Impostazioni.
3. Inserisci l'email di notifica
   Vai alla scheda Notifiche e incolla l'indirizzo email. L'estensione inizierà a identificare le email di notifica immediatamente.

Badge dei Moduli

Badge colorati appaiono accanto alle email di notifica nella tua casella di posta, mostrando quale modulo Odoo ha generato la notifica:

• Opportunità (CRM) — badge viola
• Attività (Progetto) — badge blu
• Ticket (Helpdesk) — badge arancione
• Fattura (Fatturazione) — badge verde
• E altro: Acquisti, Mailing, Fogli ore, ecc.

Badge delle Menzioni

Quando qualcuno ti menziona in un record Odoo (usando @ o per nome), un badge speciale appare sull'email di notifica:

• Badge rosso "Menzionato": Hai una menzione non letta — non hai aperto questo thread in Gmail dalla menzione
• Badge grigio "Menzionato": Hai già visto questa menzione — hai aperto il thread in Gmail dopo essere stato menzionato

Accesso Rapido

Un collegamento "Odoo Notifications" appare nella barra laterale sinistra di Gmail, sotto le tue etichette. Cliccalo per filtrare istantaneamente la tua casella e mostrare solo le email di notifica Odoo.

Personalizzazione

Ogni funzione di notifica può essere attivata/disattivata indipendentemente in Impostazioni > Notifiche:

• Badge dei moduli — mostra/nascondi i badge colorati per modulo
• Badge delle menzioni — mostra/nascondi i badge di rilevamento menzioni
• Collegamento barra laterale — mostra/nascondi il link Odoo Notifications nella barra laterale di Gmail

business Multi-Company Support Plus

If your Odoo user has access to several companies, the extension lets you choose which one is active. The active company decides which records the sidebar shows you and which company every new lead, task, ticket or contact is created in.

Requirements

• PLUS plan
• An Odoo user with access to two or more companies (in Odoo: Settings > Users > Allowed Companies)

The Company Selector

When you have access to more than one company, a building icon appears in the sidebar header, next to the settings (⚙) button:

• Hover the icon to see the active company name ("Operating in {company}")
• Click the icon to open a dropdown listing every company you have access to
• Pick a company with the radio buttons. The dropdown closes and the sidebar refreshes with data from the new company
• If you have access to only one company, the icon is not shown

What the Active Company Affects

Once you pick a company, every operation in the sidebar is scoped to it:

• Records you see: Opportunities, tasks, tickets and partners listed in the sidebar are filtered to those visible in the active company
• Records you create: New leads, tasks, tickets and contacts created from the sidebar are assigned to the active company
• Auto-logged emails: Emails processed by auto-logging are posted in the company that owns the linked record (see the Auto-logging note below)

Cross-Company Contact Lookup

If you open an email from someone who isn't in the active company but exists somewhere else in your Odoo instance, the sidebar tells you and offers actions instead of leaving you with an empty state.

The contact exists in another company

The sidebar shows the contact found, the company it lives in, and two actions:

• Make visible to all companies: Removes the contact's company restriction so users in every company you have access to can see it. Asks for confirmation before saving
• Create new in this company: Creates a separate contact record in the active company, leaving the original untouched

Only the parent company exists in another company

The contact is missing, but a related company (matched by email domain) exists in another of your companies. Two actions:

• Share company across all companies: Makes the parent company visible to every company you have access to, then lets you create the contact under it
• Create company here: Creates an independent company record in the active company and the contact under it

Auto-logging Across Companies

When you activate auto-logging on a record, the extension remembers the company that record belongs to. New emails on that thread are always logged in the right company, even if you've switched the active company in the sidebar afterwards.

Behavior on the FREE Plan

If you have access to several companies on the FREE plan, the extension uses your default company in Odoo for every operation. The selector icon does not appear, and cross-company lookups are not offered. Upgrading to PLUS unlocks both.

Known Limits

• Not synced with the Odoo browser switcher: The extension uses your API key, while the Odoo company switcher uses cookies. The two are independent — switching companies in your Odoo tab does not change the active company in Gmail and vice versa.
• Default company changed in Odoo: If your administrator changes your default company in Odoo, the extension keeps using the previously cached value until you log out and log back in.
• One company at a time: The selector is single-select: the sidebar shows records from one company at a time. To see records from another company, switch to it.
• Access error after creating a record: When you create an opportunity, task, ticket or contact from the sidebar (or click "View in Odoo" on one), the extension opens the record in a new browser tab. Odoo loads it under whichever company is currently active in your Odoo browser session (the cookie session — see above). If that company differs from the one where the record was created, Odoo may show an access error. On the FREE plan, the extension always creates records in your default Odoo company — to see them, switch your Odoo browser tab to that same default. On the PLUS plan, keep the same company selected in both the sidebar selector and your Odoo browser tab. Odoo 18 and later automatically switch your active company when you open a record that belongs to another of your allowed companies, so this issue is mostly visible on Odoo 17 and earlier.

help Risoluzione Problemi

L'Estensione Non Appare in Gmail

1. Verifica che l'estensione sia abilitata: Vai a chrome://extensions/ e assicurati che l'interruttore sia ON
2. Aggiorna Gmail: Premi Ctrl+Shift+R (Windows/Linux) o Cmd+Shift+R (Mac)
3. Ricarica l'estensione: Clicca "Ricarica" sulla scheda dell'estensione

Messaggio "Contatto Non Trovato"

• Email non in Odoo: Clicca "Crea Contatto" per aggiungerlo
• Errore ortografico email: Aggiorna l'email in Odoo o crea un nuovo contatto

Errore "Autenticazione Fallita"

1. Verifica che la tua chiave API sia corretta in Odoo → Preferenze → Sicurezza Account
2. Rigenera la chiave API se necessario
3. Controlla che il tuo URL Odoo sia corretto (incluso HTTPS)

Il popup dei permessi non appare (Odoo Self-Hosted)

Quando ci si connette a un'istanza Odoo self-hosted (URL personalizzato), Chrome richiede permessi aggiuntivi. Se il popup dei permessi non appare:

1. Permesso richiesto: Gli URL Odoo personalizzati (non *.odoo.com) richiedono un permesso Chrome aggiuntivo per comunicare con il tuo server
2. Altre estensioni possono bloccare i popup: Gli ad blocker, le estensioni per la privacy o i blocca popup possono impedire la visualizzazione della finestra di dialogo dei permessi di Chrome
3. Soluzione: Disabilita temporaneamente altre estensioni (specialmente gli ad blocker) e riprova a connetterti. Riabilitale dopo aver concesso il permesso

quiz Domande Frequenti

Generale

Abbonamento

Privacy

support Ottenere Aiuto

Contatta il Supporto

Se hai domande o problemi non coperti in questa guida:

• Email: odoointegrations.team@gmail.com
• Includi la tua versione di Odoo e la versione dell'estensione
• Descrivi il problema con screenshot se possibile