Resend (envio de e-mails)

Todo e-mail da plataforma sai pelo Resend. Isso inclui boas-vindas, redefinição de senha, envio em massa e os chamados abertos pelo widget de suporte.

Arquitetura

O envio acontece sempre no servidor. A chave de API nunca chega ao navegador.

O caminho de uma mensagem:

1. A aplicação monta o conteúdo, buscando o template personalizado da organização
2. Se não houver template personalizado, usa o padrão embutido no código
3. As variáveis ({{nome}}, {{reset_url}}) são substituídas
4. A mensagem é enviada pelo Resend
5. Um registro é gravado com o identificador devolvido pelo Resend
6. Conforme os eventos acontecem, o Resend chama de volta a aplicação e o registro é atualizado

O passo 5 é o que liga a mensagem ao rastreamento: sem o identificador guardado, não haveria como associar os eventos posteriores ao envio original.

Configuração

Variáveis de ambiente

Três variáveis controlam o envio, todas no servidor:

Variável	Função
RESEND_API_KEY	Chave de autenticação — nunca deve ir para o cliente
RESEND_FROM_NAME	Nome exibido como remetente
RESEND_FROM_EMAIL	Endereço remetente

O remetente é global da instalação, não configurável por organização pela interface. Alterá-lo exige mudança na configuração da aplicação e novo deploy.

Se RESEND_API_KEY não estiver definida, a aplicação sobe normalmente e registra um aviso no log — nenhum e-mail é enviado, silenciosamente do ponto de vista do usuário. É uma causa possível de “ninguém está recebendo nada” em ambiente recém-configurado.

Domínio e DNS

O domínio remetente precisa ser verificado no painel do Resend. Isso envolve publicar registros DNS:

• SPF — autoriza o Resend a enviar em nome do domínio
• DKIM — assina as mensagens criptograficamente
• DMARC — define a política para mensagens que falharem nas checagens acima

Sem SPF e DKIM válidos, as mensagens são entregues em spam ou recusadas. Provedores corporativos costumam ser mais rígidos que provedores pessoais, o que produz o sintoma clássico: o teste no Gmail chega, mas ninguém na empresa cliente recebe.

A propagação de DNS pode levar horas. Ao configurar um domínio novo, conte com isso antes de concluir que algo está errado.

Webhook de rastreamento

Para que os status avancem além de enviado, configure no painel do Resend um webhook apontando para:

https://<seu-dominio>/api/emails/webhook

Eventos que a aplicação processa:

Evento	Status registrado
email.sent	Enviado
email.delivered	Entregue
email.opened	Aberto
email.clicked	Clicado
email.bounced	Rejeitado (com a mensagem de erro)
email.complained	Reclamado

Sem o webhook configurado, todos os registros ficam parados em enviado para sempre. Se os logs de e-mail nunca mostram entrega nem abertura, este é o primeiro lugar a verificar.

Templates

Templates personalizados são guardados por organização e por tipo (boas-vindas, redefinição de senha). Quando não há personalização, vale o padrão do código — ou seja, o sistema funciona sem nenhuma configuração de template.

A substituição de variáveis tolera espaços: {{nome}} e {{ nome }} produzem o mesmo resultado. Variáveis não reconhecidas são entregues literalmente, sem gerar erro.

Detalhes de uso em templates do sistema.

Diagnóstico

Nada é enviado, nenhum registro aparece — chave de API ausente ou inválida. Verifique a variável de ambiente e o log do servidor.

Registros travados em “enviado” — webhook não configurado ou apontando para o endereço errado.

Alta taxa de rejeição — endereços inválidos na base. Frequentemente os endereços internos gerados pela sincronização Voors. Use o filtro de domínios corporativos no envio em massa.

Entregue em spam — DNS incompleto, ou reputação prejudicada por reclamações anteriores. Confira SPF, DKIM e DMARC no painel do Resend.

Chamados de suporte não chegam — o widget de suporte envia para um endereço fixo definido no código, não configurável pela interface. Se o destino precisa mudar, é alteração de código.

Limites

Contas Resend têm limite de envio por período conforme o plano. Em disparos grandes, vale conferir o limite vigente antes — um envio para milhares de destinatários pode ser parcialmente recusado ao atingir o teto, e a plataforma não faz enfileiramento automático nesse caso.