Como Ligar o Odoo ao BOTS4.me: Guia de Instalação do Conector (Odoo 13–19)

🧭 Primeiro, Escolha a Sua Via: Onde Corre o Seu Odoo?

Há duas vias de instalação, e a única coisa que decide entre elas é o tipo de alojamento do seu Odoo. Ambas terminam no mesmo ponto: uma única ligação serve todas as aplicações BOTS4.me que funcionam com o Odoo.

Não tem a certeza de qual alojamento tem — ou ainda está a escolher? Consulte Odoo Online vs Odoo.sh vs on-premise: qual pode automatizar?

Nota sobre o plano: o Odoo Online precisa do plano Custom do Odoo para acesso à API; o Odoo.sh e o on-premise funcionam em qualquer plano.

🔌 Via A: Odoo.sh & On-Premise — o Conector de Um Clique

• Passo 1 — Crie a sua conta BOTS4.me. Registe-se em bots4.me/bots, ou salte este passo e crie a conta dentro do Odoo no Passo 3. Cada aplicação de início gratuito começa depois com um mês Discovery gratuito.
• Passo 2 — Instale o «BOTS4.me Connect». Em apps.odoo.com, abra o BOTS4.me Connect, escolha a sua versão do Odoo (13.0 a 19.0) e descarregue o zip gratuito; contém uma pasta, b4m_connect. On-premise: coloque essa pasta num diretório do seu caminho de addons, reinicie o serviço Odoo, ative o modo de programador, abra Aplicações → Atualizar lista de aplicações, pesquise «BOTS4.me Connect» e clique em Ativar (Instalar nas versões mais antigas). Odoo.sh: faça commit da pasta no seu repositório (experimente primeiro um ramo de staging) e faça push; quando a build estiver verde, instale-o a partir de Aplicações na base de dados dessa build. Os módulos de aplicação única na loja (por exemplo «Mail2ERP by BOTS4.me») instalam-se da mesma forma e mostram apenas a sua própria aplicação. O código-fonte é LGPL-3, por isso você ou o seu integrador podem ler cada linha antes de instalar.
• Passo 3 — Execute o assistente de ligação. Como administrador do Odoo, abra BOTS4.me Connect → Definições e clique em Ligar. Escolha «Criar uma nova conta em www.bots4.me» (introduza o seu e-mail; se um parceiro BOTS4.me nos recomendou, coloque o código dele em Código de parceiro) ou «Já tenho uma conta em www.bots4.me» (e-mail e palavra-passe). Depois introduza o código de 6 dígitos do seu e-mail, ou da sua aplicação de autenticação, se usar uma. O assistente comunica diretamente com bots4.me por HTTPS; nenhuma credencial é escrita num ecrã de terceiros.
• Passo 4 — As chaves são criadas por si. Após um início de sessão bem-sucedido, a BOTS4.me emite uma chave API e um segredo de assinatura HMAC para esta base de dados Odoo específica, e o módulo cria um utilizador técnico local, «BOTS4.me Connect», para que os bots leiam e escrevam registos do Odoo por XML-RPC com a sua própria identidade, nunca com o seu login pessoal de administrador. Esse utilizador recebe apenas os direitos do Odoo das aplicações que ativar. Como qualquer utilizador interno, conta para uma subscrição Odoo Enterprise por utilizador. No Odoo 18 e posteriores, o Odoo limita a validade das chaves API: quando o módulo mostrar «A chave API expira em breve», clique em Desligar e depois em Ligar, sem perder nenhuma definição das aplicações.
• Passo 5 — Os formulários de configuração vêm pré-preenchidos. O conector envia os metadados do seu Odoo (URL, UUID da base de dados, bloco de faturação da empresa, endereços dos servidores de correio IMAP) para pré-preencher os formulários de configuração da BOTS4.me. As palavras-passe de correio ficam dentro do seu Odoo até entregar uma caixa de correio a uma aplicação, quer com + O meu correio IMAP (1 clique), quer clicando em Começar o mês Discovery gratuito numa aplicação que lê e-mail. São encriptadas antes de saírem do seu Odoo.
• Passo 6 — Ative a sua primeira aplicação. Em Aplicações, cada aplicação mostra o seu estado (Não ativado, Requer configuração, Ativo, Configurado). Clique uma vez em Complete primeiro a faturação, preencha os seus dados de faturação em bots4.me e depois clique em Começar o mês Discovery gratuito na aplicação que quiser. Esse único clique ativa a aplicação, liga este Odoo como o respetivo ERP e, nas aplicações que leem e-mail, entrega a caixa de correio IMAP do seu Odoo. O que ainda faltar tem o seu próprio botão na aplicação: + Este Odoo como ERP (1 clique), + O meu correio IMAP (1 clique), + Caixa de correio (Gmail, Microsoft 365) ou + Armazenamento na nuvem. Dashboard, Registos e Definições abrem bots4.me já com a sessão iniciada.

☁️ Via B: Odoo Online — Configuração Sem Código com uma Chave API

O Odoo Online (a edição SaaS em odoo.com) não permite módulos Python personalizados — é uma regra da plataforma, não uma limitação do BOTS4.me. Por isso, a via Online utiliza um módulo assistente XML sem código mais uma chave API padrão do Odoo que o próprio utilizador cria (o acesso à API externa faz parte do plano Custom do Odoo):

• Passo 1 — Crie a sua conta BOTS4.me em bots4.me/bots.
• Passo 2 — Crie uma chave API do Odoo. Na sua base de dados Odoo Online, vá a Definições → Utilizadores e Empresas → Utilizadores → o seu utilizador → Segurança da conta (ative o modo de programador se o separador estiver oculto) e clique em Nova chave API. Dê-lhe o nome «BOTS4.me», escolha durante quanto tempo é válida (o Odoo 18 e posteriores perguntam) e copie a chave; o Odoo só a mostra uma vez. Antes de expirar, crie uma nova e cole-a na mesma ligação Odoo em bots4.me (Editar → Atualizar conta ERP).
• Passo 3 — Inicie a aplicação e cole a chave em bots4.me. Inicie sessão em bots4.me/bots, clique em Começar o mês Discovery gratuito no cartão da aplicação e aceite os Termos uma vez — não é necessário cartão de crédito. Depois abra Definições (roda dentada) → a aplicação → Access Manager, clique em Adicionar destino ou Adicionar origem (a aplicação mostra o que precisa), escolha ERP → Odoo e preencha o URL do Odoo (para https://suaempresa.odoo.com, o nome da base de dados preenche-se sozinho), o seu e-mail de login como Nome de utilizador e a chave API em Palavra-passe ou API Key. Clique em Adicionar conta ERP.
• Passo 4 — Adicione o auxiliar sem código (opcional). O módulo «BOTS4.me for Odoo Online» em apps.odoo.com contém apenas registos de dados, sem Python, por isso o Odoo Online aceita-o. Acrescenta ao seu Odoo uma aplicação BOTS4.me com Ligar / Dashboard, Guia de configuração e Como criar uma chave API. Em qualquer dos casos, os bots ligam-se através da API externa normal do Odoo.
• Passo 5 — Verifique em DEMO. No separador Controlo da aplicação, ligue o bot e deixe o Modo em DEMO. Após a primeira execução, recebe um e-mail de relatório DEMO com o que o bot leu e o que teria escrito, e o separador Registos mostra cada decisão; nada muda no Odoo. Quando os relatórios DEMO parecerem corretos, defina o Modo como LIVE no separador Controlo — fica disponível após o primeiro e-mail de relatório DEMO.

🧭 Experimente-o no seu mês Discovery gratuito

O primeiro mês de cada aplicação de início gratuito é um mês Discovery gratuito: a utilização incluída no plano Personal, com muitas funcionalidades Family e Business desbloqueadas para experimentar, e sem necessidade de cartão de crédito. Eis o caminho mais curto de «ligado» até um primeiro resultado no Odoo.

• 1 — Inicie a aplicação. No Odoo (Odoo.sh, on-premise): BOTS4.me Connect → Definições, clique uma vez em Complete primeiro a faturação e depois em Começar o mês Discovery gratuito na aplicação. No Odoo Online: inicie sessão em bots4.me/bots, clique em Começar o mês Discovery gratuito no cartão da aplicação e aceite os Termos uma vez — não é necessário cartão de crédito. Em ambos os casos, o Dashboard mostra depois «Mês Discovery gratuito — faltam N dias».
• 2 — Ligue o que a aplicação precisa. No Odoo, iniciar a aplicação já liga este Odoo e, se o seu Odoo tiver um servidor de correio IMAP, a respetiva caixa de correio. Use + Este Odoo como ERP (1 clique) ou + Caixa de correio (Gmail, Microsoft 365) para o que ainda faltar. No Odoo Online, adicione a ligação Odoo no Access Manager como descrito na Via B, e a caixa de correio com Adicionar origem.
• 3 — Execute-a em DEMO. Abra o separador Controlo da aplicação (ou Controlo rápido no Odoo), ligue o bot e deixe o Modo em DEMO. Os interruptores com a etiqueta Discovery no separador Controlo estão incluídos no seu mês gratuito e começam desligados — ligue os que quiser experimentar.
• 4 — Verifique o resultado. Leia o e-mail de relatório DEMO após a primeira execução e o separador Registos: cada documento que o bot leu e o que teria criado ou alterado no Odoo.
• 5 — Passe a LIVE. Quando os relatórios DEMO parecerem corretos, defina o Modo como LIVE no separador Controlo — fica disponível após o primeiro e-mail de relatório DEMO. O bot passa a escrever no Odoo através da ligação que configurou, com os direitos do respetivo utilizador Odoo.
• 6 — Depois do mês. Quando o mês termina, a aplicação continua sozinha no plano gratuito com uma pequena quota mensal: quando se esgota, os novos itens aguardam até ao mês seguinte ou até escolher um plano, e um item já iniciado é sempre concluído. Escolha um plano para manter todas as funcionalidades — consulte a tabela de planos na página de produto da aplicação.

🔒 O Modelo de Segurança, Explicado com Honestidade

Está a dar a um serviço externo acesso ao seu ERP, por isso deve exigir detalhes concretos — e não apenas um selo de “segurança de nível bancário”. Eis exatamente como o BOTS4.me Connect é construído:

• Só HTTPS, fixado no código. O endpoint da API está fixado em https://bots4.me no código-fonte do módulo — não é um campo de configuração editável, por isso um registo de configuração comprometido não pode redirecionar o seu tráfego de API para um servidor hostil. Cada URL devolvido pela API é verificado antes de o seu navegador o abrir; as respostas que não sejam HTTPS ou que apontem para outro anfitrião são rejeitadas.
• Assinatura de pedidos com HMAC-SHA256. Cada chamada que o módulo faz ao BOTS4.me é assinada com o segredo próprio dessa base de dados, de modo que os pedidos não podem ser falsificados nem adulterados pelo caminho.
• Credenciais restritas a administradores. Os campos da chave API, do segredo de assinatura e do utilizador técnico têm acesso ao nível de campo limitado ao grupo de administração do Odoo (base.group_system). Os utilizadores internos normais podem ver o launchpad e o estado das aplicações, mas os segredos nunca aparecem em nenhuma leitura de registos que possam executar — e todas as ações de ligar, desligar e configurar são exclusivas de administradores.
• Código aberto, LGPL-3. O código-fonte completo vem dentro do zip que descarrega de apps.odoo.com, para que o seu integrador possa auditar exatamente o que sai do seu servidor: metadados para pré-preencher formulários, uma palavra-passe de caixa de correio apenas quando entrega essa caixa de correio a uma aplicação (encriptada antes de sair), e nunca os seus documentos de negócio.
• Registo de auditoria em ambos os lados. O módulo mantém dentro do Odoo um registo local de eventos com as ligações, as alterações de configuração e os erros; o painel do BOTS4.me mantém registos completos das decisões de cada execução.
• Atualização automática de direitos. Uma tarefa agendada (cron) volta a verificar regularmente as suas subscrições, de modo que o estado das aplicações no launchpad se mantém atualizado — e uma aplicação cancelada deixa de ser servida rapidamente.

Mais informação sobre a segurança da plataforma e o acesso gradual: bots4.me/security e níveis de acesso. A plataforma está alojada na UE, foi concebida para o RGPD, e o 2FA está disponível em todas as contas.

✅ Depois de ligar: uma ligação para todas as aplicações Odoo

Instala o conector uma única vez; não há nada extra a instalar por aplicação. Uma única ligação serve todas as aplicações BOTS4.me que funcionam com o Odoo: Mail2ERP, AutoERP, Pay2ERP, Supplier2ERP e AutoCASH, além de AutoSTOCK, AutoPURCHASE e ClientFACTORY. AutoSPAM, Mail2CLOUD e Mail2KNOW só precisam de uma caixa de correio, que o conector pode transferir a partir do seu Odoo com um clique. Cada aplicação é iniciada separadamente, a partir da sua linha no Odoo ou do seu cartão em bots4.me/bots.

Cada aplicação começa em DEMO: lê, decide e envia-lhe por e-mail um relatório DEMO, mas não escreve nada. Quando os relatórios DEMO parecerem corretos, defina o Modo como LIVE no separador Controlo — fica disponível após o primeiro e-mail de relatório DEMO. Em bots4.me, o separador Controlo de cada aplicação contém Ligar/desligar o bot, o Modo, o Modo de IA (Desligado, IA Essencial, IA Premium ou Ultra, consoante a aplicação), o Agendamento de execução e o Horário de funcionamento quando a aplicação os tem, e os interruptores das funcionalidades. O separador Registos mostra cada decisão. No Odoo, o Controlo rápido na linha da aplicação abrange Ligar/desligar o bot, o Agendamento de execução, o Modo Demo e o Modo de IA. Para saber o que automatizar primeiro, consulte o guia principal: Como automatizar o Odoo de ponta a ponta.

📚 Guias relacionados

• Comece aqui: Como automatizar o Odoo de ponta a ponta: da encomenda por e-mail à fatura paga
• Alojamento: Odoo Online vs Odoo.sh vs on-premise: qual pode automatizar?
• Primeiros bots a ligar: Importar encomendas do e-mail para o Odoo · Conciliar automaticamente os pagamentos bancários com as faturas
• Para integradores: Gere receita recorrente como parceiro Odoo

🔗 Fontes e leituras adicionais

Documentação oficial e normas citadas neste guia. As ligações externas abrem num novo separador.

• Odoo 18 developer reference — External API and API keys
• BOTS4.me Connect on the Odoo Apps Store
• Odoo 18 documentation — Access rights
• Odoo — Supported versions