Conectar o Mailgun
Envie os e-mails da loja por um domínio de envio do Mailgun, na região US ou EU, e receba no Vipter o status de entrega de cada mensagem.
Com o Mailgun conectado, a confirmação do pedido, o PIX aguardando pagamento e os outros e-mails da loja saem por um domínio de envio da sua conta Mailgun, com o seu nome. Antes de começar, vale ler como funciona o e-mail transacional.
Antes de começar
- Uma conta Mailgun com um domínio de envio adicionado e verificado, como
mg.seudominio.com.br. - A região da conta: US ou EU. Ela aparece no endereço do painel (
app.eu.mailgun.comnas contas da EU). - Papel Admin ou Dono no projeto do Vipter.
Passo 1: conferir o domínio de envio no Mailgun
- No Mailgun, abra a lista de domínios e confira se o domínio de envio está ativo (verificado).
- Se não estiver, crie no seu DNS os registros que o Mailgun mostra para ele (SPF, DKIM e os de rastreamento) e rode a verificação no Mailgun.
A verificação do Vipter só passa quando o Mailgun informa o domínio como ativo. Antes disso, a conexão é salva com o status Com erro. O que cada registro faz está em verificar o domínio de envio.
Passo 2: criar a API key
- No Mailgun, abra o menu do perfil, no canto superior direito, e escolha API Security.
- Clique em Add new key, dê uma descrição, como
Vipter, escolha o papel e crie a chave. - Copie a chave. O Mailgun mostra a chave uma única vez.
Use uma API key da conta. Uma Domain Sending Key só envia: ela não deixa o Vipter consultar o domínio, e a verificação falha.
Guarde a chave com cuidado
Com essa chave dá para enviar e-mails e mexer na sua conta Mailgun. Cole a chave só no Vipter. Se ela vazar, apague a chave no Mailgun, crie outra e cole no Vipter.
Passo 3: conectar no Vipter
- No painel do Vipter, abra GeralIntegraçõesE-mailMailgun.
- Em Remetente e credenciais, preencha os campos numerados:
| # | Campo | O que colar |
|---|---|---|
| 1 | Nome do remetente | O nome que o comprador vê na caixa de entrada, como o nome da loja. Em branco, vai o nome do projeto. |
| 2 | E-mail do remetente | Um endereço do domínio de envio (ou de um subdomínio dele), como contato@mg.seudominio.com.br. Com outro domínio, o card do domínio acusa que o remetente não é do domínio de envio. |
| 3 | Responder para | Para onde vão as respostas do comprador, como o seu e-mail de atendimento. Em branco, vai o e-mail de suporte do projeto. |
| 4 | API key | A API key do passo 2. Depois de salva, deixe em branco para manter a atual. |
| 5 | Domínio de envio | O domínio de envio exatamente como aparece no Mailgun, como mg.seudominio.com.br, sem https:// nem barra. |
| 6 | Região | Estados Unidos ou União Europeia, a região em que a conta Mailgun foi criada. |
| 7 | Enviar e-mails | Deixe ligado. Desligado, nenhum e-mail sai para os compradores. |
- Clique em Conectar. O Vipter consulta o domínio no Mailgun com a chave e a região informadas.
Passo 4: cadastrar o webhook de status de entrega
Pelo webhook, o Mailgun avisa o Vipter quando um e-mail é entregue, devolvido ou marcado como spam. Sem ele, o histórico fica só em Enviado e os endereços inválidos continuam recebendo.
- Depois de salvar, copie a URL do card Status de entrega (entregue, devolvido, spam), na coluna da direita.
- No Mailgun, abra SendSendingWebhooks e selecione o domínio de envio.
- Clique em Add webhook, cole a URL e marque os eventos Delivered, Permanent Failure, Temporary Failure e Complained.
- Clique em Create webhook.
Passo 5: testar
- No Vipter, em Enviar e-mail de teste, confira o endereço em Enviar para e clique em Enviar e-mail de teste.
- Abra a caixa de entrada desse endereço.
Deu certo se
Aparece a mensagem E-mail de teste enviado para voce@suaempresa.com.br., o status muda para Funcionando, o card do domínio mostra Domínio verificado no provedor e, alguns minutos depois, o card do webhook mostra Último aviso recebido em ….
Problemas comuns
-
A verificação falha com
401e a dica "check the region: US or EU"A chave está errada ou a Região não é a da conta. Confira a região e cole a chave de novo.
-
Mailgun: domain state is "unverified"
O domínio de envio ainda não foi verificado no Mailgun. Termine o passo 1 e salve de novo.
-
o remetente não é do domínio de envio configurado
O E-mail do remetente não é do Domínio de envio. Use um endereço do próprio domínio de envio, como
contato@mg.seudominio.com.br. -
Informe um domínio válido (ex.: smtp.seudominio.com.br).
O Domínio de envio tem
https://, barra ou espaço. Informe só o domínio.
O que fazer a seguir
- Verifique o domínio de envio e adicione um registro DMARC.
- Revise quais e-mails saem e os textos de cada um em GeralConfiguraçõesE-mails.