AI Email Sections para Mautic: um assistente de AI no editor que não estraga os teus emails

A maioria das funcionalidades "a AI escreve o teu email" partilha a mesma fraqueza: entregam-te um bloco de HTML e desejam-te boa sorte. Cola-o num editor de emails a sério e as coisas desfazem-se em silêncio. Tags que o editor não entende, layouts que só sobrevivem num cliente de email, tokens de personalização que desaparecem algures entre a janela de chat e o canvas. A demo fica impecável; a newsletter de terça de manhã, não.

Fazemos o email marketing dos nossos clientes no Mautic, a plataforma open-source de automação de marketing, e o editor GrapesJS é onde essas newsletters são realmente construídas. Por isso, em vez de uma AI que escreve emails noutro sítio qualquer, pusemos uma dentro do editor, e pusemos a plataforma a verificar o trabalho dela. Estamos agora a lançá-la para a comunidade: AI Email Sections, um plugin gratuito (GPL) para Mautic 7.

Descreve uma secção, recebe uma secção

O plugin acrescenta um bloco AI Section ao editor. Arrasta-o para o canvas, descreve o que queres em texto corrido ("um hero para a coleção de verão", "uma grelha de 3 colunas de produtos com botões", "um testemunho com fotografia") e carrega em Generate. Segundos depois a secção está no canvas, com as cores e a tipografia do teu tema, e editável exatamente como qualquer coisa que tivesses construído à mão. Também trabalha sobre o que já existe: seleciona uma secção, pede uma alteração ("passa para duas colunas", "encurta o texto") e ele reescreve essa secção no lugar.

A parte interessante é o que ele se recusa a fazer

O modelo nunca fala diretamente com o teu email. Tudo o que produz passa por um validador antes de chegar ao canvas:

• Gera MJML, a linguagem de componentes para email responsivo, nunca HTML cru, por isso o resultado é portável entre clientes de email por construção.
• Uma allowlist estrita de tags rejeita tudo o que o editor não saiba tratar. Sem tags inventadas, sem markup rebelde.
• Quando uma resposta falha a validação, o plugin tenta de novo automaticamente, devolvendo ao modelo as queixas do validador.
• No modo de edição, verificações de preservação garantem que uma alteração não deixou cair links, imagens ou tokens de personalização. Se a AI perder o teu link de unsubscribe, a edição não entra.

Esta última categoria foi a que nos convenceu de que isto tinha de ser um plugin a sério e não um prompt. O modo de falha da AI no email não é o primeiro rascunho mau, que se vê; é o link ou o token que desaparece em silêncio à quarta revisão.

Conhece a tua marca e os teus dados

Um brand brief configurável (voz, audiência, regras) é aplicado a todas as gerações, e o plugin lê a paleta e a tipografia do tema que o email usa, por isso as secções saem com o teu aspeto e não com aspeto de template. Também conhece os tokens de personalização disponíveis na tua instância de Mautic, por isso "cumprimenta o cliente pelo primeiro nome" produz um {contactfield=firstname} funcional em vez de um placeholder inventado que chegaria à caixa de entrada como texto literal.

Nascido em produção

O plugin nasceu no email marketing que fazemos para os nossos clientes de e-commerce, onde as newsletters que chegam aos subscritores são agora montadas secção a secção desta forma: header, hero, grelhas de produto, footer, cada uma gerada a partir de uma descrição curta e afinada no editor. Construir uma newsletter completa passou de uma tarde para uma conversa.

Traz o teu próprio modelo

Funciona com a API da Anthropic ou com qualquer endpoint compatível com OpenAI, o que inclui a própria OpenAI, o LiteLLM, e modelos locais via Ollama ou LM Studio se preferires manter tudo na tua infraestrutura. Com um modelo alojado, cada geração custa uma fração de cêntimo.

Revisto antes de chegar a ti

Como parte da submissão ao Marketplace do Mautic, o plugin passou por uma revisão de segurança da equipa core do Mautic. Tudo o que foi levantado foi corrigido e publicado no próprio dia na v1.0.6, cada correção coberta por um teste que primeiro falhou contra o código antigo. A troca completa é pública no pull request do marketplace, que é como achamos que a segurança deve funcionar em open source: revista por quem não escreveu o código, corrigida às claras, verificável por qualquer pessoa.

Como obter

O AI Email Sections é software livre (GPL-3.0). Está listado no Marketplace do Mautic, por isso em qualquer instalação Mautic 7 podes instalá-lo em Settings, Plugins, Marketplace, sem tocar na linha de comandos. Também é instalável com composer require bloomidea/mautic-plugin-ai-email-sections. O código, um GIF de demonstração e a documentação estão no GitHub, o pacote está no Packagist, e há uma thread de discussão no forum do Mautic. Feedback, issues e pull requests são muito bem-vindos.