Sua Telefonia | E-mail Marketing Beta v0.3

Visão geral das campanhas

Administre os envios e as contas cadastradas sem interferir no CRM principal.

Contatos—

Autorizados—

Na fila—

Planejados—

Como funciona nesta versão

1Cadastre as contas e seus limites

2Importe e verifique os domínios dos contatos com opt-in documentado

3Crie um modelo com variáveis

4Distribua e acompanhe a fila em simulação

Nesta versão de testes o CRM não conecta SMTP real, não envia e-mails e não consome cotas de Gmail, Outlook ou Hostinger.

Contas de e-mail

Cada conta recebe um teto diário e horário próprio. Os números abaixo são cotas internas, não permissões concedidas pelo provedor.

Adicionar conta para simulação

Hostinger: 900/dia • Gmail: 500/dia • Outlook gratuito: 300/dia são referências configuráveis que você definiu. Verifique se cada conta está autorizada a usar esses volumes. As cotas podem ser compartilhadas.

Contas cadastradas

Importação de contatos

Contatos vindos da Receita Federal não são automaticamente elegíveis para envio. A Receita Federal e o sistema Leads podem ser fontes de contatos, mas não constituem autorização automática para disparos. Só entram na fila os contatos com opt-in comprovado E DNS MX verificado.

Importar CSV

↓ Baixar modelo

Origem dos contatosArquivo CSV

Até 20.000 contatos por lote e 5 MB de JSON. Colunas: email, nome, empresa, cnpj, cidade, uf, endereco, cnae, porte, origem (opcional), opt_in_at, opt_in_source e opt_in_evidence. Não invente nem marque opt-in apenas pela origem do CNPJ.

Importar diretamente do Sua Telefonia Leads

API HTTPS

Sincronização autenticada com lead.suatelefonia.com.br. A rota /api/v1/export/email precisa estar disponível no sistema Leads. Importação por lotes, sem enviar campanhas.

Carregando configuração de integração...

Token e identificação da organização ficam somente no backend da Hostinger, no arquivo .env ou variáveis de ambiente. O sistema nunca converte dados públicos em opt-in. Caso a rota ainda não exista, continue importando CSV.

Verificação de e-mails

A verificação confere o formato e a configuração DNS de recebimento. Não garante que a caixa postal existe, nem comprova consentimento. As consultas são feitas por domínio, em pequenos lotes.

Aguardando verificação.

Para listas grandes, repita a verificação até terminar ou use o cron de verificação descrito no manual. Nunca usamos o resultado para gerar opt-in.

Contatos recentes

E-mail	Empresa	Origem	Verificação	Autorização

Campanhas personalizadas

Crie um modelo com campos {{empresa}}, {{cnpj}}, {{cidade}}, {{nome}} e outros. O texto será personalizado para cada destinatário.

Nova campanha

Campanhas existentes

Fila e distribuição

Segunda a sábado • 08h às 19h • Horário de Brasília. O agendamento é persistente e não envia mensagens reais nesta beta.

Agendamentos simulados

Dia	Hora	Conta	Programados

A quantidade programada não é contabilizada como e-mail enviado ou entregue. Ao conectar SMTP no futuro, haverá confirmação por mensagem e reprocessamento controlado de falhas.

Bloqueios globais

Um contato bloqueado não pode ser selecionado em nenhuma conta ou campanha.

Bloquear ou descadastrar

Lista global

Instalação e integrações

A aplicação usa um banco independente e foi preparada para futura integração com o CRM Sua Telefonia.

Configuração segura

Domínio planejado: email.suatelefonia.com.br
Banco de dados: SQLite criado automaticamente em EMAIL_DATA_DIR/email-st.db
Inicialização: start.mjs ou npm start
Configuração: .env.example + variáveis na Hostinger
Envio: Simulação somente (nenhum SMTP real)
API Leads: Configurável via LEADS_EXPORT_URL, LEADS_EXPORT_TOKEN e LEADS_EXPORT_ORG_ID (somente backend)

Faça backup de EMAIL_DATA_DIR antes de uma atualização. Nunca coloque banco, tokens ou .env preenchido dentro do ZIP de publicação. Para mais detalhes, leia INSTALAR_HOSTINGER.md.