Pular para o conteúdo

Recursos

Gerenciador de arquivos

O gerenciador de arquivos se conecta ao seu bucket compatível com S3 para guardar e servir os arquivos e as imagens dos seus templates de email. Um endpoint de CDN opcional serve esses arquivos mais rápido.

Captura de tela do gerenciador de arquivos

Configuração do armazenamento S3

Configure o seu armazenamento compatível com S3 com estes campos:

  • Endpoint S3: a URL do endpoint do seu armazenamento compatível com S3
  • Chave de acesso S3: chave de acesso para a autenticação
  • Chave secreta S3: chave secreta para a autenticação
  • Bucket S3: nome do bucket em que os arquivos serão guardados
  • Região S3: região do armazenamento (por exemplo, us-east-1)

Configuração da CDN

Endpoint da CDN

  • Finalidade: URL da CDN que guarda os seus arquivos em cache
  • Vantagem: entrega de arquivos mais rápida e menor custo de banda
  • Opcional: não é obrigatório, mas é recomendado

Personalização das URLs

Quando um endpoint de CDN está configurado, as URLs dos arquivos nos seus templates de email usam a URL da CDN em vez da URL direta do S3.

Configuração de CORS

Para que o gerenciador de arquivos envie arquivos direto do seu navegador, configure o CORS (Cross-Origin Resource Sharing) no seu bucket.

Cloudflare R2 / AWS S3

Crie uma política de CORS com esta configuração:

[
  {
    "AllowedOrigins": ["*"],
    "AllowedMethods": ["GET", "POST", "HEAD", "DELETE", "PUT"],
    "AllowedHeaders": ["*"]
  }
]

Dica

Em produção, substitua "*" em AllowedOrigins pela URL do seu console do Notifuse, para mais segurança.

Google Cloud Storage

No GCS, use o comando gsutil com um arquivo de configuração JSON:

[
  {
    "origin": ["*"],
    "method": ["GET", "POST", "HEAD", "PUT", "DELETE", "OPTIONS"],
    "responseHeader": ["Content-Type", "*"]
  }
]

Aplique a configuração de CORS:

gsutil cors set cors.json gs://your-bucket-name

Provedores de armazenamento compatíveis

Os arquivos podem ser enviados para qualquer serviço de armazenamento compatível com S3:

  • Amazon S3
  • Cloudflare R2
  • DigitalOcean Spaces
  • Wasabi
  • MinIO
  • Backblaze B2
  • Google Cloud Storage (API S3)

Opção de S3 auto-hospedado

Se você preferir não usar um provedor de armazenamento em nuvem, pode rodar o nosso servidor de armazenamento compatível com S3 auto-hospedado:

Armazenamento S3 auto-hospedado

Um servidor de armazenamento leve, compatível com S3 e baseado em Docker, para hospedar o Notifuse por conta própria sem dependências externas.

Ele serve para:

  • Ambientes isolados ou sem conexão com a internet
  • Desenvolvimento e testes
  • Quem quer controle total sobre os próprios dados
  • Evitar os custos de um provedor de nuvem

Uso dos arquivos

Depois de configurado, os arquivos enviados podem ser usados em:

  • Imagens dos templates de email
  • Anexos
  • Elementos da marca (logos, cabeçalhos)
  • Qualquer conteúdo de mídia das suas campanhas de email

Limites

O gerenciador de arquivos lista os primeiros 10.000 arquivos de um bucket. Num bucket maior, a contagem por pasta, o tamanho total e a busca só consideram esses arquivos; os outros continuam guardados e continuam funcionando nos seus emails.

Integração com o editor de templates

O gerenciador de arquivos fica disponível no editor visual de emails:

  • Acesso em janela modal: o gerenciador de arquivos abre numa janela modal enquanto você edita um template
  • Integração direta: selecione e insira arquivos a partir do editor
  • Envio em tempo real: envie novos arquivos sem sair do editor de templates