# Instruções para o seu agente de IA: e-mail profissional no seu domínio com o Mailflare (Cloudflare)

> Cole este arquivo inteiro no seu agente (Claude Code, Codex, Cursor ou similar) e peça: "siga estas instruções".
> Fonte: rtera.com.br/dicas/email (RTERA TechLab). Repositório: https://github.com/hieunc229/mailflare (AGPL-3.0).

## Objetivo
Caixa de e-mail funcionando em `email.SEUDOMINIO`, recebendo e enviando como `voce@SEUDOMINIO`, rodando na conta
Cloudflare do usuário.

## Regras para o agente
- Explique cada passo ao usuário em linguagem simples antes de executar.
- Nunca imprima, registre em log nem repita no chat o token do Cloudflare nem senhas. O usuário cola o token direto
  no campo `CF_TOKEN` da tela de deploy.
- Login, 2FA, pagamento e criação de senha da caixa são feitos pelo usuário. Você orienta.
- Se algo falhar, mostre o erro real e pare. Não finja que deu certo.

## Passo 1: conferir antes de mexer (IMPORTANTE)
1. Pergunte qual domínio será usado e confirme que o DNS dele está no Cloudflare.
2. Verifique se o domínio JÁ recebe e-mail: `dig MX SEUDOMINIO +short` (ou `nslookup -type=mx SEUDOMINIO`).
   - Se houver MX de outro provedor (Google, Outlook, Hostinger, Zoho...), AVISE: ligar o Mailflare troca o MX e o
     e-mail atual para de chegar. Sugira usar outro domínio para teste. Só siga com confirmação explícita.
3. Para ENVIAR, a conta precisa do plano Workers Paid (US$ 5/mês, 3.000 e-mails inclusos). Receber é grátis.
   Pergunte se o usuário quer só receber ou também enviar.

## Passo 2: token do Cloudflare (o usuário cria, você guia)
Cloudflare → Manage account → Account API tokens → Create token → Start from scratch. Nome: `mailflare-cf-token`.
- Política 1, escopo **Specified Domains = SEUDOMINIO** (não use conta inteira):
  DNS Edit · Zone Read · Zone DNS Settings Edit · Zone Settings Edit · Email Routing Rules Edit.
- Política 2, escopo Entire Account: Email Routing Addresses Edit · Email Sending Edit.
- Review → Create. O usuário copia o token e guarda; ele não aparece de novo.

## Passo 3: deploy
1. Abra `https://deploy.workers.cloudflare.com/?url=https://github.com/hieunc229/mailflare`
   (é o botão "Deploy to Cloudflare" do README).
2. O usuário escolhe a conta do GitHub e marca "Create private Git repository".
3. Mantenha os padrões de D1 (`mailflare`), R2 (`mailflare-raw`) e filas.
4. O usuário cola o token no campo `CF_TOKEN`. Build `npm run build`, deploy `npm run deploy` (padrão).
5. Deploy. Espere o build ficar verde (~1m30s) e clique "Visit".

## Passo 4: setup do app
1. Abra `<url do app>/setup`. Passo System: confira D1 e credenciais ✓.
2. Passo Domain: digite o domínio; deixe "Skip DNS setup" DESLIGADO; ligue "Enable sending" se for enviar.
3. Passo Account: o usuário cria a caixa (usuário, senha, e-mail de recuperação).

## Passo 5: endereço próprio
1. Worker `mailflare` → Settings → Domains → Add domain → zona do domínio → subdomínio `email` → Add.
2. Settings → Variables → Add variable: `APP_URL` = `https://email.SEUDOMINIO` (não secreto) → "Add variable and deploy".
3. Abra `https://email.SEUDOMINIO` e faça login.

## Passo 6: testar com o usuário
1. Mande um e-mail de um Gmail pessoal para `voce@SEUDOMINIO`: deve aparecer na Inbox.
2. Responda pela caixa do Mailflare (se o envio estiver ligado): deve chegar no Gmail. Peça para o usuário olhar o spam.
3. Se não enviar: confira se o Email Sending está ativo e se o plano é Workers Paid.

## Ao terminar, entregue ao usuário
- Endereço da caixa, onde estão os recursos (Worker, D1, R2) e o repositório privado criado no GitHub dele.
- O resultado real dos testes de receber e enviar.
- Lembrete: atualizar o Mailflare = puxar mudanças do repositório original para a cópia dele (o deploy refaz sozinho).