E-mail e notificações

O GCM manda muito e-mail — recibos de doação, PDFs de extrato, lembretes de presença, redefinições de senha, notificações de fluxo de trabalho, mensagens de boas-vindas para novos membros. Este artigo passa por como configurar quem parece estar enviando os e-mails, como eles são entregues e o que dizem.

A aba Configurações → E-mail carrega dois cartões: Identidade do remetente e Provedor de e-mail. Abaixo deles, o cartão Templates de e-mail deixa você sobrescrever qualquer template transacional por organização. Todos os três são apenas para admins.

Identidade do remetente

Cada e-mail enviado precisa de três coisas: um nome de remetente, um e-mail de remetente e um endereço de resposta.

Nome do remetente

O que os destinatários veem na caixa de entrada como nome "De" — geralmente o nome da marca da sua igreja. Mantenha abaixo de 30 caracteres ou alguns clientes truncam.

E-mail do remetente

O endereço de onde as mensagens vêm. Precisa estar em um domínio que você consiga verificar com o provedor que escolher (veja abaixo). Se você está no provedor Plataforma padrão, deixe em branco e a gente envia de um endereço de propriedade do GCM com o nome da sua igreja no rótulo De.

Endereço de resposta

Quando um destinatário clica em Responder na caixa de entrada, a resposta vai para cá em vez do endereço do remetente. Útil se o seu remetente é noreply@grace.org mas você quer que as respostas caiam em office@grace.org. Deixe em branco e as respostas voltam para o e-mail do remetente.

TIP

Defina Endereço de resposta para a caixa geral da igreja mesmo que duplique o remetente. As poucas pessoas que respondem a um endereço "noreply" muitas vezes são idosas ou pouco familiarizadas com tecnologia, e você não quer que a resposta caia em um buraco negro.

Provedor de e-mail

O dropdown de provedor tem três opções. Escolha uma — o provedor vale para a organização inteira, não dá para misturar.

Plataforma padrão

A infraestrutura de envio compartilhada que o GCM opera. Sem configuração, sem verificação de domínio. Melhor para organizações pequenas que não querem lidar com entregabilidade e não precisam de domínio próprio no De.

Limitações:

• Teto duro de 100 e-mails transacionais por dia no starter, 1.000 no growth, ilimitado no network+.
• O endereço De visível é um domínio do GCM; só o nome De é seu.
• Anúncios em massa (qualquer envio com mais de 50 destinatários) exigem um provedor não-plataforma.

Resend

Conecte sua própria conta Resend colando uma chave de API. O Resend cuida de entregabilidade, processamento de retorno e verificação por domínio. O fluxo:

1. Cadastre-se em resend.com, verifique seu domínio de envio (registros DNS que eles fornecem) e crie uma chave de API.
2. Cole a chave no campo Chave de API Resend. O ícone de olho alterna a visibilidade — a chave vem mascarada por padrão.
3. Salve. O próximo e-mail enviado usa o Resend.

A gente não valida a chave no salvamento (o Resend não tem endpoint de "test ping"), então teste enviando um e-mail real — por exemplo, dispare um boas-vindas para você mesmo.

SMTP

Para servidor próprio ou provedores sem API (Mailgun, SendGrid, Postmark, seu próprio Postfix). Campos:

Campo	Notas
Host SMTP	por exemplo smtp.sendgrid.net
Porta SMTP	587 para STARTTLS (padrão), 465 para TLS implícito, 25 sem criptografia (evite).
Usuário	O usuário SMTP do seu provedor — costuma ser apikey no SendGrid, seu e-mail completo nos estilo Gmail.
Senha	A senha SMTP. Mascarada por padrão; clique no olho para revelar.
Usar TLS / SSL	Ative para 587/465. Mantenha ativo a menos que esteja testando localmente.

As credenciais ficam guardadas criptografadas em app_settings sob as chaves smtp_*. A edge function que envia o e-mail (send-email) lê do lado do servidor — elas nunca aparecem no navegador depois de salvar.

WARNING

SMTP é mais lento que provedores com API (uma conexão por envio) e não escala para anúncios em massa. Se você manda mais que alguns milhares de e-mails por mês, use Resend ou um provedor com API.

Templates de e-mail

Role além do cartão de provedor até Templates de e-mail. Este cartão lista cada template transacional que o GCM envia — e-mails de boas-vindas, redefinições de senha, recibos de doação, notificações de extrato, login por magic link, notificações de fluxo de trabalho.

Cada linha mostra o nome do template, um selo de categoria e se sua organização sobrescreveu o padrão. Clique em uma linha para abrir o editor.

Editar um template

O editor tem:

• Assunto — a linha de assunto do e-mail. Aceita variáveis de merge.
• Corpo — o HTML do e-mail. O editor permite alternar entre os modos Prévia e Código.
• Toggle Ativado — desligue um template que você não quer enviar (por exemplo, desligar boas-vindas automáticas se você cuida disso manualmente).
• Sobrescrita do De — opcional. Se definido, este template envia de um endereço diferente do padrão da organização (útil para um "billing@" em recibos).
• Sobrescrita do Endereço de resposta — mesma ideia para respostas.

O painel à direita lista as variáveis de merge disponíveis para este template — por exemplo, {{member_name}}, {{donation_amount}}, {{statement_year}}. Clique em uma variável para copiar; cole no assunto ou corpo.

Clique em Restaurar para padrão para apagar a sobrescrita da sua organização e voltar ao template padrão da plataforma.

Segurança HTML

Os corpos dos templates são saneados com DOMPurify antes do envio. Você pode usar qualquer HTML que quiser, mas tags <script> e handlers onclick inline são removidos. Isso é para impedir que uma conta de admin comprometida envenene cada e-mail que sua organização envia.

Notificações (in-app e push)

E-mail não é o único canal de notificação. Configure os outros na aba Canais — é lá que ficam SMS, WhatsApp, push e roteamento in-app. A aba Lembretes (coberta em Lembretes) então escolhe quais canais usar especificamente para lembretes de eventos.

O que é salvo onde

Chave	Onde
messaging_sender_name, messaging_sender_email, email_reply_to	app_settings
email_provider	app_settings
resend_api_key	app_settings (criptografada em repouso)
smtp_host, smtp_port, smtp_user, smtp_pass, smtp_secure	app_settings (senha criptografada)
Sobrescritas de template	org_email_templates (uma linha por par organização-template)

Armadilhas comuns

"Meus e-mails vão para o spam." Com a Plataforma padrão, isso está em grande parte fora do seu controle. Com Resend ou SMTP, verifique seu domínio — SPF, DKIM, DMARC. A documentação do provedor te leva por cada um. Sem DKIM, quase todo e-mail cai no spam.

"Mudei o e-mail do remetente e agora nada envia." Seu novo domínio de remetente não está verificado com o provedor. Volte ao Resend (ou onde for) e adicione os registros DNS que eles listam. Até a verificação concluir, o provedor rejeita envios desse domínio.

"Os recibos saíram com o template antigo." Mudanças de template se aplicam apenas a envios futuros. Recibos já enviados ficam como estavam — a gente não re-renderiza PDFs históricos.

Próximos passos

• Canais — SMS, WhatsApp, push, in-app.
• Lembretes — escolha quais canais enviam lembretes de eventos.
• Fundamentos da organização — o e-mail da organização em Identidade é o Endereço de resposta de fallback.