Configurar SMTP no Supabase
O Supabase Auth envia os e-mails de login do seu app — confirmação de cadastro, recuperação de senha, link mágico, convite —, mas o servidor de e-mail que vem com ele é só para testes: envia poucas mensagens por hora e só para os membros da equipe do projeto. Para o app funcionar com usuários de verdade, o Supabase pede um servidor SMTP próprio — aqui, o SMTP da iPORTO. A configuração está disponível em todos os planos do Supabase, inclusive no gratuito.
Antes de começar
Seção intitulada “Antes de começar”- Uma conta no SMTP da iPORTO. Se ainda não tem, veja os planos do SMTP — dá para testar por 7 dias, sem cartão.
- Um domínio cadastrado como Transacional — e-mail de login é transacional —, com os registros DNS publicados. Veja Adicionar um domínio de envio e Publicar os registros DNS do domínio.
- Uma credencial SMTP nesse domínio, como
[email protected]— veja Criar uma credencial SMTP. - Acesso de administrador ao projeto no painel do Supabase.
Passo a passo
Seção intitulada “Passo a passo”1. Ligar o SMTP próprio
Seção intitulada “1. Ligar o SMTP próprio”-
No painel do Supabase, abra o projeto e vá em Authentication. No menu lateral, no grupo Notifications, clique em Emails e abra a aba SMTP Settings.
-
Ligue Enable custom SMTP e preencha:
Campo O que preencher Onde achar Sender email address Um endereço do seu domínio, como [email protected]O domínio cadastrado no painel do SMTP Sender name O nome que o usuário vai ver, como Sua Empresa— Host smtp-avancado.com— Port number 587— Username A credencial completa, como [email protected]Painel do SMTP: Infraestrutura → Domínios (SMTP) → o domínio → aba Credenciais Password A senha da credencial No card da credencial, em Senha, pelo botão de copiar -
Clique em Save changes.
Depois de salvar, o Supabase não mostra mais a senha: o campo fica com pontos e o aviso Stored password is hidden. Ela continua guardada. Para trocá-la, digite a nova por cima e salve.
2. Ajustar o limite de envio
Seção intitulada “2. Ajustar o limite de envio”Com o SMTP próprio ligado, o Supabase limita os e-mails de login a 30 por hora no projeto inteiro. Para um app com usuários de verdade, isso costuma ser pouco:
- Vá em Authentication → Rate Limits.
- Aumente Rate limit for sending emails (em emails/h) para o volume que o seu app precisa — sem passar do que o seu plano no SMTP da iPORTO comporta.
- Clique em Save changes.
Na mesma tela, Minimum interval per user é o tempo mínimo entre dois e-mails para o mesmo usuário — 60 segundos, por padrão. Ele evita que um usuário receba vários e-mails seguidos ao clicar mais de uma vez em “reenviar”; deixe como está.
3. Testar o envio
Seção intitulada “3. Testar o envio”- Vá em Authentication → Users e clique em Add user → Send invitation.
- Na janela Invite a new user, digite uma caixa de e-mail sua em User email e clique em Invite user.
- O convite chega com o assunto You’ve been invited. Abra o painel do SMTP e confira o envio em Histórico de envio.
O que acontece depois
Seção intitulada “O que acontece depois”Todo e-mail de login do projeto passa a sair pelo SMTP da iPORTO e entra no Histórico de Envio do painel do SMTP, com o status da entrega. Os textos dos e-mails continuam sendo editados no Supabase, em Authentication → Emails, na aba Templates.
Confira para onde os links dos e-mails levam. O link de cada e-mail de login — Accept
invitation, confirmação de cadastro, troca de senha — volta para o endereço do seu app definido
em Authentication → URL Configuration, no campo Site URL. Num projeto novo, ele vem como
http://localhost:3000, que só funciona no computador de quem desenvolve. Troque pelo endereço
público do app e clique em Save changes.
Aceito pelo servidor não quer dizer entregue na caixa de entrada: o destino ainda pode recusar, adiar ou filtrar a mensagem — e é o histórico que mostra o que aconteceu.
Se der errado
Seção intitulada “Se der errado”| Sintoma | Causa provável | O que fazer |
|---|---|---|
Failed to invite user … Error sending invite email, e nada aparece no histórico |
A tela não diz o motivo. Em Logs → Explorer, na fonte auth_logs, o erro 535 "Incorrect authentication data" quer dizer usuário ou senha errados |
Use a credencial completa como Username. Copie a senha de novo pelo botão do painel, cole por cima dos pontos em Password e salve. Confira também se o Status da credencial está ativo |
| Os primeiros e-mails saem, e depois o Supabase recusa novos envios por limite | O limite de envio do projeto foi atingido | Aumente Rate limit for sending emails em Authentication → Rate Limits |
| Um segundo e-mail para o mesmo usuário, logo depois do primeiro, não sai | Minimum interval per user — por padrão, 60 segundos entre dois e-mails para o mesmo usuário | Espere o intervalo e tente de novo |
O e-mail chega, mas o link abre localhost:3000 ou uma página que não carrega |
O Site URL do projeto ainda é o padrão | Em Authentication → URL Configuration, troque o Site URL pelo endereço público do app |
| O e-mail sai com o remetente do Supabase, e não aparece no histórico | Enable custom SMTP está desligado, ou a configuração não foi salva | Ligue, confira os campos e clique em Save changes |
| O e-mail aparece no histórico como recusado ou devolvido | O destino recusou a mensagem depois de o servidor aceitá-la | Veja Entender por que um e-mail não foi entregue |
