Google Workspace / Gmail

Gostaria de usar a sua conta Gmail ou Google Workspace (anteriormente G Suite) para corrigir problemas de entrega de e-mail no seu site? A opção Google Workspace / Gmail do WP Mail SMTP utiliza a API do Google para autenticar de forma segura os e-mails do seu site, ajudando-os a chegar com sucesso às caixas de entrada dos seus utilizadores.

Este tutorial irá mostrar-lhe como configurar o WP Mail SMTP utilizando o remetente Google Workspace / Gmail com o seu endereço de e-mail Gmail ou Google Workspace.

---

Instalar e Configurar o Plugin WP Mail SMTP

Antes de começar, terá de instalar e ativar o plugin WP Mail SMTP.

Depois de ter verificado a sua licença, está pronto para configurar as definições do plugin. Pode encontrá-las acedendo a WP Mail SMTP » Definições e procurando no separador Geral.

Abaixo, abordaremos as definições necessárias para esta configuração.

E-mail de Origem

Este é o endereço de e-mail a partir do qual todos os e-mails do seu site serão enviados. Pode digitar o seu endereço de e-mail no campo fornecido, incluindo quaisquer alias que tenha configurado, depois de ligar o seu site à API do Gmail em passos posteriores.

A opção Forçar E-mail de Origem fará com que todos os e-mails enviados do seu site provenham do endereço que introduziu.

Nome de Origem

Abaixo do E-mail de Origem, pode definir o Nome de Origem. Este é o nome associado aos e-mails que o seu site envia. Por defeito, será definido como o nome do seu site, mas pode ajustá-lo para o que desejar.

Também pode marcar a opção Forçar Nome de Origem para aplicar esta definição em todo o site.

Servidor de E-mail

É aqui que pode escolher qual o remetente que o seu site deve usar. Selecione a opção Google / Gmail.

Depois de escolher este remetente, deverá ver uma nova secção intitulada Google / Gmail com mais opções de autorização.

Existem duas formas de configurar o remetente Google Workspace / Gmail: Usando a Configuração com Um Clique ou criando manualmente uma aplicação Google personalizada para gerar o seu ID de Cliente e Segredo do Cliente.

Se estiver a decidir entre a Configuração com Um Clique e a configuração manual, aqui fica uma comparação rápida:

	Configuração Manual	Configuração com Um Clique (Pro)
Facilidade de Utilização	Guia passo a passo para o ajudar	Conexão instantânea com passos mínimos
Passos Técnicos	Requer a criação de uma aplicação Google e a configuração de credenciais	Não é necessária configuração manual
Tempo Necessário	Aproximadamente 30-60 minutos	Menos de 2 minutos
Suporte	Acesso a documentação extensa	Suporte prioritário da nossa equipa
Ideal Para	Utilizadores que preferem um processo de configuração e aprendizagem detalhado	Utilizadores que procuram a configuração mais rápida e fácil

Procura a forma mais rápida de começar? A Configuração com Um Clique simplifica o processo para que possa começar a enviar e-mails imediatamente.

👉 Atualize para Pro & Ative a Configuração com Um Clique

No entanto, se preferir configurar as coisas manualmente, avance para a secção criação de uma aplicação web deste guia para continuar.

Ativar Configuração com Um Clique

Para uma configuração de e-mail mais fácil e rápida, recomendamos a utilização da funcionalidade de Configuração com Um Clique. Permite ligar o seu site ao Gmail / Google Workspace com apenas alguns cliques.

Após selecionar Google / Gmail como o seu remetente nas definições do WP Mail SMTP, encontrará a opção para ativar a Configuração com Um Clique. Basta mudar este interruptor para a posição LIGADO para iniciar o processo de configuração simplificado.

Para informações mais detalhadas sobre o processo de Configuração com Um Clique, certifique-se de consultar o nosso guia sobre Configuração com Um Clique do Gmail / Google Workspace.

Criar uma Aplicação Web na Sua Conta Google

Voltará à página de definições do WP Mail SMTP um pouco mais tarde, por isso, para este passo, abra um novo separador ou janela no seu navegador.

Na nova janela ou separador que abriu, inicie sessão na sua conta Google e abra a sua Google Cloud Console.

Se for a primeira vez que utiliza a Google Cloud Console, poderá ver um pop-up a pedir para selecionar o seu país e concordar com os Termos de Serviço. Prossiga e faça-o, depois clique em CONCORDAR E CONTINUAR para avançar para o próximo passo.

Se já iniciou sessão na Google Cloud Console antes, provavelmente irá ignorar os Termos de Serviço.

Criação ou Escolha de um Projeto

Primeiro, terá de escolher um projeto para usar na sua aplicação. Pode selecionar um existente ou criar um novo.

Para o fazer, clique no menu suspenso de projetos na barra de ferramentas no topo do seu painel.

No pop-up que aparece, selecione um projeto existente na lista ou clique em Novo Projeto no canto superior direito.

Se selecionou um projeto existente, avance para o próximo passo. Para um novo projeto, introduza um nome de projeto e selecione uma organização e localização nos menus suspensos.

Depois clique no botão CRIAR.

Ativação da API Gmail

Em seguida, precisa de ativar a API Gmail para o seu projeto. Na barra lateral da sua Google Cloud Console, vá a APIs e Serviços » Biblioteca.

Em seguida, procure por Categoria e clique em Google Workspace, ou introduza “Gmail API” na barra de pesquisa.

Clique no resultado Gmail API.

Na página da Gmail API, clique no botão azul ATIVAR.

Criação das Credenciais da Sua Aplicação

Após ativar a Gmail API, deverá ser redirecionado para a página de Visão Geral da Gmail API. Aqui, clique no botão Criar credenciais.

Na página seguinte, o Google fará algumas perguntas para determinar o Tipo de Credencial de que necessita. No menu suspenso Selecionar uma API, escolha Gmail API.

Em seguida, em Que dados irá aceder?, selecione a opção Dados do utilizador. Depois clique no botão SEGUINTE para prosseguir.

Configuração do Ecrã de Consentimento OAuth

O Google pedirá então algumas informações básicas sobre a sua aplicação.

Esta secção é maioritariamente para uso pessoal, uma vez que mais ninguém irá usar a sua aplicação. No entanto, alguns campos ainda estão marcados como obrigatórios:

• Nome da aplicação: Introduza um nome de aplicação à sua escolha (ex: Aplicação da Pattie).
• Email de suporte ao utilizador: Selecione o seu endereço de email nas opções fornecidas.
• Logótipo da aplicação: Se desejar, pode carregar um logótipo para a sua aplicação. Isto é opcional.

Finalmente, adicione o seu endereço de email no campo Endereços de email. Depois clique no botão GUARDAR E CONTINUAR para prosseguir para o próximo passo.

Configuração de Escopos (Opcional)

Este é um passo opcional que iremos saltar para este tutorial. Role para baixo até ao final da secção Escopos e clique no botão GUARDAR E CONTINUAR para prosseguir.

Configuração do ID do Cliente OAuth

Em seguida, terá de preencher algumas informações sobre o seu ID de Cliente OAuth.

No menu suspenso Tipo de aplicação, selecione a opção Aplicação Web. Assim que o fizer, mais campos serão preenchidos automaticamente.

Pode deixar o campo Nome como o valor predefinido ou alterá-lo para algo mais relevante. Para este exemplo, manteremos o nome predefinido, Cliente Web 1.

Em seguida, salte a secção Origens JavaScript autorizadas e role até URIs de redirecionamento autorizadas.

Clique no botão + ADICIONAR URI e introduza o seguinte: https://connect.wpmailsmtp.com/google/. Também pode copiar este valor das suas definições do WP Mail SMTP e colá-lo aqui, se preferir.

Depois clique no botão Criar para concluir este passo.

Assim que a sua aplicação for criada, a secção As Suas Credenciais expandir-se-á para lhe mostrar o seu ID de Cliente. Não há necessidade de o copiar agora, pois irá acedê-lo a partir de outra área num passo posterior.

Em vez disso, prossiga e clique no bot ildeo CONCLU ilde{I}DO na parte inferior da p ilde{A}gina.

Atualizar o Estado de Publicação de Teste para Produção

O Google colocar ilde{A} a sua aplica ilde{A}"00o em modo Interno por defeito. ilde{A} muito importante que a mude para modo Externo e a publique. Caso contr ilde{A}rio, a sua aplica ilde{A}"00o ser ilde{A} super limitada e n ilde{A}o funcionar ilde{A} corretamente.

No painel lateral da sua Google Cloud Console, v ilde{A} para APIs e servi ilde{A}os extbar} Ecr ilde{A} ilde{A} de consentimento OAuth.

Em seguida, selecione o separador P ilde{A} ilde{A}blico.

O ecr ilde{A} ilde{A} exato que ver ilde{A} a seguir variar ilde{A} dependendo se est ilde{A} a usar uma conta Gmail gratuita ou uma conta Google Workspace.

Utilizadores do Google Workspace

Em Tipo de utilizador, clique no bot ildeo TORNAR EXTERNO.

Na janela pop-up que aparece, selecione a op ilde{A}"00o Em produ ilde{A}"00o. Em seguida, clique em Confirmar.

Utilizadores Gmail

Se n ilde{A}o estiver a usar o Google Workspace, n ilde{A}o ver ilde{A} a op ilde{A}"00o TORNAR EXTERNO. Em vez disso, ter ilde{A} de publicar a sua aplica ilde{A}"00o Google.

Em Estado de publica ilde{A}"00o, ver ilde{A} que o estado da aplica ilde{A}"00o est ilde{A} definido como Teste. Prossiga e clique no bot ildeo PUBLICAR APLICA ilde{A}"00O para atualizar o estado da sua aplica ilde{A}"00o.

Na sobreposi ilde{A}"00o que aparece, clique em CONFIRMAR para publicar a sua aplica ilde{A}"00o.

Ap ilde{A}"00os a confirma ilde{A}"00o estar completa, ver ilde{A} que o estado de publica ilde{A}"00o da sua aplica ilde{A}"00o ilde{A} agora Em produ ilde{A}"00o.

Conceder Permissões Google / Gmail ao Seu Site

Em seguida, navegue para APIs e servi ilde{A}os extbar} Credenciais no menu lateral esquerdo.

Uma vez l ilde{A}, procure na sec ilde{A}"00o IDs de cliente OAuth 2.0. Ver ilde{A} os detalhes da aplica ilde{A}"00o web que acabou de criar. Para ver o ID de cliente e o Segredo do cliente, clique no ilde{A}"00cone do l ilde{A}"00pis.

Isto abrir ilde{A} todos os detalhes da sua aplica ilde{A}"00o. No lado direito desta p ilde{A}"00gina, ver ilde{A} o ID de cliente.

Desloque-se para baixo at ilde{A}"00 a sec ilde{A}"00o Segredos do cliente. Em seguida, clique no bot ildeo + Adicionar segredo.

Ver ilde{A} o novo segredo do cliente abaixo do segredo predefinido. Clique no ilde{A}"00cone de c ilde{A}"00pia para copiar o seu valor.

Prossiga e copie ambos estes valores para os campos correspondentes nas suas defini ilde{A}"00es do WP Mail SMTP.

Ap ilde{A}"00os ter adicionado estes valores, clique no bot ildeo Guardar defini ilde{A}"00es na parte inferior da p ilde{A}"00gina.

Ap ilde{A}"00os guardar as suas defini ilde{A}"00es, a p ilde{A}"00gina ser ilde{A} atualizada. Tem de conceder permiss ilde{A}"00o antes que o Google permita que o nosso plugin use a sua API Gmail para enviar emails.

Para fazer isto, navegue até ao final da página de definições do WP Mail SMTP e clique no botão com o texto Permitir que o plugin envie e-mails usando a sua conta Google.

Isto abrirá um ecrã de início de sessão para o Google. Prossiga e inicie sessão na conta com a qual está a configurar o SMTP.

Em seguida, verá um ecrã a pedir permissão para que este site envie e-mails em seu nome.

Quando estiver pronto, clique no botão Permitir para continuar.

Ignorar o Aviso de Verificação do Google (Apenas para Utilizadores Gratuitos do Gmail)

Poderá ver o seguinte ecrã se estiver a ligar com uma conta gratuita do Gmail. Prossiga e clique na ligação Avançadas no canto inferior esquerdo.

Na secção expandida, clique em Ir para wpmailsmtp.com (inseguro). Não se preocupe, o Google apenas exibe este aviso porque não verificou a sua aplicação. Não há necessidade de a verificar, uma vez que criou esta aplicação apenas para o seu próprio uso.

Em seguida, clique no botão Permitir, como mostrado acima.

Ligação de Reserva

A configuração de uma Ligação de Cópia de Segurança é opcional e não é necessária para completar a configuração do seu mailer do Google Workspace / Gmail. No entanto, para melhorar ainda mais a entrega de e-mails, recomendamos configurar uma ligação adicional para servir de cópia de segurança, caso a sua Ligação Principal falhe.

Enviar um E-mail de Teste

Em seguida, será redirecionado para as suas definições do WP Mail SMTP e será exibida uma mensagem de sucesso. Assim que a ligação estiver completa, estará pronto para enviar um e-mail de teste. Para o fazer, navegue para WP Mail SMTP » Ferramentas e abra o separador Teste de E-mail.

Assim que o separador Teste de E-mail estiver aberto, terá de introduzir um endereço de e-mail cuja caixa de entrada tenha acesso.

Em seguida, escolha se pretende enviar um e-mail em texto simples ou HTML. A menos que saiba que só enviará e-mails em texto simples, recomendamos que deixe a definição HTML ativada. Em seguida, clique no botão Enviar E-mail.

Verá uma mensagem de sucesso quando o e-mail de teste tiver sido enviado.

Deverá também receber em breve o e-mail de teste no endereço de e-mail que introduziu.

Perguntas Frequentes

Estas são algumas das principais questões que recebemos sobre a configuração do mailer do Google Workspace / Gmail.

E se o e-mail de teste não for enviado com sucesso?

Se o e-mail de teste SMTP não puder ser enviado, aparecerá um registo de depuração com detalhes adicionais. Aqui estão algumas das possíveis mensagens de erro e como resolvê-las.

401. Erro.
Erro: invalid_client

Este erro aparece quando o ID do Cliente não pode ser lido corretamente. Para o corrigir, tente copiar e colar novamente o seu ID do Cliente e verifique se não há espaços em branco ou texto extra.

400. Erro.
Erro: invalid_request
Parâmetro obrigatório em falta: client_id

Este erro será exibido quando o campo ID do Cliente estiver vazio ou não puder ser lido corretamente. Para o corrigir, tente copiar e colar novamente o seu ID do Cliente e verifique se não há espaços em branco ou texto extra.

Erro cURL 60: problema com o certificado SSL

Esta mensagem significa que o servidor não tem um certificado necessário para o funcionamento do SMTP. Para corrigir isto, terá de contactar o seu fornecedor de alojamento para pedir a instalação deste certificado (muito provavelmente o certificado cacert.pem, mas é melhor pedir ao seu fornecedor para verificar).

“code”: 401,
“message”: “Login Obrigatório”

Se vir isto na mensagem de depuração, ainda precisa de conceder permissão para o WP Mail SMTP aceder à sua conta Google. Para instruções sobre como corrigir isto, consulte o Passo 4 deste tutorial. Além disso, certifique-se de que o Email de Remetente nas suas definições SMTP corresponde ao email utilizado para configurar a sua aplicação Google.

Entidade de Pedido Demasiado Grande
Erro 413

Se estiver a ver este erro, é provável que os ficheiros enviados através dos seus formulários excedam o limite do Gmail para anexos de ficheiros diretos em emails. Este limite é aplicado à soma do texto da mensagem, bem como ao anexo codificado. Para evitar este erro, terá de garantir que todos os ficheiros não são maiores que 22 MB.

Ocorreu um problema ao recuperar a autenticação para o Gmail: Não foi possível decodificar o token JSON

Este erro é um possível indicador de que outro plugin (como o UpdraftPlus) está a carregar uma versão diferente da API do Google no site, criando um conflito. Se possível, o plugin em conflito deve ser desativado. Caso contrário, recomenda-se que configure um remetente de email diferente.

Se nada do acima se aplicar, ou se o email de teste ainda não estiver a funcionar, a API do Gmail na sua conta Google pode estar desativada. Para verificar isto, siga o guia do Google para ativar uma API.

E se vir um ecrã a dizer "Esta aplicação não está verificada"?

Quando clica no botão Permitir que o plugin envie emails usando a sua conta Google nas suas definições do WP Mail SMTP, o Google pode exibir um ecrã a dizer: "Esta aplicação não está verificada. Esta aplicação ainda não foi verificada pelo Google. Prossiga apenas se conhecer e confiar no programador."

No entanto, não há necessidade de se preocupar. Esta mensagem refere-se apenas à aplicação que criou na sua própria conta Google, pelo que é, na verdade, o programador neste caso.

Para ignorar esta mensagem, clique em Avançadas e depois clique em Ir para wpmailsmtp.com (não seguro).

E se eu quiser mudar para um email diferente mais tarde?

Se desejar mudar para um endereço de email diferente do Gmail ou Google Workspace, terá de repetir todos os passos do tutorial acima. Isto inclui gerar um novo ID de Cliente e Segredo de Cliente nesta outra conta de email.

Quando chegar à etapa de Autorização (Passo 4), guarde as suas definições e clique no botão Remover Ligação. Isto removerá a autorização para a sua conta de email original e permitir-lhe-á repetir os passos de autorização com o seu novo email.

O remetente do Google Workspace / Gmail suporta aliases?

Sim, a partir de julho de 2020, o WP Mail SMTP suporta aliases do Gmail. Para mais detalhes sobre como configurar um alias no Google, consulte o seu guia sobre como enviar emails a partir de um alias.

Posso usar o remetente do Google Workspace / Gmail se tiver a Autenticação de Dois Fatores (2FA) ativada na minha conta Google?

Pode definitivamente usar a Autenticação de Dois Fatores com a opção Google Workspace / Gmail do WP Mail SMTP. No entanto, é importante notar que, se optar por desativar a 2FA ou alterar a palavra-passe da sua conta, terá de passar novamente pelo processo de configuração.

Ao autorizar a minha aplicação, recebo a seguinte mensagem de erro:

Erro 403: access_denied. O programador não lhe deu acesso a esta aplicação.

Esta mensagem significa que as permissões da sua aplicação estão definidas para o modo de teste no Google Cloud.

Para resolver isto, certifique-se de que muda o modo de teste para produção e tenta autorizar a sua aplicação mais uma vez.

Se alterar a minha palavra-passe, terei de me reconectar?

Sim, se a sua palavra-passe for alterada, a ligação existente será invalidada. Para resolver isto, terá de criar uma nova ligação, utilizando as suas novas credenciais.

Preciso de submeter a minha aplicação ao Google para verificação para que funcione com o WP Mail SMTP?

Não é necessário submeter a sua aplicação para verificação. No entanto, pode fazê-lo se desejar. Se optar por submeter a sua aplicação para verificação, pode continuar o processo de autorização no WP Mail SMTP sem esperar pela verificação do Google.

Porque é que o URI de redirecionamento aponta para connect.wpmailsmtp.com?

Definimos o URI de redirecionamento para passar pelo nosso site para que possamos resolver o erro 403 proibido que alguns utilizadores experienciam quando o mod_security os impede de completar a ligação OAuth.

Como altero o URI de redirecionamento para que aponte para o meu próprio site?

Se preferir não usar o URI de redirecionamento OAuth padrão (connect.wpmailsmtp.com) para segurança e privacidade adicionais, pode facilmente redirecioná-lo para o seu próprio site.

Para fazer isto, primeiro terá de adicionar o seguinte trecho de código ao seu site WordPress.

Em seguida, aceda às suas definições de remetente em WP Mail SMTP » Definições » Geral e copie o novo URL da secção URI de redirecionamento autorizado.

Finalmente, vá às definições de ID de cliente OAuth da sua Aplicação Google e substitua o URI de redirecionamento existente pelo que acabou de copiar. Isto garante que os pedidos de autorização serão agora direcionados para o seu próprio site.

Ao adicionar o URI de redirecionamento, recebo a seguinte mensagem de erro:

Origem inválida: os URIs não devem conter um caminho ou destino com "/"

Este erro ocorre quando adiciona o URI de redirecionamento à secção Origens JavaScript autorizadas em vez da secção URIs de redirecionamento autorizados.

Para resolver este problema, remova o URI que adicionou da secção de origens JavaScript autorizadas e adicione-o à secção de URIs de redirecionamento autorizados. Consulte a secção ID do cliente para obter detalhes adicionais.

O que devo fazer se encontrar um erro “redirect_uri_mismatch” durante a configuração?

Este erro geralmente significa que há uma incompatibilidade no URI de redirecionamento autorizado na sua Google Cloud Console. Deve ser definido como https://connect.wpmailsmtp.com/google/. Além disso, certifique-se de que, para a sua aplicação Google, atualizou o estado de publicação de Teste para Produção.

Para mais orientações sobre como corrigir este erro, consulte a documentação da SendLayer sobre como resolver o erro de incompatibilidade de URI de redirecionamento.

O WP Mail SMTP para de funcionar periodicamente e continuo a receber a seguinte mensagem de erro:

"Mailer: Google / Gmail
{ "error": "invalid_grant", "error_description": "Bad Request" }

Este erro indica geralmente que existem problemas de permissão devido à invalidação da chave do Segredo do Cliente. Pode acontecer quando altera a sua palavra-passe do Gmail ou ativa a autenticação de dois fatores na sua conta.

Para resolver isto, terá de regenerar os seus tokens ou passar novamente pelo processo de configuração.

Para regenerar os seus tokens, inicie sessão na Google Cloud Console e, em seguida, selecione Credenciais na secção API e Serviços.

Na secção IDs de cliente OAuth 2.0, terá de clicar no ícone de lápis para editar as suas credenciais.

Em seguida, navegue até à secção Segredos do cliente e clique em + Adicionar segredo para gerar uma nova chave.

Após gerar o novo segredo, terá de atualizar o Segredo do Cliente nas definições do WP Mail SMTP com a nova chave. Prossiga e copie a chave do Segredo do Cliente.

Em seguida, inicie sessão no seu painel WordPress e vá para WP Mail SMTP » Definições.

No separador Geral, navegue até à secção Google / Gmail e cole a chave que copiou no campo Segredo do Cliente.

Depois de adicionar o novo Segredo do Cliente, certifique-se de que guarda as suas alterações.

Após enviar um e-mail de teste, vejo a seguinte mensagem de erro:

O e-mail de teste pode ter sido enviado, mas a sua entregabilidade deve ser melhorada.

Este erro ocorre geralmente se estiver a usar um endereço de e-mail de domínio personalizado e não adicionou registos SPF e DKIM para o domínio. Terá de adicionar ambos os registos ao DNS do seu domínio para corrigir este problema.

Se estiver a ver a seguinte mensagem de erro SPF:

Significa que o seu domínio não tem o registo SPF necessário pelo Google para verificar o seu domínio. Para corrigir isto, terá de adicionar o registo SPF ao DNS do seu domínio. Para obter passos sobre como aceder a este registo, consulte o guia SPF do Google.

Provavelmente verá duas opções na página de documentação do SPF do Google: Definir o seu registo SPF — Básico e Definir o seu registo SPF — Avançado. Siga os passos na opção Básico para obter o seu registo SPF. Em seguida, prossiga para adicionar o registo ao DNS do seu domínio.

Se estiver a ver o seguinte aviso DKIM:

Terá de adicionar o registo DKIM exigido pelo Google para verificar que os e-mails vêm de domínios autorizados. Para obter passos sobre como obter este registo, consulte o guia DKIM do Google.

Poderá também ver a seguinte mensagem de erro após o envio de um e-mail de teste:

Este erro indica que adicionou múltiplos registos SPF ao DNS do seu domínio. Se adicionou anteriormente um registo SPF de outro remetente, provavelmente encontrará este erro. Para obter passos sobre como resolver este problema, consulte o nosso guia para saber como fundir todos os registos SPF no DNS do seu domínio.

É tudo! Agora sabe como configurar o remetente Google Workspace / Gmail do WP Mail SMTP no seu site WordPress.

Em seguida, gostaria de saber como resolver eficazmente problemas no WP Mail SMTP? Certifique-se de consultar o nosso tutorial sobre resolução de problemas do WP Mail SMTP para mais detalhes.