Freeform
Crie formulários no EmDash com um construtor assistido por IA, pontuação anti-spam, notificações por e-mail, webhooks e exportações CSV.
Extensão
Freeform
Crie formulários no EmDash com um construtor assistido por IA, pontuação anti-spam, notificações por e-mail, webhooks e exportações CSV.
Descrição
Freeform for EmDash
Crie formulários, recolha envios e aja sobre eles — sem sair do EmDash.
Construtor de formulários
- 13 tipos de campo: text, email, textarea, number, phone, date, checkboxes, radio, dropdowns, multi-select, hidden e blocos HTML
- Disposição por linhas com validação por campo (comprimento, padrão, mín./máx.)
- Um construtor com IA que cria e edita formulários a partir de uma descrição em inglês simples
- Formulários de arranque para contacto e subscrição da newsletter prontos a usar
Envios
- Uma caixa de entrada de envios com pesquisa, paginação e vistas de detalhe completas
- Resumos de envios com IA: intenção, urgência, factos principais e uma próxima ação sugerida
- Exportação CSV para folhas de cálculo e relatórios
Automatização e proteção
- Notificações por e-mail com modelos reutilizáveis, enviadas a si ou a quem fez o envio
- Webhooks assinados (HMAC-SHA256) com novas tentativas automáticas e um registo de entrega
- Pontuação anti-spam com honeypot e proteção CSRF em cada envio
- Servidor MCP opcional para que os agentes de IA giram formulários e leiam envios
Os formulários são mostrados no seu site com o pacote complementar @solspace/freeform-astro,
que inclui componentes sem estilo que você veste com o seu próprio CSS.
Instalação
Instalação
1. Instalar o plugin
Na sua administração do EmDash, vá a Plugins → Registry, encontre Freeform e instale-o. O Freeform aparece na barra lateral depois de instalado.
2. Mostrar os formulários no seu site
A administração do Freeform reside no plugin; os formulários públicos são mostrados por um pequeno pacote Astro complementar:
pnpm add @solspace/freeform-astro// astro.config.mjs
import { defineConfig } from "astro/config";
import emdash from "emdash/astro";
import freeformAstro from "@solspace/freeform-astro";
export default defineConfig({
integrations: [emdash(), freeformAstro()],
});Depois incorpore qualquer formulário pelo seu identificador:
---
import { FreeformForm } from "@solspace/freeform-astro/components";
---
<FreeformForm formId="contact" />3. Opcional: funcionalidades de IA
O construtor de formulários com IA, a pontuação anti-spam e os resumos de envios precisam da sua própria chave de API da Anthropic. Adicione-a em Freeform → Settings. Sem uma chave, tudo o resto — criar formulários à mão, envios, e-mail, webhooks — funciona normalmente.
Perguntas frequentes
Perguntas frequentes
Preciso de uma chave de API? Apenas para as funcionalidades de IA (construtor de formulários com IA, pontuação anti-spam com IA, resumos de envios). Adicione a sua própria chave de API da Anthropic em Freeform → Settings. Os formulários, os envios, as notificações por e-mail e os webhooks funcionam sem ela.
Como são os envios protegidos do spam? Cada formulário inclui um campo honeypot e tokens CSRF assinados. Se adicionar uma chave da Anthropic, cada envio recebe também uma pontuação de spam com IA e é assinalado face a um limiar que você controla, por formulário ou globalmente.
Posso ser avisado dos novos envios? Sim. Crie um modelo de e-mail, atribua-o a um formulário e escolha se vai para quem fez o envio (usando o seu campo de e-mail) ou para um endereço fixo. Também pode disparar webhooks assinados para qualquer URL em cada envio.
Como exporto os envios? Na vista Submissions pode transferir um CSV de qualquer formulário ou gerar uma ligação de exportação de curta duração.
Os agentes de IA podem gerir os meus formulários?
Sim. O Freeform inclui um servidor MCP opcional (emdash-freeform-mcp) que
expõe ferramentas de formulários e envios a clientes como o Claude e o Cursor.
Os formulários mostrados têm estilo?
Não — é de propósito. O @solspace/freeform-astro produz HTML semântico com
atributos data-freeform-* para que os formulários combinem com o sistema de design do seu site.
Segurança
Segurança
Comunicar uma vulnerabilidade
Escreva para [email protected]. Por favor, não abra um issue público para problemas de segurança.
Como o Freeform protege o seu site
- Os formulários de envio levam um campo honeypot e tokens CSRF assinados com HMAC (verificação em tempo constante, expiração ao fim de 2 horas).
- Os webhooks de saída são assinados com HMAC-SHA256 (
X-Freeform-Signature) para que os recetores possam verificar a autenticidade. - As chaves de API que fornece (por exemplo, a da Anthropic) são guardadas no armazenamento de plugins do seu próprio site — nunca são enviadas à Solspace.
- As ligações de exportação são tokens assinados de curta duração; expiram automaticamente.