# Envio pela sua conta Resend

> No plano Business ou superior, os e-mails da comunidade saem pela conta Resend da própria comunidade, com o domínio e a reputação dela. Que e-mails mudam, o passo a passo na Resend, a verificação, as quotas e o que acontece quando a chave falha.

No plano **Business** ou superior, a comunidade pode enviar os seus e-mails pela **própria conta na [Resend](https://resend.com)**: com o remetente do seu domínio (`Comunidade <contacto@envio.suacomunidade.com>`), a sua reputação e o seu painel de entregas. As quotas de destinatários de campanha e de e-mails de workflow do plano deixam de valer para o que sai pela conta dela.

Fica em **Definições › Envio pela sua conta Resend**, para o proprietário e o administrador. Abaixo do Business, a página avisa que o envio *"está disponível no plano Business ou superior"*. **Ligar a conta Resend** pede o **Nome do remetente**, o **Endereço do remetente**, **Responder para (Reply-To, opcional)**, a **Chave de API da Resend**, o **Segredo de assinatura do webhook** e o aceite do **Aviso de dados**. Ligada, a página mostra o **Endereço do webhook** com **Copiar**, o estado (**Pendente**, **Ativa**, **Com erro** ou **Pausada pelo plano**), o **Último erro**, o **Último evento recebido** e **Verificada em**, com os botões **Verificar**, **Alterar** e **Desligar** (que pede *"Desligar a conta Resend?"*). Nas campanhas, o medidor de quota passa a chamar-se **Destinatários pela sua conta Resend**.

## Que e-mails mudam

**Regra:** sai pela Memberfy o e-mail que transporta um acesso (código, ligação de palavra-passe, convite com ligação para entrar), o que trata da segurança da conta, o que é da Memberfy para a comunidade e os avisos internos à equipa. Todo o resto é da comunidade. Assim, se a chave da comunidade falhar, ninguém fica trancado do lado de fora.

| Sempre pela Memberfy | Pela conta Resend da comunidade |
|---|---|
| Início de sessão, código de acesso, verificação de e-mail, palavra-passe (recuperar e alterada), aviso de tentativas de início de sessão | [Campanhas](/notificacoes/campanhas-de-email), manuais e automáticas |
| Convites com ligação de acesso (importação, orador, avaliador, registo aprovado) | O passo **Enviar e-mail** dos [workflows](/notificacoes/workflows) |
| Termos e privacidade | Os [avisos de novidade](/notificacoes/avisos-de-novidade) dos módulos e os e-mails de eventos, reservas e chamadas |
| Avisos à equipa (aprovação e erro de workflow, reputação de envio, avisos de integração e desta ligação) | Recibos, renovações e bilhetes; os [e-mails padrão](/notificacoes/emails-padrao) personalizados, quando são da comunidade |

O convite de calendário (`.ics`) das reservas, do agendamento, do Networking e do 1:1 acompanha o remetente pelo qual o e-mail sai.

## Passo a passo

*Papel: proprietário ou administrador, no plano Business ou superior.*

**Na Resend:**

1. Crie a conta e adicione o **domínio** de envio (de preferência um subdomínio, como `envio.suacomunidade.com`). Publique no seu DNS os registos que a Resend mostrar e espere que o domínio fique **verificado**.
2. Crie uma **chave de API** (`re_…`) com permissão **só de envio**, restrita a esse domínio.
3. Crie um **webhook** que aponte para o endereço que a Memberfy dá à sua comunidade (`https://api.memberfy.net/webhooks/email/c/…`), com os eventos de envio, entrega, abertura, clique, devolução, reclamação, atraso, falha e supressão. Copie o **segredo de assinatura** (`whsec_…`).

**Na Memberfy:**

4. Indique a chave, o segredo do webhook, o remetente (nome e endereço no domínio verificado) e, se quiser, o endereço de resposta (*Reply-To*). Aceite o aviso de dados: os endereços dos membros passam a ir para a sua conta Resend, e é a comunidade que escolhe esse operador.
5. Clique em **Verificar**. A Memberfy envia-lhe um e-mail de teste, a partir do seu remetente.
6. A ligação fica **ativa** quando o evento de entrega desse teste chega, assinado, pelo webhook. A mesma verificação prova a chave, o domínio e o webhook.

O remetente não pode ser de uma caixa gratuita (Gmail, Outlook…) nem da Memberfy. A chave e o segredo nunca voltam a aparecer depois de guardados: só se mostram os 4 últimos caracteres. Todas as alterações ficam registadas.

## Os estados da ligação

| Estado | O que significa |
|---|---|
| **Pendente** | Falta chegar pelo webhook o evento de entrega do teste |
| **Ativa** | Os e-mails da comunidade saem pela conta dela |
| **Com erro** | A Resend recusou a chave (ver [Quando a chave falha](#quando-a-chave-falha)) |
| **Pausada pelo plano** | O plano desceu abaixo do Business: tudo sai pela Memberfy |

## Quotas

Com a ligação ativa, o que sai pela conta da comunidade **não conta** nas quotas do plano de destinatários de campanha por mês e de e-mails de workflow por dia. Em vez delas, vale um teto contra abuso: **150.000 destinatários de campanha por mês** e **1.750 e-mails de workflow por dia**.

Continuam a valer: os envios de campanha por dia, semana e mês (ver [Quota de envios](/notificacoes/campanhas-de-email#quota-de-envios)), o cancelamento da subscrição e as categorias (ver [E-mails desta comunidade](/notificacoes/emails-desta-comunidade)), a exclusão de quem reclamou ou teve devolução permanente e a [reputação de envio](/notificacoes/reputacao-de-envio). Protegem quem recebe, não o custo.

## Quando a chave falha

Se a Resend recusar a chave (foi revogada, ou o domínio deixou de estar verificado):

- A ligação fica **com erro**, e o proprietário e o administrador recebem um aviso no sino e por e-mail (pela Memberfy), uma vez.
- A campanha que está a sair **é pausada**, e o passo **Enviar e-mail** dos workflows falha, com o motivo.
- Recibos, bilhetes, renovações e avisos dos módulos **saem pela Memberfy**, com o remetente padrão, para ninguém ficar sem eles.
- Ao **Verificar** de novo com a chave certa, a ligação volta a ficar ativa, e a campanha pausada **continua onde parou**.

Uma recusa temporária da Resend (excesso de envios ou instabilidade) só espera e volta a tentar, pela mesma conta.

**Se o plano descer abaixo do Business**, a ligação é pausada de imediato, tudo volta a sair pela Memberfy, com as quotas do plano, e a equipa é avisada. A chave e o segredo são apagados 30 dias depois.

## Perguntas frequentes

**Preciso de um domínio meu?**
Sim: o remetente tem de ser de um domínio verificado na sua conta Resend.

**Os e-mails de início de sessão também saem pela minha conta?**
Não. Início de sessão, códigos, palavra-passe e convites com ligação de acesso saem sempre pela Memberfy.

**Quem paga o envio?**
O que sai pela sua conta Resend é cobrado pela Resend na sua conta, segundo o plano que tem lá.

**E o cancelamento da subscrição dos e-mails?**
Continua a ser da Memberfy: a ligação para cancelar a subscrição e as categorias de cada pessoa valem da mesma forma.

## Na API

`GET`, `PUT` e `DELETE /api/email-provider` e `POST /api/email-provider/verify`, só para o proprietário e o administrador (os outros papéis recebem `403`). O `GET` responde em qualquer plano, com `planAllowed`; guardar e verificar abaixo do Business devolvem `403` `emailProvider.planRequired`. O `PUT` recebe `apiKey`, `webhookSecret`, `fromEmail`, `fromName`, `replyTo` e, na primeira vez, `acceptDataNotice: true`. A resposta traz `status` (`pending`, `active`, `error` ou `paused_by_plan`), `apiKeyLast4`, `webhookSecretLast4`, `webhookUrl` (o endereço a registar como webhook na Resend), `lastError`, `lastEventAt`, `verifiedAt` e `retentionEndsAt`; nunca a chave. Ver [Email provider](/api/referencia/email-provider) na Referência da API.

## Pelo assistente (MCP)

Peça para ver o estado da ligação (*"os e-mails já saem pela nossa conta Resend?"*, [`get_email_provider`](/mcp/ferramentas-comunidade#get-email-provider)), mudar o remetente ([`update_email_provider`](/mcp/ferramentas-comunidade#update-email-provider)), enviar a verificação ([`verify_email_provider`](/mcp/ferramentas-comunidade#verify-email-provider)) ou desligar ([`disconnect_email_provider`](/mcp/ferramentas-comunidade#disconnect-email-provider), com confirmação). Ligar a conta, a chave e o segredo ficam só na app: o assistente nunca recebe nem mostra a chave.

## Relacionados

- [Campanhas de e-mail](/notificacoes/campanhas-de-email)
- [E-mails desta comunidade](/notificacoes/emails-desta-comunidade)
- [Reputação de envio](/notificacoes/reputacao-de-envio)
- [Plano e extensões](/configuracoes/plano)