Newsletter

A newsletter guarda os e-mails de quem quer receber as novidades do blog. Ela usa confirmação dupla: ninguém entra na lista só por preencher o formulário. Quem administra a lista é quem tem o papel de administrador ou de editor.

Como alguém entra na lista

A pessoa digita o e-mail no formulário de inscrição, no rodapé dos posts. Para qualquer endereço válido, a resposta é a mesma: Inscrição recebida. Confira o seu e-mail para confirmar., mesmo para quem já está na lista. Assim, o formulário não revela quem está inscrito.
O inscrito fica como Pendente e recebe um e-mail com o assunto Confirme sua inscrição em seguido do nome do site. O e-mail tem o botão Confirmar inscrição.
A pessoa abre o link e vê a página Confirmar inscrição, com o botão de mesmo nome. Só o clique no botão confirma a inscrição. Abrir o link sozinho não muda nada, o que impede que um filtro de e-mail confirme alguém por engano.
Depois do clique, a página mostra Inscrição confirmada e a frase Pronto! Você vai receber as novidades por e-mail.. O inscrito passa a Inscrito.

Algumas regras do caminho:

O link de confirmação vale por 48 horas. Depois disso, a página diz Link vencido, com a orientação de preencher o formulário de novo.
Um link já usado, ou que não existe, leva à página Link inválido. Se a pessoa já confirmou, a página diz que está tudo certo.
Um mesmo e-mail recebe um novo pedido de confirmação no máximo a cada 5 minutos. Quem já está Inscrito não recebe nada.
O formulário tem um campo escondido, que o visitante não vê. Um robô que o preenche recebe a mesma resposta Inscrição recebida. Confira o seu e-mail para confirmar., mas nada é salvo nem enviado.
Um endereço que não tem formato de e-mail recebe Informe um e-mail válido..
Cada endereço de rede pode enviar até 3 tentativas por minuto no formulário. Passando disso, a resposta é Muitas tentativas. Tente de novo em alguns minutos.
O e-mail tem no máximo 254 caracteres, e o endereço é guardado em minúsculas. Ana@exemplo.com e ana@exemplo.com são o mesmo inscrito.

Se o e-mail de confirmação não sair, o painel registra o evento Confirmação de inscrição não enviada na atividade. Isso acontece, por exemplo, quando o endereço público do site não está configurado. Nesse caso, o endereço vem da variável PUBLIC_URL, veja as variáveis.

Como alguém sai da lista

Cada e-mail de confirmação traz um endereço para sair da lista a qualquer momento. Quem o abre vê a página Sair da lista, com o botão de mesmo nome. Depois do clique, a página diz Você saiu da lista, com a frase Você não vai mais receber as nossas mensagens.. O inscrito fica com o status Descadastrado.

Os provedores de e-mail também podem enviar o pedido de cancelamento direto, pelo botão de cancelar inscrição da própria caixa de entrada. O pedido cai no mesmo registro, e a resposta é a mesma. Quem já saiu, ou já foi apagado, recebe a mesma resposta de quem acaba de sair.

Os inscritos no painel

A lista de inscritos fica em Comunidade › Newsletter e leads. O título da tela é Inscritos.

Nas capturas, as datas aparecem mascaradas (24/••): o painel oculta as datas nas imagens para que elas não mudem a cada dia.

A lista mostra o e-mail, a Origem, o Status e a data Criado em, no formato dd/mm/aa. Você pode:

Buscar pelo e-mail.
Filtrar pela Origem: Post, quando a pessoa se inscreveu pelo formulário do blog, ou Painel, quando alguém digitou o e-mail no painel.
Filtrar pelo Status: Pendente, Inscrito ou Descadastrado.
Abrir um inscrito para editar o e-mail, a origem e o status. Os campos de confirmação não aparecem no formulário.
Excluir um inscrito, com a confirmação Esta ação não pode ser desfeita..

Para incluir alguém, use Adicionar inscrito. A origem vem como Painel e o e-mail não pode repetir um que já está na lista: a tela diz Este e-mail já está na lista.. Um inscrito incluído pelo painel não recebe o e-mail de confirmação. Quem decide o status dele é quem o cadastra.

Exportar a lista

Para baixar a lista, abra Comunidade › Exportar inscritos.

Nas capturas, as datas aparecem mascaradas (24/••): o painel oculta as datas nas imagens para que elas não mudem a cada dia.

A tela tem dois blocos:

Filtros, com Origem (Todas, Post, Painel) e Status (Todas, Pendente, Inscrito, Descadastrado). Clique em Atualizar para aplicar e em Limpar filtros para voltar a todos.
Arquivo, com a contagem N inscritos de quem corresponde aos filtros, e o botão Baixar CSV.

O arquivo sai assim:

Codificado em UTF-8, com uma marca de ordem de bytes (BOM) no início, colunas separadas por ponto e vírgula e linhas terminadas em CRLF. Abre direto no Excel e no Planilhas Google.
A origem e o status saem com os rótulos da tela (Post ou Painel; Pendente, Inscrito ou Descadastrado), não com os códigos internos.
Colunas: E-mail, Origem, Status e Inscrito em. A data sai como dd/mm/aaaa hh:mm, no fuso horário do site.
Quando uma célula começa com =, +, -, @, tabulação ou retorno de linha, sai com um apóstrofo na frente, para a planilha não executá-la como fórmula.
O nome é inscritos- seguido da data do dia, por exemplo inscritos-2026-10-24.csv.

Com Todas nos dois filtros, o arquivo traz todos os inscritos, inclusive os Descadastrado. O registro de atividade guarda só a quantidade exportada, nunca os e-mails. O arquivo tem dados pessoais: guarde-o com cuidado e veja Privacidade.

Repassar os inscritos por webhook

Um webhook é um endereço de outro sistema que recebe cada novo inscrito confirmado. Ele é configurado no módulo Newsletter, na tela de Módulos. Clique em Configurar e, no formulário Configurar Newsletter, preencha Endereço do webhook de repasse (https) e clique em Salvar configurações. Veja a página Módulos.

O endereço precisa começar com https://. Um endereço que não começa assim é recusado. Deixar o campo vazio desliga o repasse.
Só quem confirma a inscrição é repassado, uma vez por confirmação. Quem sai da lista e confirma de novo é repassado de novo.
O sistema envia um pedido POST com o JSON email, origem (post ou painel) e confirmadoEm (o instante da confirmação).
Um redirecionamento não é seguido. Qualquer resposta fora da faixa 2xx, inclusive o redirecionamento, conta como falha do webhook. O pedido espera no máximo 5 segundos pela resposta.
Se o webhook falhar, a confirmação continua valendo. O painel registra Repasse de inscrito por webhook falhou na atividade, sem o e-mail.

Permissões

As quatro permissões do módulo vêm com o papel de administrador e o de editor:

Ver inscritos: abre a lista.
Criar e editar inscritos: habilita Adicionar inscrito e a edição.
Excluir inscritos: habilita a exclusão.
Exportar a lista de inscritos: habilita a tela Exportar inscritos.

Telas desta página

Para quem implanta ou estende: as rotas desta tela.

Método	Caminho	Dono	Título	Permissão	Sem sessão
GET	`/painel/c/inscritos`	newsletter	Inscritos	`newsletter.ver`	Não
GET	`/painel/c/inscritos/novo`	newsletter	Inscrito	`newsletter.editar`	Não
POST	`/painel/c/inscritos`	newsletter	Inscrito	`newsletter.editar`	Não
GET	`/painel/c/inscritos/:id`	newsletter	Inscrito	`newsletter.ver`	Não
POST	`/painel/c/inscritos/:id`	newsletter	Inscrito	`newsletter.editar`	Não
POST	`/painel/c/inscritos/:id/excluir`	newsletter	Inscrito	`newsletter.excluir`	Não

Método	Caminho	Dono	Título	Permissão	Sem sessão
GET	`/painel/newsletter/exportar`	newsletter	Exportar inscritos	`newsletter.exportar`	Não
GET	`/painel/newsletter/exportar/:id`	newsletter	Exportar inscritos	`newsletter.exportar`	Não
POST	`/painel/newsletter/exportar`	newsletter	Exportar inscritos	`newsletter.exportar`	Não
POST	`/painel/newsletter/exportar/:id`	newsletter	Exportar inscritos	`newsletter.exportar`	Não