Portfólio Resend Compartilhado
Implemente e-mail para múltiplos produtos através de uma única conta Resend e domínio verificado. Otimizado para desenvolvedores solo ou portfólios pequenos que utilizam o plano gratuito sem fazer com que cada aplicativo pareça o mesmo produto.
Modelo principal
Compartilhe infraestrutura, não identidade do produto:
Uma conta Resend
└── Domínio de remetente verificado existente
├── Identidade do remetente do Produto A
├── Identidade do remetente do Produto B
└── Identidade do remetente do Produto C
Cada aplicativo mantém seus próprios:
- nome de exibição do remetente
- caixa de entrada de destino
- roteamento de Reply-To
- convenções de assunto
- templates HTML e texto simples com marca própria
- variáveis de ambiente de implantação
- logs de entrega e comportamento de falha
Todos os aplicativos compartilham a cota do plano gratuito e a reputação do domínio verificado ao nível da conta.
Descoberta do portfólio
Antes da implementação:
- Inspecione o aplicativo alvo e qualquer aplicativo irmão com uma configuração Resend funcional.
- Identifique a conta Resend canônica e o domínio já verificado.
- Confirme o nome de exibição do produto, caixa de correio do remetente compartilhada, destinatário interno, caixa de entrada de suporte Reply-To e tipos de e-mail esperados.
- Confirme se a implantação alvo já possui uma chave da API Resend.
- Não peça ao usuário para criar outra conta, verificar outro domínio ou comprar um plano, a menos que a conta existente não possa atender a um requisito declarado.
Estratégia de conta e chave
Reutilize a mesma conta Resend e domínio verificado. Prefira uma chave da API separada por aplicativo implantado, quando a conta permitir; isso limita o impacto de uma chave vazada ou rotacionada, permanecendo em uma única conta e cota. Reutilize a mesma chave apenas quando chaves separadas não estiverem disponíveis ou o usuário preferir explicitamente essa compensação.
Nunca copie segredos de outro repositório para o controle de versão. Adicione a chave selecionada diretamente ao ambiente de segredos de cada implantação.
Configuração por produto
Use variáveis exclusivas do servidor e nomes específicos do produto sempre que possível. Resolva seus valores a partir da conta Resend existente do usuário, da configuração de remetente verificada e da caixa de entrada pretendida do produto — nunca copie identidades de exemplo em uma implementação.
| Função da variável | Propósito |
|---|---|
| Chave da API Resend | Autentica a chamada do provedor no lado do servidor |
| Identidade do remetente do produto | Combina o nome de exibição do produto atual com um endereço no domínio verificado existente |
| Destinatário de contato do produto | Recebe as notificações internas deste produto |
| Endereço de resposta do produto | Recebe respostas para mensagens voltadas ao usuário, quando diferente do destinatário de contato |
O nome de exibição visível fornece a identidade do produto; o endereço verificado existente fornece entregabilidade. Nunca use uma variável NEXT_PUBLIC_ ou equivalente exposta ao cliente para uma chave da API.
Roteamento de formulário de contato
Envie duas mensagens separadas:
Notificação interna
De: identidade do remetente do produto configurada
Para: caixa de entrada interna do produto configurada
Reply-To: endereço validado enviado pelo visitante
Confirmação para o visitante
De: identidade do remetente do produto configurada
Para: endereço validado enviado pelo visitante
Reply-To: caixa de entrada interna do produto configurada
Não coloque o visitante e a caixa de entrada interna em uma única lista de destinatários. Mensagens separadas evitam exposição de endereços e permitem conteúdo diferente.
Trate a notificação interna como entrega primária. Retorne sucesso do formulário apenas após o Resend aceitá-la e retornar um ID de mensagem. Tente a confirmação do visitante em seguida; registre sua falha sem afirmar que a consulta primária foi perdida.
Isolamento de marca
Crie um shell de template distinto para cada produto, mantendo o padrão do módulo do provedor reutilizável. Personalize:
- nome e descritor do produto
- cores, tipografia e tratamento do cabeçalho
- texto de pré-visualização do e-mail
- assuntos e tom
- rodapé de propriedade, endereço de suporte e expectativas de resposta
Use layouts de tabela, CSS inline, largura de conteúdo de 600–640px, valores de usuário escapados e uma versão em texto simples. Não reutilize a identidade visual de outro produto apenas porque a infraestrutura de remetente é compartilhada.
Salvaguardas de plano gratuito compartilhado
- Verifique os limites atuais do plano gratuito do Resend em vez de confiar em números memorizados.
- Lembre-se de que cada aplicativo consome a mesma cota da conta.
- Envie apenas mensagens transacionais necessárias; evite notificações duplicadas.
- Mantenha controles anti-spam em formulários públicos: validação, limites de comprimento, honeypot e limitação de taxa quando apropriado.
- Evite loops de repetição que possam enviar duplicatas. Persista ou use idempotência onde o fluxo de trabalho tem risco significativo de repetição.
- Monitore rejeições do provedor e erros de cota sem registrar segredos ou dados pessoais desnecessários.
- Escalone para outra conta ou plano pago apenas quando volume medido, isolamento, conformidade ou requisitos de reputação justificarem.
Implementação confiável
- Instale o pacote oficial
resendno workspace correto. - Mantenha chamadas ao provedor em um módulo exclusivo do servidor.
- Valide
result.data?.ide garanta queresult.erroresteja ausente. - Capture exceções do SDK e de rede.
- Defina
replyToexplicitamente. - Retorne
503quando o e-mail não estiver configurado e502quando a entrega primária falhar. - Preserve alternativas de contato direto (e-mail, telefone ou mensagens) na interface do usuário.
- Nunca relate tratamento apenas em log como entrega bem-sucedida.
Verificação
- Confirme que o domínio compartilhado está verificado na conta Resend reutilizada.
- Confirme os valores de From, To e Reply-To específicos do produto.
- Teste a entrega interna, depois a confirmação do visitante e depois responda em ambas as direções.
- Teste validação, honeypot, chave ausente, rejeição do provedor e caminhos de fallback.
- Execute comandos nativos do repositório de typecheck, lint, teste e build.
- Confirme que a implantação contém sua chave da API e variáveis do produto.
- Realize uma submissão real antes de afirmar que a entrega ao vivo funciona.