CommunityEscrita e Ediçãogithub.com

resend/boas-praticas-email

Use ao construir funcionalidades de email, emails indo para spam, altas taxas de bounce, configuração de autenticação SPF/DKIM/DMARC, implementação de captura de email, garantia de conformidade (CAN-SPAM, GDPR, CASL), manipulação de webhooks, lógica de retry, criação de emails acessíveis (texto alternativo, cabeçalhos, contraste, leitores de tela) ou ao decidir entre transacional vs marketing.

O que é boas-praticas-email?

Este skill fornece um conjunto abrangente de boas práticas para o envio de emails, abordando desde a configuração técnica de autenticação (SPF, DKIM, DMARC) até a conformidade com leis como CAN-SPAM, GDPR e CASL. É útil para desenvolvedores que enfrentam problemas como emails indo para spam, altas taxas de bounce ou precisam decidir entre email transacional e marketing. O skill orienta sobre implementação de captura de email, lógica de retry em falhas de envio, manipulação de webhooks para eventos de email, e boas práticas de acessibilidade (como texto alternativo em imagens, uso de cabeçalhos, contraste adequado e compatibilidade com leitores de tela). Ao seguir estas diretrizes, desenvolvedores podem construir sistemas de email robustos, confiáveis e em conformidade, melhorando a entregabilidade e a experiência do usuário em diversas plataformas, incluindo APIs de serviços como Resend.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/resend/resend-skills/tree/main/skills/email-best-practices

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que boas-praticas-email faz?

Use ao construir funcionalidades de email, emails indo para spam, altas taxas de bounce, configuração de autenticação SPF/DKIM/DMARC, implementação de captura de email, garantia de conformidade (CAN-SPAM, GDPR, CASL), manipulação de webhooks, lógica de retry, criação de emails acessíveis (texto alternativo, cabeçalhos, contraste, leitores de tela) ou ao decidir entre transacional vs marketing.

Por que isso importa

Emails são uma parte crítica da comunicação com usuários. Seguir boas práticas garante que seus emails sejam entregues, não marcados como spam, e proporcionem uma boa experiência para todos os destinatários, incluindo aqueles com deficiências.

Autenticação

Configure SPF, DKIM e DMARC para seus domínios. Isso ajuda provedores de email a verificarem que seus emails são legítimos e não spoofados.

Conformidade

  • CAN-SPAM: Inclua informações precisas de remetente, assunto, endereço físico e opção de descadastro.
  • GDPR: Obtenha consentimento explícito para marketing, permita acesso e exclusão de dados.
  • CASL: Requer consentimento expresso ou implícito, e identifica claramente o remetente.

Boas práticas de envio

  • Transactional vs Marketing: Use APIs separadas e diferentes taxas de envio. Emails transacionais têm prioridade.
  • Rate limiting: Respeite os limites do provedor de email.
  • Retry logic: Implemente retry exponencial para falhas temporárias.
  • Webhooks: Capture eventos de bounce, reclamação, abertura e clique para monitorar entregabilidade.

Acessibilidade

  • Use texto alternativo em imagens.
  • Utilize cabeçalhos (h1, h2) para estrutura.
  • Garanta contraste suficiente entre texto e fundo.
  • Teste com leitores de tela.

Captura de email

  • Use double opt-in para confirmar endereços.
  • Valide emails no frontend e backend.
  • Evite listas compradas.

Recursos

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

resend/agent-email-inbox

Use when building any system where email content triggers actions — AI agent inboxes, automated support handlers, email-to-task pipelines, or any workflow processing untrusted inbound email. Always use this skill when the user wants to receive emails and act on them programmatically, even if they don't mention "agent" — the skill contains critical security patterns (sender allowlists, content filtering, sandboxed processing) that prevent untrusted email from controlling your system.

resend/react-email

Use when building HTML email templates with React components, adding a visual email editor to an application using the React Email visual editor, rendering emails to HTML, or sending emails with Resend. Covers welcome emails, password resets, notifications, order confirmations, newsletters, transactional emails, and the embeddable email editor component.

resend/resend

Use when working with the Resend email API — sending transactional emails (single or batch), receiving inbound emails via webhooks, managing email templates, tracking delivery events, managing domains, contacts, broadcasts, webhooks, API keys, automations, events, viewing API request logs, or setting up the Resend SDK. Always use this skill when the user mentions Resend, even for simple tasks like "send an email with Resend" — the skill contains critical gotchas (idempotency keys, webhook verification, template variable syntax) that prevent common production issues.

resend/resend-cli

Operate the Resend platform from the terminal — send emails (including React Email .tsx templates via --react-email), manage domains, contacts, broadcasts, templates, webhooks, API keys, logs, automations, and events via the `resend` CLI. Use when the user wants to run Resend commands in the shell, scripts, or CI/CD pipelines, or send/preview React Email templates. Always load this skill before running `resend` commands — it contains the non-interactive flag contract and gotchas that prevent silent failures.

Habilidades Relacionadas