Resumo de IA
Observação: Este guia se aplica ao remetente Mailgun no WP Mail SMTP.
O que este erro significa
O Mailgun rejeitou a solicitação da API porque a chave de API é inválida ou porque a solicitação está atingindo o endpoint regional incorreto (EUA ou UE).
Causas Comuns
- A Região no WP Mail SMTP não corresponde à região do domínio de envio no Mailgun (EUA ou UE)
- Chave de API inválida ou excluída
- Usando uma chave com permissões insuficientes (por exemplo, uma conta tem vários tipos de chave de API e a incorreta foi copiada)
- A chave de API foi regenerada no Mailgun, mas não atualizada no WP Mail SMTP
Como Corrigir
Aqui está o guia completo passo a passo para resolver o erro.
Etapa 1: Verifique a Configuração da Região
Uma configuração de região incorreta causa um 401 mesmo com uma chave de API válida, porque o WP Mail SMTP está atingindo o endpoint incorreto do Mailgun. Esta é a coisa mais rápida para verificar.
Comece fazendo login no Mailgun. Em seguida, no menu esquerdo, clique em Enviar para expandir o menu e selecione Domínios na seção Envio.
Em seguida, verifique o seletor de região no canto superior direito da barra de cabeçalho. Ele mostra EUA ou UE com um ícone de bandeira. Anote qual região está selecionada.
Depois disso, retorne à sua área de administração do WordPress e vá para WP Mail SMTP » Configurações. Role até a seção Mailgun e verifique o menu suspenso Região. Ele deve corresponder à região mostrada no Mailgun. Se não corresponder, selecione a região correta e clique em Salvar Configurações.
Para testar a correção, vá para WP Mail SMTP » Ferramentas, clique na guia Teste de E-mail, insira um e-mail de destinatário no campo Enviar Para, deixe o alternador HTML ativado e clique em Enviar E-mail.
Finalmente, procure a mensagem de sucesso e verifique sua caixa de entrada para confirmar que o e-mail chegou. Se o erro desapareceu, você terminou. Se persistir, continue para a Etapa 2.
Etapa 2: Gere uma Nova Chave de API
Se a região estiver correta, a própria chave de API pode ser inválida, excluída ou do tipo errado. O Mailgun exibe as chaves de API apenas uma vez na criação, portanto, você não pode copiar novamente uma existente. Gere uma nova.
Comece clicando no círculo do seu perfil com suas iniciais no canto superior direito do Mailgun.
Em seguida, clique em Segurança da API no menu suspenso.
Em Chaves de API do Mailgun, clique em Criar chave.
Em seguida, insira uma descrição (por exemplo, "WP Mail SMTP") e clique em Criar Chave.
Em seguida, copie a chave de API imediatamente.
Observação: O Mailgun exibe a chave completa apenas uma vez. Após fechar esta janela, você não poderá recuperá-la. Armazene-a em um local seguro antes de fechar.
Depois disso, retorne à sua área de administração do WordPress, vá para WP Mail SMTP » Configurações e role até a seção Mailgun.
Cole a nova chave no campo Chave de API do Mailgun.
Finalmente, verifique se a Região ainda corresponde à região do seu domínio e clique em Salvar Configurações. Em seguida, envie outro e-mail de teste de WP Mail SMTP » Ferramentas » Teste de E-mail para confirmar a correção.
Observações
- As chaves de API do Mailgun são globais. A mesma chave funciona em ambas as regiões. No entanto, a configuração Região no WP Mail SMTP controla qual endpoint o WP Mail SMTP usa: domínios dos EUA usam
api.mailgun.nete domínios da UE usamapi.eu.mailgun.net. Uma configuração de região incorreta causa um 401 mesmo com uma chave válida. - O Mailgun tem três tipos de chave de API na página de Segurança de API: Chave pública de verificação, Assinatura de webhook HTTP e Chave de API do Mailgun. Use a chave da seção Chaves de API do Mailgun.
- Contas mais antigas do Mailgun podem ter chaves de API que incluem o prefixo
key-. Se sua chave começar comkey-, inclua o prefixo ao colá-la no WP Mail SMTP.
É isso! Agora você sabe como corrigir o erro '401 Unauthorized or Forbidden' no Mailgun e fazer seus e-mails serem enviados novamente através do WP Mail SMTP.