Freeform
在 EmDash 中使用 AI 輔助的建構器建立表單,附帶垃圾訊息評分、郵件通知、Webhook 和 CSV 匯出。
外掛
Freeform
在 EmDash 中使用 AI 輔助的建構器建立表單,附帶垃圾訊息評分、郵件通知、Webhook 和 CSV 匯出。
說明
Freeform for EmDash
建構表單、收集提交內容並對其採取行動——無需離開 EmDash。
表單建構器
- 13 種欄位類型:text、email、textarea、number、phone、date、checkboxes、radio、dropdowns、multi-select、hidden 和 HTML 區塊
- 以列為基礎的版面配置,並支援逐欄位驗證(長度、模式、最小/最大值)
- AI 建構器,可根據一段簡單的英文描述建立和編輯表單
- 開箱即用的聯絡和電子報訂閱入門表單
提交內容
- 可搜尋的提交收件匣,支援分頁和完整的詳細檢視
- AI 提交摘要:意圖、緊急程度、關鍵事實和建議的下一步動作
- 匯出 CSV,便於用於試算表和報表
自動化與防護
- 帶可重複使用範本的郵件通知,可發送給你或提交者
- 帶簽章的 Webhook(HMAC-SHA256),支援自動重試和遞送記錄
- 垃圾訊息評分,每次提交都帶有蜜罐和 CSRF 防護
- 選用的 MCP 伺服器,讓 AI 代理可以管理表單並讀取提交內容
表單透過配套的 @solspace/freeform-astro
套件在你的網站上渲染,它提供不帶樣式的元件,供你用自己的 CSS 設計佈景主題。
安裝
安裝
1. 安裝外掛
在 EmDash 管理後台中,前往 Plugins → Registry,找到 Freeform 並 安裝。安裝後,Freeform 會出現在側邊欄中。
2. 在你的網站上渲染表單
Freeform 的管理介面位於外掛中;公開的表單由一個 小型配套 Astro 套件渲染:
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()],
});
然後透過表單的 handle 嵌入任意表單:
---
import { FreeformForm } from "@solspace/freeform-astro/components";
---
<FreeformForm formId="contact" />
3. 選用:AI 功能
AI 表單建構器、垃圾訊息評分和提交摘要需要你自己的 Anthropic API 金鑰。請在 Freeform → Settings 下加入。沒有金鑰時, 其他一切——手動建構表單、提交內容、郵件、Webhook—— 都能正常使用。
常見問題
常見問題
我需要 API 金鑰嗎? 只有 AI 功能(AI 表單建構器、AI 垃圾訊息評分、提交 摘要)才需要。請在 Freeform → Settings 中加入你自己的 Anthropic API 金鑰。表單、 提交內容、郵件通知和 Webhook 無需金鑰即可使用。
如何保護提交內容免受垃圾訊息侵擾? 每個表單都帶有蜜罐欄位和帶簽章的 CSRF 權杖。如果你加入了 Anthropic 金鑰,每次提交還會獲得一個 AI 垃圾訊息評分,並根據 你控制的閾值(依表單或全域)進行標記。
我能收到新提交的通知嗎? 可以。建立一個郵件範本,把它指派給某個表單,並選擇是發送給 提交者(使用其信箱欄位)還是發送到固定位址。你 還可以在每次提交時向任意 URL 發送帶簽章的 Webhook。
如何匯出提交內容? 在 Submissions 檢視中,你可以下載任意表單的 CSV,或產生 一個短期有效的匯出連結。
AI 代理能管理我的表單嗎?
可以。Freeform 提供選用的 MCP 伺服器(emdash-freeform-mcp),
向 Claude 和 Cursor 等用戶端開放表單和提交內容工具。
渲染出的表單帶有樣式嗎?
沒有——這是有意設計的。@solspace/freeform-astro 渲染帶有
data-freeform-* 屬性的語意化 HTML,使表單與你網站的設計系統相符。
安全性
安全性
回報漏洞
請寄送電子郵件至 [email protected]。請不要為安全問題公開提交 issue。
Freeform 如何保護你的網站
- 提交表單帶有蜜罐欄位和 HMAC 簽章的 CSRF 權杖 (防時序攻擊的驗證,2 小時有效期)。
- 對外發送的 Webhook 使用 HMAC-SHA256(
X-Freeform-Signature)簽章, 接收方可以驗證其真實性。 - 你提供的 API 金鑰(例如 Anthropic)儲存在你網站自己的 外掛儲存空間中——絕不會傳送給 Solspace。
- 匯出連結是短期有效的簽章權杖;它們會自動過期。