A integração pode parecer simples até o botão funcionar, o formulário confirmar o envio e nenhuma mensagem chegar. Neste guia, você vai seguir uma ordem prática de diagnóstico para descobrir onde o fluxo está quebrando sem precisar entender programação tradicional.
1. Confirme se o problema está no envio ou na interface
Antes de mexer no DNS, teste a ação que dispara o e-mail e observe a resposta do backend. Uma tela mostrar “enviado” não prova que a API aceitou a mensagem. O ideal é que a função retorne sucesso somente depois de receber uma resposta válida do Resend e mostre um erro útil quando a chamada falhar.
Se você ainda está montando a integração, comece pelo tutorial completo Como configurar API de E-mail na Lovable com Resend. Este artigo é o satélite de troubleshooting para quando a configuração já existe, mas o envio falha.
2. Verifique a API key do Resend
- Confirme se a chave usada pelo projeto ainda está ativa no Resend.\nGaranta que a chave tem permissão de envio. O Resend permite criar chaves com acesso limitado somente a envio e até restringi-las a um domínio específico.\nNão coloque a chave diretamente no frontend. Mantenha o segredo no backend usado pelo projeto.\nSe você recriou ou rotacionou a chave no Resend, atualize também o segredo utilizado pela função de envio.
3. Confira o domínio e o endereço From
Em produção, o remetente precisa estar alinhado com um domínio configurado para envio no Resend. Abra Domains no painel do Resend e confirme o status dos registros. A experiência atual mostra o progresso de DKIM, SPF e outros registros individualmente, o que facilita localizar exatamente o registro que ainda não propagou ou está incorreto.
- Abra o domínio usado no remetente.\nConfira se a capacidade de sending está verificada.\nCompare o endereço From do projeto com o domínio autorizado.\nRevise os registros DNS marcados como pendentes ou inválidos.\nDepois da correção, aguarde a propagação e solicite nova verificação.
Um erro comum é verificar exemplo.com e depois tentar enviar com um remetente de outro domínio ou subdomínio que não está coberto pela configuração esperada. Outro problema recorrente é copiar um registro DNS com nome, valor ou proxy incorreto no provedor do domínio.
4. Use os logs do Resend para parar de adivinhar
O Resend oferece visibilidade das chamadas da API e dos eventos de e-mail. Se a mensagem foi aceita, procure o registro correspondente e veja o status. Se a chamada foi recusada, use a mensagem retornada como ponto de partida. Isso separa problemas de código, autenticação e domínio de problemas posteriores de entrega.
- Nenhum registro de envio aparece: a função provavelmente não chegou ao Resend ou falhou antes da chamada.\nA API retorna erro: corrija autenticação, parâmetros ou domínio conforme a mensagem.\nO e-mail aparece como enviado, mas não chega: investigue entrega, bounce, bloqueio, spam e reputação.\nO domínio aparece pendente: volte ao DNS antes de alterar a lógica do aplicativo.


