Guia do Usuário

download Instalação

Pré-requisitos

• Navegador Chrome: Versão 88 ou superior
• Instância Odoo: Versão 14.0 ou superior (on-premise, Odoo.sh ou Odoo Online plano Custom)

Instalação Passo a Passo

1. Visite a Chrome Web Store
   Vá para Integração Odoo para Gmail ou pesquise "Odoo Integration for Gmail" na Chrome Web Store.
2. Adicionar ao Chrome
   Clique no botão "Adicionar ao Chrome" e revise as permissões solicitadas.
3. Verificar Instalação
   Você verá uma mensagem de confirmação e o ícone da extensão aparecerá na barra de ferramentas do Chrome.
4. Fixar a Extensão (Recomendado)
   Clique no ícone do quebra-cabeça na barra de ferramentas do Chrome, encontre "Odoo Integration for Gmail" e clique no ícone do alfinete.

settings Configuração

Configuração Inicial

1. Abra o Gmail
   Navegue até mail.google.com e abra qualquer e-mail para ver a barra lateral.
2. Insira a URL do Odoo
   Insira a URL da sua instância Odoo (ex: https://suaempresa.odoo.com). Use HTTPS e não inclua barra no final.
3. Insira a Chave API
   Faça login no Odoo, vá em Preferências, clique na aba Segurança da Conta, em Chaves API clique em Nova Chave API, dê um nome, selecione Chave Persistente e copie a chave.
4. Conectar
   Clique em Conectar e a extensão verificará suas credenciais.

Atualizando Configuração

Para alterar sua URL do Odoo ou chave API:

1. Clique no botão de menu (três pontos verticais ⋮) na barra lateral
2. Selecione Sair
3. Insira suas novas credenciais

star Visão Geral dos Recursos

Plano FREE Grátis

• Visualização de Contatos: Visualize informações de parceiros Odoo diretamente no Gmail
• Detecção Inteligente de Contatos: Identifica automaticamente remetente ou destinatário
• Registro de E-mail: Registre e-mails no Odoo com anexos
• Criação de Registros: Crie leads, parceiros, tarefas e tickets
• Visualização Limitada de Registros: Visualize as primeiras 5 oportunidades, tarefas e tickets
• Atualizar: Atualize manualmente os dados do contato
• Indicador de Tempo de Carregamento: Veja quão rápido a barra lateral carregou

Plano PLUS Plus

Tudo do FREE, mais:

• Pesquisa Avançada: Pesquise em todas as oportunidades, tarefas e tickets (até 50 resultados)
• Abas Contato/Empresa: Alterne entre informações de contato e empresa
• Contatos Relacionados: Encontre colegas da mesma empresa
• Insights Financeiros: Visualize faturamento, a receber e a pagar
• Painel de Configurações: Personalize as seções visíveis
• Níveis de Citação: Controle quanto histórico de conversa incluir no registro
• Agrupamento de Registros: Agrupe oportunidades, tarefas e tickets por etapa ou estado
• Participantes do Email: Ver informações de contacto Odoo de todos os participantes do email
• Atividades Recentes: Ver mensagens recentes das conversas do Odoo para cada contacto
• Organização de Notificações: Identifique e organize os emails de notificação do Odoo com badges de módulo, deteção de menções e filtragem rápida
• 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 Gerenciamento de Assinatura

Como Assinar o PLUS

1. Clique em "Atualizar para PLUS" no menu da barra lateral (três pontos no cabeçalho)
2. Complete o processo de checkout no Polar
3. Receba sua chave de licença por e-mail

Ativando Sua Licença

Insira sua chave de licença de uma dessas formas:

• Um modal aparecerá logo após o checkout - insira sua licença lá
• Vá para Configurações > Conta > Ativar Licença
• Clique em "Atualizar para PLUS" novamente e selecione "Já tenho uma licença"

Como Cancelar Sua Assinatura

Você pode cancelar sua assinatura PLUS a qualquer momento:

1. Vá ao portal do cliente Polar (link no seu e-mail de compra)
2. Faça login com o e-mail usado na sua assinatura
3. Clique em "Cancelar Assinatura" nos detalhes da sua assinatura

Seus recursos PLUS permanecerão ativos até o final do seu período de faturamento atual.

mail Registro de E-mail

Como Registrar um E-mail

1. Abra o e-mail que deseja registrar
2. Visualize o contato na barra lateral
3. Encontre o registro onde deseja registrar (oportunidade, tarefa ou ticket)
4. Clique no ícone do envelope ao lado do registro
5. O botão muda para um check verde quando registrado

O Que é Registrado

• Assunto do e-mail (no cabeçalho)
• Corpo do e-mail (formatado em HTML)
• Informações de remetente/destinatário
• Data e hora
• Todos os anexos (arquivos, imagens, PDFs)
• Rodapé "Registrado da Caixa de Entrada do Gmail"

Detecção de Duplicados

A extensão tem duas camadas de detecção de duplicados:

1. Indicador visual (0-6 horas): Ajuda você a identificar rapidamente quais registros já têm este e-mail
2. Validação do lado do servidor (sempre): O Odoo impede duplicados mesmo se o indicador visual tiver expirado

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 Trabalhar com contactos relacionados Plus

A secção Contactos relacionados na barra lateral lista os colegas da mesma empresa que o remetente do e-mail. A partir daí pode executar ações rápidas em cada contacto sem sair do Gmail.

Abrir um contacto no Odoo

Clique em qualquer parte do cartão do contacto — o avatar, o nome ou a função — para abrir o registo desse contacto no Odoo num novo separador.

Enviar um novo e-mail a um contacto

Clique no ícone de e-mail junto ao endereço do contacto. Se não tiver nenhum rascunho aberto, o Gmail abre uma nova janela de composição com esse endereço já preenchido no campo Para.

Adicionar um contacto a um e-mail que já está a escrever

Se já tiver uma janela de composição do Gmail aberta quando clicar no ícone de e-mail, o contacto é adicionado como destinatário desse rascunho em vez de abrir um novo. A extensão decide onde: se o campo Para estiver vazio, o contacto vai para lá; se já tiver alguém, o contacto é adicionado em CC e a janela de composição é minimizada para que possa continuar a clicar noutros contactos e construir a lista de destinatários.

Copiar o e-mail ou telefone de um contacto

Clique no texto do e-mail ou do telefone — não no ícone ao lado — para o copiar para a área de transferência. Uma pequena notificação confirma a cópia.

Ligar para um contacto

Clique no ícone de telefone para iniciar uma chamada. A ação é entregue à aplicação que o seu sistema tenha associada aos números de telefone — o marcador do seu telemóvel, FaceTime, Skype, Microsoft Teams, etc. Se não tiver nenhuma aplicação configurada, o clique não faz nada.

history Navegar pelas atividades recentes Plus

A secção Atividades recentes mostra as mensagens e conversas mais recentes do registo do contacto no Odoo, para que veja o que foi dito sem sair do Gmail.

Ver exatamente quando ocorreu uma atividade

Cada entrada mostra uma data relativa como "há 5 dias". Passe o cursor sobre a data para ver o dia e a hora exatos, formatados na língua do seu navegador.

Saltar para uma mensagem específica no Odoo

Clique numa entrada das Atividades recentes para abrir o registo Odoo relacionado num novo separador. No Odoo 18 e versões posteriores, o clique vai um passo mais longe: o Odoo desloca-se para essa mensagem específica e destaca-a. No Odoo 16 e 17 o registo abre-se normalmente — o clique poupa-lhe a navegação, mas terá de deslocar-se você mesmo para encontrar a mensagem.

handshake Gerenciando Oportunidades

Visualizando Oportunidades

Quais registros são exibidos:

• Oportunidades vinculadas ao contato (por partner_id)
• Ordenadas por data de criação (mais recentes primeiro)

Criando Leads a partir de E-mails

Converta uma conversa de e-mail em uma oportunidade Odoo com um clique:

1. Abra o e-mail que deseja converter em lead
2. Visualize o contato na barra lateral
3. Role até a seção Oportunidades
4. Clique no botão "Criar"

O que acontece automaticamente:

• O lead é criado com o assunto do e-mail como nome
• O conteúdo do corpo do e-mail é adicionado como descrição
• O contato da barra lateral é vinculado
• O lead abre no Odoo em uma nova aba para edições adicionais

task Tarefas e Tickets

Gerenciando Tarefas

Requisitos: Módulo Odoo Project instalado

Quais registros são mostrados:

• Tarefas vinculadas ao contato (por partner_id)
• Exclui tarefas concluídas ou canceladas
• Ordenadas por data de criação (mais recentes primeiro)

Gerenciando Tickets do Helpdesk

Requisitos: Módulo Odoo Helpdesk (apenas Enterprise)

notifications Organização de Notificações Plus

Organize os emails de notificação do Odoo diretamente na sua caixa de entrada do Gmail. A extensão identifica os emails de notificação do Odoo e adiciona badges visuais para que possa ver instantaneamente a que módulo pertencem e se foi mencionado.

Pré-requisito: Ativar Notificações por Email no Odoo

Para que esta funcionalidade funcione, o seu utilizador Odoo deve estar configurado para receber notificações por email (não na caixa do Odoo):

1. No Odoo, vá ao seu Perfil (menu superior direito > O Meu Perfil)
2. Em Preferências, encontre a definição de "Notificação"
3. Selecione "Gerir por emails" (em vez de "Gerir no Odoo")

Configuração

1. Encontre o seu email de notificação no Odoo
   Verifique um email de notificação recente do Odoo no Gmail e veja o endereço do remetente (ex: notifications@suaempresa.com). Em alternativa, pergunte ao seu administrador Odoo pelo email de notificação de saída.
2. Abra as Definições da extensão
   Na barra lateral do Gmail, clique no botão de menu (três pontos verticais) e selecione Definições.
3. Introduza o email de notificação
   Vá ao separador Notificações e cole o endereço de email. A extensão começará a identificar os emails de notificação imediatamente.

Badges de Módulo

Badges coloridos aparecem junto aos emails de notificação na sua caixa de entrada, mostrando qual módulo do Odoo gerou a notificação:

• Oportunidade (CRM) — badge roxo
• Tarefa (Projeto) — badge azul
• Ticket (Helpdesk) — badge laranja
• Fatura (Faturação) — badge verde
• E mais: Compras, Mailing, Folhas de horas, etc.

Badges de Menção

Quando alguém o menciona num registo do Odoo (usando @ ou pelo nome), um badge especial aparece no email de notificação:

• Badge vermelho "Mencionado": Tem uma menção não lida — não abriu esta thread no Gmail desde a menção
• Badge cinzento "Mencionado": Já viu esta menção — abriu a thread no Gmail depois de ser mencionado

Acesso Rápido

Um atalho "Odoo Notifications" aparece na barra lateral esquerda do Gmail, abaixo das suas etiquetas. Clique para filtrar instantaneamente a sua caixa e mostrar apenas os emails de notificação do Odoo.

Personalização

Cada funcionalidade de notificação pode ser ativada/desativada independentemente em Definições > Notificações:

• Badges de módulo — mostrar/ocultar os badges coloridos por módulo
• Badges de menção — mostrar/ocultar os badges de deteção de menções
• Atalho na barra lateral — mostrar/ocultar o link Odoo Notifications na barra lateral do 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 Solução de Problemas

A Extensão Não Aparece no Gmail

1. Verifique se a extensão está habilitada: Vá para chrome://extensions/ e certifique-se de que o interruptor está ON
2. Atualize o Gmail: Pressione Ctrl+Shift+R (Windows/Linux) ou Cmd+Shift+R (Mac)
3. Recarregue a extensão: Clique em "Recarregar" no cartão da extensão

Mensagem "Contato Não Encontrado"

• E-mail não está no Odoo: Clique em "Criar Contato" para adicioná-lo
• Incompatibilidade de ortografia do e-mail: Atualize o e-mail no Odoo ou crie um novo contato

Erro "Autenticação Falhou"

1. Verifique se sua chave API está correta em Odoo → Preferências → Segurança da Conta
2. Regenere a chave API se necessário
3. Verifique se sua URL do Odoo está correta (incluindo HTTPS)

O popup de permissões não aparece (Odoo Self-Hosted)

Ao conectar a uma instância Odoo self-hosted (URL personalizada), o Chrome requer permissões adicionais. Se o popup de permissões não aparecer:

1. Permissão necessária: URLs Odoo personalizadas (não *.odoo.com) requerem uma permissão adicional do Chrome para comunicar com o seu servidor
2. Outras extensões podem bloquear popups: Bloqueadores de anúncios, extensões de privacidade ou bloqueadores de popups podem impedir que o diálogo de permissões do Chrome apareça
3. Solução: Desative temporariamente outras extensões (especialmente bloqueadores de anúncios) e tente conectar novamente. Reative-as após conceder a permissão

quiz Perguntas Frequentes

Geral

Assinatura

Privacidade

support Obtendo Ajuda

Entre em Contato com o Suporte

Se você tiver dúvidas ou problemas não cobertos neste guia:

• E-mail: odoointegrations.team@gmail.com
• Inclua sua versão do Odoo e versão da extensão
• Descreva o problema com capturas de tela, se possível