Google Workspace / Gmail

Gostaria de usar sua conta do Gmail ou do Google Workspace (antigo G Suite) para corrigir problemas de entrega de e-mail em seu site? A opção Google Workspace / Gmail do WP Mail SMTP usa a API do Google para autenticar com segurança os e-mails do seu site, ajudando-os a chegar com êxito às caixas de entrada dos usuários.

Este tutorial mostrará como configurar o WP Mail SMTP usando o Google Workspace / Gmail mailer com seu endereço de e-mail do Gmail ou do Google Workspace.

---

Instalação e configuração do plug-in SMTP do WP Mail

Antes de começar, você precisará instalar e ativar o plug-in WP Mail SMTP.

Depois de verificar sua licença, você estará pronto para definir as configurações do plug-in. Você pode encontrá-las acessando WP Mail SMTP " Settings e procurando na guia General (Geral ).

A seguir, abordaremos as configurações necessárias para essa configuração.

De e-mail

Esse é o endereço de e-mail a partir do qual todos os e-mails do seu site serão enviados. Você pode digitar seu endereço de e-mail no campo fornecido, inclusive quaisquer aliases que tenha configurado, depois de conectar seu site à API do Gmail nas etapas posteriores.

A opção Force From Email fará com que todos os e-mails enviados do seu site venham do endereço que você inseriu.

Do nome

Abaixo de From Email, você pode definir o From Name. Esse é o nome associado aos e-mails que seu site envia. Por padrão, ele será definido como o nome do seu site, mas você pode ajustá-lo para o que quiser.

Você também pode marcar a opção Forçar do nome para aplicar essa configuração em todo o site.

Correio eletrônico

É aqui que você pode escolher qual mailer gostaria que seu site usasse. Selecione a opção Google / Gmail.

Depois de escolher esse mailer, você verá uma nova seção intitulada Google / Gmail com mais opções de autorização.

Há duas maneiras de configurar o Google Workspace / Gmail mailer: Usando o One-Click Setup ou criando manualmente um aplicativo personalizado do Google para gerar seu Client ID e Client Secret.

Se estiver decidindo entre a configuração com um clique e a configuração manual, aqui está uma comparação rápida:

	Configuração manual	Configuração com um clique (Pro)
Facilidade de uso	Guia passo a passo para ajudá-lo	Conexão instantânea com o mínimo de etapas
Etapas técnicas	Requer a criação de um aplicativo do Google e a configuração de credenciais	Não há necessidade de configuração manual
Tempo necessário	Aproximadamente 30 a 60 minutos	Menos de 2 minutos
Suporte	Acesso a uma ampla documentação	Suporte prioritário da nossa equipe
Ideal para	Usuários que preferem um processo detalhado de configuração e aprendizado	Usuários que buscam a configuração mais rápida e fácil

Procurando a maneira mais rápida de começar? O One-Click Setup simplifica o processo para que você possa começar a enviar e-mails imediatamente.

👉 Faça upgrade para o Pro e habilite a configuração com um clique

No entanto, se preferir configurar as coisas manualmente, vá para a seção Criando um aplicativo Web deste guia para continuar.

Ativação da configuração em um clique

Para uma configuração de e-mail mais fácil e rápida, recomendamos o uso do recurso One-Click Setup. Ele permite que você conecte seu site ao Gmail/Google Workspace com apenas alguns cliques.

Depois de selecionar o Google/Gmail como seu servidor de e-mail nas configurações de SMTP do WP Mail, você encontrará a opção de ativar a configuração com um clique. Basta alternar essa opção para a posição ON para iniciar o processo de configuração simplificado.

Para obter informações mais detalhadas sobre o processo de configuração com um clique, consulte nosso guia sobre a configuração com um clique do Google Workspace / Gmail Mailer.

Como criar um aplicativo da Web em sua conta do Google

Você voltará à página de configurações do WP Mail SMTP um pouco mais tarde, portanto, para esta etapa, abra uma nova guia ou janela no navegador.

Na nova guia ou janela que você abriu, faça login na sua conta do Google e abra o Google Cloud Console.

Se for a primeira vez que você usa o Google Cloud Console, talvez apareça uma janela pop-up solicitando que você selecione seu país e concorde com os Termos de Serviço. Vá em frente e faça isso, depois clique em CONCORDAR E CONTINUAR para passar para a próxima etapa.

Se você já fez login no Google Cloud Console antes, provavelmente ignorará os Termos de Serviço.

Criação ou escolha de um projeto

Primeiro, você precisará escolher um projeto para usar em seu aplicativo. Você pode selecionar um projeto existente ou criar um novo.

Para fazer isso, clique no menu suspenso de projetos na barra de ferramentas na parte superior do painel.

Na janela pop-up que aparece, selecione um projeto existente na lista ou clique em New Project (Novo projeto ) no canto superior direito.

Se você selecionou um projeto existente, passe para a próxima etapa. Para um novo projeto, insira um nome de projeto e selecione uma organização e um local nos menus suspensos.

Em seguida, clique no botão CREATE (Criar ).

Ativação da API do Gmail

Em seguida, você precisa ativar a API do Gmail para o seu projeto. Na barra lateral do Google Cloud Console, vá para APIs e serviços " Biblioteca.

Em seguida, procure em Category (Categoria ) e clique em Google Workspace, ou digite "Gmail API" na barra de pesquisa.

Clique no resultado da API do Gmail.

Na página da API do Gmail, clique no botão azul ENABLE (Ativar ).

Criando as credenciais do seu aplicativo

Depois de ativar a API do Gmail, você deverá ser redirecionado para a página Visão geral da API do Gmail. Aqui, clique no botão CREATE CREDENTIALS (Criar credenciais ).

Na próxima página, o Google fará algumas perguntas para determinar o tipo de credencial de que você precisa. No menu suspenso Select an API (Selecionar uma API ), escolha Gmail API.

Em seguida, em What data will you be accessing? (Quais dados você acessará?), selecione a opção User data (Dados do usuário ). Em seguida, clique no botão NEXT para continuar.

Configuração da tela de consentimento do OAuth

Em seguida, o Google solicitará algumas informações básicas sobre seu aplicativo.

Esta seção é principalmente para uso pessoal, pois ninguém mais usará seu aplicativo. No entanto, alguns campos ainda estão marcados como obrigatórios:

• Nome do aplicativo: digite um nome de aplicativo de sua escolha (por exemplo, Pattie's App).
• E-mail de suporte ao usuário: Selecione seu endereço de e-mail entre as opções fornecidas.
• Logotipo do aplicativo: Se desejar, você pode carregar um logotipo para o seu aplicativo. Isso é opcional.

Por fim, adicione seu endereço de e-mail no campo Email addresses (Endereços de e-mail ). Em seguida, clique no botão SAVE AND CONTINUE (Salvar e continuar) para prosseguir para a próxima etapa.

Configuração de escopos (opcional)

Esta é uma etapa opcional que ignoraremos neste tutorial. Role para baixo até o final da seção Scopes e clique no botão SAVE AND CONTINUE (Salvar e continuar ) para prosseguir.

Configuração de seu ID de cliente OAuth

Em seguida, você precisará preencher algumas informações sobre seu ID de cliente OAuth.

No menu suspenso Tipo de aplicativo, selecione a opção Aplicativo da Web. Quando você fizer isso, mais campos serão preenchidos automaticamente.

Você pode deixar o campo Name como o valor padrão ou alterá-lo para algo mais relevante. Para este exemplo, manteremos o nome padrão, Cliente Web 1.

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

Clique no botão + ADD URI e insira o seguinte: https://connect.wpmailsmtp.com/google/. Você também pode copiar esse valor das configurações de SMTP do WP Mail e colá-lo aqui, se preferir.

Em seguida, clique no botão CREATE para concluir essa etapa.

Depois que o aplicativo for criado, a seção Your Credentials (Suas credenciais ) será expandida para mostrar o ID do cliente. Não há necessidade de copiá-lo agora, pois você o acessará de outra área em uma etapa posterior.

Em vez disso, clique no botão DONE (Concluído ) na parte inferior da página.

Atualização do status de publicação de teste para produção

O Google colocará seu aplicativo no modo interno por padrão. É muito importante que você mude para o modo Externo e o publique. Caso contrário, seu aplicativo será muito limitado e não funcionará corretamente.

Na barra lateral do Google Cloud Console, vá para APIs e serviços " Tela de consentimento do OAuth.

Em seguida, selecione a guia Audience (Público ).

A tela exata que você verá a seguir varia dependendo de você estar usando uma conta gratuita do Gmail ou uma conta do Google Workspace.

Usuários do Google Workspace

Em User type (Tipo de usuário), clique no botão MAKE EXTERNAL (Tornar externo ).

Na janela pop-up que aparece, selecione a opção Em produção. Em seguida, clique em CONFIRMAR.

Usuários do Gmail

Se você não estiver usando o Google Workspace, não verá a opção MAKE EXTERNAL. Em vez disso, você precisará publicar seu aplicativo do Google.

Em Status de publicação, você verá que o status do aplicativo está definido como Testing (Teste). Vá em frente e clique no botão PUBLISH APP (Publicar aplicativo ) para atualizar o status do aplicativo.

Na sobreposição que aparece, clique em CONFIRMAR para publicar seu aplicativo.

Quando a confirmação for concluída, você verá que o status de publicação do seu aplicativo agora é Em produção.

Concessão de permissões do Google / Gmail ao seu site

Em seguida, navegue até APIs & Services " Credentials no menu do lado esquerdo.

Uma vez lá, procure na seção IDs de cliente OAuth 2.0. Você verá os detalhes do aplicativo Web que acabou de criar. Para visualizar o Client ID e o Client Secret, clique no ícone de lápis.

Isso abrirá todos os detalhes de seu aplicativo. No lado direito dessa página, você verá os valores de Client ID e Client secret.

Vá em frente e copie esses dois valores para os campos correspondentes nas configurações de SMTP do WP Mail.

Depois de adicionar esses valores, clique no botão Save Settings (Salvar configurações) na parte inferior da página.

Depois de salvar suas configurações, a página será atualizada. Você deve conceder permissão para que o Google permita que nosso plug-in use a API do Gmail para enviar e-mails.

Para fazer isso, role até a parte inferior da página de configurações do WP Mail SMTP e clique no botão Permitir que o plug-in envie e-mails usando sua conta do Google.

Isso abrirá uma tela de login do Google. Faça login na conta com a qual você está configurando o SMTP.

Em seguida, você verá uma tela solicitando permissão para que esse site envie e-mails em seu nome.

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

Como contornar o aviso de verificação do Google (somente para usuários do Gmail gratuito)

Você poderá ver a tela a seguir se estiver se conectando com uma conta gratuita do Gmail. Vá em frente e clique no link Advanced (Avançado ) no canto inferior esquerdo.

Na seção expandida, clique em Go to wpmailsmtp.com (unsafe). Não se preocupe, o Google só exibe esse aviso porque não verificou seu aplicativo. Não há necessidade de verificá-lo, pois você criou esse aplicativo apenas para seu próprio uso.

Em seguida, clique no botão Allow, conforme mostrado acima.

Conexão de backup

A configuração de uma conexão de backup é opcional e não é necessária para concluir a configuração do Google Workspace / Gmail mailer. No entanto, para melhorar ainda mais a capacidade de entrega de e-mails, recomendamos a configuração de uma conexão adicional para servir como backup, caso a conexão principal falhe.

Envio de um e-mail de teste

Em seguida, você retornará às configurações de SMTP do WP Mail e uma mensagem de sucesso será exibida. Quando a conexão for concluída, você estará pronto para enviar um e-mail de teste. Para fazer isso, navegue até WP Mail SMTP " Tools e abra a guia Email Test.

Quando a guia Teste de e-mail estiver aberta, será necessário inserir um endereço de e-mail cuja caixa de entrada você tenha acesso.

Em seguida, escolha se deseja enviar um e-mail de texto simples ou HTML. A menos que você saiba que só enviará e-mails de texto sem formatação, recomendamos deixar a configuração HTML ativada. Em seguida, clique no botão Send Email (Enviar e-mail).

Você verá uma mensagem de sucesso quando o e-mail de teste for enviado.

Em breve, você também deverá receber o e-mail de teste no endereço de e-mail informado.

Perguntas frequentes

Essas são algumas das principais perguntas que recebemos sobre a configuração do Google Workspace / Gmail mailer.

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

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

401. That’s an error.
Error: invalid_client

Esse erro aparece quando a ID do cliente não pode ser lida corretamente. Para corrigi-lo, tente copiar e colar sua ID de cliente novamente e verifique se não há espaços em branco ou texto extra.

400. That’s an error.
Error: invalid_request
Missing required parameter: client_id

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

cURL error 60: SSL certificate problem

Essa mensagem significa que o servidor está sem um certificado necessário para o funcionamento do SMTP. Para corrigir isso, será necessário entrar em contato com o provedor de hospedagem do seu site para solicitar a instalação desse certificado (provavelmente o certificado cacert.pem, embora seja melhor pedir ao seu host para verificar).

“code”: 401,
“message”: “Login Required”

Se você vir isso na mensagem de depuração, ainda precisará conceder permissão ao WP Mail SMTP para acessar sua conta do Google. Para obter instruções sobre como corrigir isso, consulte a Etapa 4 deste tutorial. Além disso, certifique-se de verificar se o e-mail de origem nas configurações de SMTP corresponde ao e-mail usado para configurar seu aplicativo do Google.

Request Entity Too Large
Error 413

Se estiver vendo esse erro, é provável que os arquivos enviados por meio de seus formulários excedam o limite do Gmail para anexos diretos de arquivos em e-mails. Esse limite é aplicado à soma do texto da mensagem e do anexo codificado. Para evitar esse erro, você precisará certificar-se de que todos os arquivos não sejam maiores que 22 MB.

There was a problem while retrieving Auth for gmail: Could not json decode the token

Esse erro é um possível indicador de que outro plug-in (como o UpdraftPlus) está carregando uma versão diferente da API do Google no site, criando um conflito. Se possível, o plug-in conflitante deve ser desativado. Caso contrário, é recomendável que você configure outro serviço de e-mail.

Se nenhuma das opções acima se aplicar, ou se o e-mail de teste ainda não estiver funcionando, sua conta do Google pode estar com a API do Gmail desativada. Para verificar isso, siga o guia do Google para ativar uma API.

E se eu vir uma tela que diz: "Este aplicativo não foi verificado"?

Quando você clica no botão Permitir que o plug-in envie e-mails usando sua conta do Google nas configurações de SMTP do WP Mail, o Google pode exibir uma tela que diz: "Este aplicativo não foi verificado. Este aplicativo ainda não foi verificado pelo Google. Prossiga somente se você conhecer e confiar no desenvolvedor".

No entanto, não há motivo para preocupação. Essa mensagem se refere apenas ao aplicativo que você criou em sua própria conta do Google, portanto, nesse caso, você é o desenvolvedor.

Para ignorar essa mensagem, clique em Advanced e, em seguida, clique em Go to wpmailsmtp.com (unsafe).

E se eu quiser mudar para um e-mail diferente mais tarde?

Se quiser mudar para um endereço de e-mail diferente do Gmail ou do Google Workspace, você precisará repetir todas as etapas do tutorial acima. Isso inclui a geração de um novo Client ID e Client Secret nessa outra conta de e-mail.

Quando chegar à etapa de autorização(Etapa 4), salve suas configurações e clique no botão Remove Connection (Remover conexão ). Isso removerá a autorização da sua conta de e-mail original e permitirá que você repita as etapas de autorização com seu novo e-mail.

O Google Workspace / Gmail mailer suporta aliases?

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

Posso usar o Google Workspace / Gmail mailer se tiver a autenticação de dois fatores (2FA) ativada em minha conta do Google?

Definitivamente, você pode usar a autenticação de dois fatores com a opção Google Workspace/Gmail do WP Mail SMTP. No entanto, é importante observar que, se você optar por desativar a 2FA ou alterar a senha da sua conta, será necessário passar pelo processo de configuração novamente.

Ao autorizar meu aplicativo, recebo a seguinte mensagem de erro:

Error 403: access_denied. The developer hasn’t given you access to this app.

Essa mensagem significa que as permissões do seu aplicativo estão definidas para o modo de teste no Google Cloud.

Para corrigir isso, certifique-se de mudar o modo de teste para produção e tente autorizar seu aplicativo mais uma vez.

Se eu alterar minha senha, precisarei me reconectar?

Sim, se sua senha for alterada, a conexão existente será invalidada. Para corrigir isso, você precisará criar uma nova conexão, usando suas novas credenciais.

Preciso enviar meu aplicativo ao Google para verificação para que ele funcione com o WP Mail SMTP?

Não é necessário que você envie seu aplicativo para verificação. No entanto, você pode fazer isso se quiser. Se optar por enviar seu aplicativo para verificação, você poderá continuar o processo de autorização no WP Mail SMTP sem esperar pela verificação do Google.

Por que o URI de redirecionamento está apontando para connect.wpmailsmtp.com?

Definimos o URI de redirecionamento para passar pelo nosso site para que possamos resolver o erro 403 proibido que alguns usuários apresentam quando mod_security os impede de concluir a conexão OAuth.

Como faço para alterar o URI de redirecionamento para que ele aponte para meu próprio site?

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

Para fazer isso, primeiro você precisará adicionar o seguinte trecho de código ao seu site do WordPress.

Em seguida, vá para as configurações do seu servidor de e-mail em WP Mail SMTP " Configurações " Geral e copie o novo URL da seção URI de redirecionamento autorizado.

Por fim, acesse as configurações de ID do cliente OAuth do seu aplicativo do Google e substitua o URI de redirecionamento existente pelo que você acabou de copiar. Isso garante que as solicitações de autorização agora serão direcionadas para seu próprio site.

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

Invalid source: URIs must not contain a path or destination with “/”

Esse erro ocorre quando você adiciona o URI de redirecionamento à seção Origens autorizadas de JavaScript em vez da seção URIs de redirecionamento autorizados.

Para resolver esse problema, remova o URI que você adicionou da seção Origens autorizadas de JavaScript e adicione-o à seção URIs de redirecionamento autorizados. Consulte a seção ID do cliente para obter mais detalhes.

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

Esse erro geralmente significa que há uma incompatibilidade no URI de redirecionamento autorizado em seu Console do Google Cloud. Ele deve ser definido como https://connect.wpmailsmtp.com/google/. Além disso, certifique-se de que, para seu aplicativo do Google, você tenha atualizou o status de publicação de Testing (Teste) para Production (Produção).

Para obter mais orientações sobre como corrigir esse erro, consulte a documentação do SendLayer sobre como resolver o erro Redirect URI Mismatch.

O SMTP do WP Mail para de funcionar periodicamente e recebo a seguinte mensagem de erro:

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

Esse erro geralmente indica que há problemas de permissão devido à invalidação da chave do segredo do cliente. Isso pode acontecer quando você altera a senha do Gmail ou ativa a 2FA na sua conta.

Para resolver isso, você precisará regenerar seus tokens ou passar pelo processo de configuração novamente.

Para gerar novamente seus tokens, faça login no Console do Google Cloud e selecione Credenciais na seção API & Services.

Na seção OAuth 2.0 Client IDs, você precisará clicar no ícone de lápis para editar suas credenciais.

Em seguida, clique em RESET SECRET para gerar uma nova chave Client Secret.

Será exibida uma janela pop-up com uma mensagem de confirmação. Clique em RESET para continuar.

Após redefinir seus tokens, você precisará atualizar o Client Secret nas configurações de SMTP do WP Mail com a nova chave. Vá em frente e copie a chave do segredo do cliente.

Em seguida, faça login no painel do WordPress e acesse WP Mail SMTP " Settings.

Na guia General ( Geral ), role para baixo até a seção Google/Gmail e cole a chave que você copiou no campo Client Secret (Segredo do cliente ).

Depois de adicionar o novo Client Secret, não se esqueça de salvar as alterações.

Depois de enviar um e-mail de teste, vejo a seguinte mensagem de erro:

The test email might have been sent, but its deliverability should be improved.

Esse erro geralmente ocorre se você estiver usando um endereço de e-mail de domínio personalizado e não tiver adicionado registros SPF e DKIM para o domínio. Será necessário adicionar ambos os registros ao DNS do seu domínio para corrigir esse problema.

Se você estiver vendo a seguinte mensagem de erro SPF:

Isso significa que seu domínio não tem o registro SPF exigido pelo Google para verificar seu domínio. Para corrigir isso, você precisará adicionar o registro SPF ao DNS do seu domínio. Para obter etapas sobre como acessar esse registro, consulte o guia SPF do Google.

Você provavelmente verá duas opções na página de documentação do SPF do Google: Definir seu registro SPF - Básico e Definir seu registro SPF - Avançado. Siga as etapas da opção Básica para obter seu registro SPF. Em seguida, adicione o registro ao DNS do seu domínio.

Se você estiver vendo o seguinte aviso DKIM:

Você precisará adicionar o registro DKIM exigido pelo Google para verificar se os e-mails são provenientes de domínios autorizados. Para obter etapas sobre como obter esse registro, consulte o guia DKIM do Google.

Você também pode ver a seguinte mensagem de erro após enviar um e-mail de teste:

Esse erro indica que você adicionou vários registros SPF ao DNS do seu domínio. Se você tiver adicionado anteriormente um registro SPF de um remetente diferente, provavelmente encontrará esse erro. Para obter etapas sobre como resolver esse problema, consulte nosso guia para saber como mesclar todos os registros SPF no DNS do seu domínio.

É isso aí! Agora você sabe como configurar o Google Workspace / Gmail mailer do WP Mail SMTP em seu site WordPress.

Em seguida, você gostaria de saber como solucionar problemas de forma eficaz no WP Mail SMTP? Não deixe de conferir nosso tutorial sobre solução de problemas do WP Mail SMTP para obter mais detalhes.