Guia do Usuário

Tudo o que você precisa saber para aproveitar ao máximo a Integração Odoo para Gmail

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.
Nota sobre "Navegação segura aprimorada": Se você vir uma mensagem dizendo "Esta extensão não é confiável pela Navegação segura aprimorada", isso é normal para extensões recém-publicadas. A extensão foi revisada e aprovada pela Chrome Web Store.

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.
info A criação de chaves API varia entre as versões do Odoo. Veja o guia detalhado para a sua versão →

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

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"
Informações da Licença: Sua licença funciona em até 3 instâncias (diferentes computadores ou navegadores). Deve ser usada com a mesma conta Gmail usada na compra.
Período de Teste: PLUS inclui um período de teste gratuito de 14 dias. Você não será cobrado até o período de teste terminar. Cancele a qualquer momento antes para evitar cobranças.
Preços Regionais: Oferecemos preços justos. Os preços são automaticamente ajustados no checkout através de um desconto.

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"
Registrado como Nota Interna: Os e-mails são registrados como notas internas no chatter do Odoo. Isso significa que apenas usuários internos (funcionários) podem vê-los. Usuários do portal (clientes) NÃO verão os e-mails registrados. As notificações são enviadas apenas para seguidores internos do registro.

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
Importante: Mesmo sem o indicador visual, você não pode criar duplicados acidentalmente. O servidor do Odoo valida cada solicitação de registro e rejeita duplicados.

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
Importante: O e-mail NÃO é registrado automaticamente. Para associar o e-mail ao novo lead, volte ao Gmail e clique no ícone do envelope ao lado da oportunidade.

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")
Isto garante que o Odoo envia emails de notificação para o seu Gmail, onde a extensão pode identificá-los e organizá-los.

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.
Dica: Se não tem a certeza de qual email o Odoo usa para notificações, verifique um email de notificação recente no Gmail e veja o endereço do remetente.

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
Como funciona: A deteção de menções baseia-se nas mensagens armazenadas no registo do Odoo, não no email em si. A extensão verifica o chatter do registo procurando @menções ou referências ao seu nome. Isto significa:
  • Se mudou recentemente de "Gerir no Odoo" para "Gerir por emails", threads mais antigas podem mostrar um badge "Mencionado" por menções que ocorreram antes de começar a receber emails — mesmo que a menção não apareça em nenhum email do Gmail.
  • O estado lido/não lido é determinado por ter aberto ou não a thread no Gmail depois da menção. Assim que abre a thread, o badge fica cinzento.

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.

Nota: O atalho só aparece depois de configurar um email de notificação em Definições > Notificações.

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

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
Nota: Esta permissão é necessária apenas uma vez por URL Odoo. Após concedê-la, a extensão funcionará normalmente com sua instância self-hosted.

quiz Perguntas Frequentes

Geral

P: Quais versões do Odoo são suportadas?

Odoo 14.0 e superiores são suportados. Compatível com instalações on-premise (Community/Enterprise), Odoo.sh e Odoo Online (apenas plano Custom, pois os planos Standard e Free não têm acesso à API externa).

P: Funciona com outros navegadores?

Atualmente, a extensão suporta apenas Google Chrome. O suporte para outros navegadores pode ser adicionado no futuro.

P: Meus dados estão seguros?

Sim. A extensão só acessa e-mails que você visualiza ativamente e se comunica de forma segura com sua instância Odoo via HTTPS. Sua chave API é armazenada no armazenamento seguro do Chrome.

Assinatura

P: Qual é a diferença entre FREE e PLUS?

FREE inclui recursos básicos (visualização de contatos, registro de e-mail, registros limitados). PLUS adiciona pesquisa avançada, insights financeiros, contatos relacionados, organização de emails de notificação e opções de personalização.

P: Posso cancelar minha assinatura PLUS a qualquer momento?

Sim, você pode cancelar a qualquer momento sem penalidade. Sua assinatura permanecerá ativa até o final do seu período de faturamento atual.

Privacidade

P: A extensão lê todos os meus e-mails?

Não, a extensão só acessa e-mails que você visualiza ativamente. Ela não escaneia toda a sua caixa de correio nem lê e-mails em segundo plano.

P: Minha chave API é armazenada de forma segura?

Sim, sua chave API é armazenada no armazenamento seguro do Chrome (chrome.storage.sync), que o Chrome criptografa usando as credenciais da sua conta de usuário do sistema operacional.

support Obtendo Ajuda

Entre em Contato com o Suporte

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