API do Mailjet¶
O Odoo é compatível com a API do Mailjet para envio de distribuições em massa. Configure um servidor de distribuições em massa dedicado pelo Mailjet, definindo as configurações na conta do Mailjet e na base de dados do Odoo. Em algumas circunstâncias, as configurações também precisam ser definidas nas configurações do DNS do domínio personalizado.
Configuração no Mailjet¶
Criar credenciais de API¶
Para começar, faça login na página de Informações da conta do Mailjet. Em seguida, navegue até a seção Remetentes e Domínios e clique em Definições de API SMTP e SEND.
Em seguida, copie as definições de configuração do SMTP em um bloco de notas. Elas podem ser encontradas na seção Configuração (somente SMTP). As definições de configuração de SMTP incluem o endereço do servidor, a opção de segurança necessária (Use SSL/TLS) e o número da porta. As definições são necessárias para configurar o Mailjet no Odoo, o que é abordado na última seção.
Importante
Odoo bloqueia a porta 25 nas bases de dados Odoo Online e Odoo.sh. Consulte as instruções aqui.
Então, clique no botão giratório Recuperar suas credenciais de API para recuperar as credenciais da API do Mailjet.
Em seguida, clique no ícone de olho para exibir a :guilabel:` chave da API`. Copie essa chave em um bloco de notas, pois ela servirá como o Nome de usuário na configuração do Odoo. Em seguida, clique no botão Gerar chave secreta para gerar a Chave secreta. Copie essa chave em um bloco de notas, pois ela servirá como a Senha na configuração do Odoo.
Adicionar endereço(s) de remetente verificado(s)¶
A próxima etapa é adicionar o endereço do remetente ou um domínio às definições da conta do Mailjet para que os endereços ou domínios de e-mail sejam aprovados para envio através de servidores do Mailjet. Primeiro, navegue à página de informações da conta do Mailjet. Em seguida, clique no link Adicionar endereço ou domínio de remetente na seção Remetentes e Domínios.
Defina se o endereço de e-mail ou o domínio inteiro do rementente deve ser adicionado às definições do Mailjet. Pode ser mais fácil configurar o domínio como um todo se o acesso ao DNS estiver disponível. Passe para a seção Adicionar um domínio para etapas de adição de domínio.
Nota
Todos os endereços de e-mail dos usuários da base de dados do Odoo que estão enviando e-mails por servidores do Mailjet devem ser configurados ou os domínios dos endereços de e-mail dos usuários podem ser configurados.
Por padrão, o endereço de e-mail originalmente configurado na conta do Mailjet é adicionado como um remetente confiável. Para adicionar outro endereço de e-mail, clique no botão rotulado como Adicionar um endereço de remetente. Em seguida, adicione o endereço de e-mail que está configurado para enviar do domínio personalizado.
No mínimo, os seguintes endereços de e-mail devem ser configurados no provedor e verificados no Mailjet:
notificaçoes@seudomínio.com
devolvidos@seudomínio.com
catchall@seudomínio.com
Nota
Substitua seudomínio pelo domínio personalizado da base de dados do Odoo. Se não houver um, use o parâmetro do sistema mail.catchall.domain.
Depois disso, preencha o formulário Informações do e-mail, certificando-se de selecionar o tipo de e-mail adequado: e-mail transacional ou e-mails em massa. Depois de preencher o formulário, um e-mail de ativação é enviado para o endereço de e-mail e remetente confiável pode ser ativado.
Recomenda-se configurar as definições de SPF/DKIM/DMARC no domínio do remetente.
Veja também
Importante
Se a base de dados não estiver usando um domínio personalizado, para verificar o endereço do remetente, um alias temporário (dos três endereços de e-mail mencionados acima) deve ser configurado no Odoo CRM para criar leads. Em seguida, a base de dados poderá receber o e-mail de verificação e verificar as contas.
Adicionar um domínio¶
Ao adicionar um domínio inteiro à conta do Mailjet, todos os endereços de remetente relacionados a esse domínio são automaticamente validados para envio de e-mails pelos servidores do Mailjet. Primeiro, navegue até a página de informações de conta do Mailjet. Então, clique no link Adicionar endereço ou domínio de remetente na seção Remetentes e Domínios. Em seguida, clique em Adicionar domínio para adicionar o domínio personalizado.
Nota
O domínio precisa ser adicionado à conta do Mailjet e, em seguida, validado pelo DNS.
Depois disso, preencha a página Adicionar novo domínio no Mailjet e clique em Continuar.
Após adicionar o domínio, uma página de validação será preenchida. A menos que a base de dados do Odoo seja local (nesse caso, escolha a Opção 1), escolha a Opção 2: Criar um registro DNS. Copie as informações do registro em TXT em um bloco de notas e navegue até o provedor de DNS do domínio para concluir a validação.
Configuração no DNS do domínio¶
Depois de obter as informações do registro em TXT da conta do Mailjet, adicione um registro em TXT ao DNS do domínio. Esse processo varia de acordo com o provedor de DNS. Consulte o provedor para obter informações sobre processos de configuração específicos. As informações do registro em TXT consistem em Host e Valor. Cole-as nos campos correspondentes do registro em TXT.
Retornar às informações da conta Mailjet¶
Depois de adicionar o registro em TXT ao DNS do domínio, volte para a conta do Mailjet. Em seguida, navegue até , clique no ícone de engrenagem ao lado de Domínio e selecione Validar.
Esta ação também pode ser feita acessando a página Endereços e domínios do remetente nas informações da conta do Mailjet e clicando em Gerenciar.
Em seguida, clique em Verificar agora para validar o registro em TXT que foi adicionado ao domínio. Uma tela de sucesso será exibida se o domínio estiver configurado corretamente.
Após a configuração bem-sucedida do domínio, há uma opção para Autenticar este domínio (SPF/DKIM). Esse botão preenche os registros SPF e DKIM para inserir no provedor de DNS.
Veja também
Configuração no Odoo¶
Para concluir a configuração, navegue até a base de dados do Odoo e vá para Definições. Com o modo desenvolvedor ativado, vá para o . Em seguida, crie uma nova configuração de servidor de envio clicando no botão Criar.
Em seguida, insira o Servidor SMTP (in-v3.mailjet.com), o Número da porta (587 ou 465) e a Segurança (SSL/TLS) que foram copiados anteriormente da conta do Mailjet. Eles também podem ser encontrados aqui. É recomendável usar SSL/TLS, mesmo que o Mailjet não exija isso.
No Nome de usuário, insira a chave da API. Na Senha, insira a chave secreta que foi copiada da conta do Mailjet para o bloco de notas anteriormente. Essas configurações podem ser encontradas em .
Então, se o servidor do Mailjet for usado para distribuições em massa, defina o valor de Prioridade dele como mais alto do que o de servidores de e-mail transacionais. Por fim, salve as configurações e Teste a conexão.
Importante
Para que o recurso de notificações funcione com o Mailjet, há três configurações que precisam ser feitas no Odoo
O Filtro DE deve ser definido na configuração do servidor. É recomendável defini-lo como um domínio e não como um endereço de e-mail completo. Isso deve corresponder ao domínio nas duas etapas seguintes. Mais informações podem ser consultadas aqui.
O parâmetro do sistema mail.default.from deve ter o valor
notificaçoes@seudomínio.com.O parâmetro do sistema mail.default.from_filter deve ter o valor
seu domínio.com. Substituaseudomíniopelo domínio personalizado da base de dados do Odoo. Se não houver um, use o parâmetro do sistema mail.catchall.domain.
Para obter mais informações, consulte Como usar um endereço de e-mail padrão.
Os parâmetros do sistema podem ser acessados ativando o :ref:`modo de desenvolvedor <developer-mode>.
Quando a configuração estiver concluída, a base de dados do Odoo estará pronta para usar o servidor de e-mail Mailjet para envio em massa ou e-mails transacionais!