Pular para o conteúdo

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.

  1. 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.

  2. 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
  3. 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.

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:

  1. Vá em Authentication → Rate Limits.
  2. 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.
  3. 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á.

  1. Vá em Authentication → Users e clique em Add user → Send invitation.
  2. Na janela Invite a new user, digite uma caixa de e-mail sua em User email e clique em Invite user.
  3. O convite chega com o assunto You’ve been invited. Abra o painel do SMTP e confira o envio em Histórico de envio.

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.

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