Freeform
AI 支援のビルダーで EmDash にフォームを作成。スパムスコアリング、メール通知、Webhook、CSV エクスポートに対応。
プラグイン
Freeform
AI 支援のビルダーで EmDash にフォームを作成。スパムスコアリング、メール通知、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 保護を備えたスパムスコアリング
- AI エージェントがフォームを管理し送信内容を読み取れる、任意の MCP サーバー
フォームは、付属の @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()],
});
その後、ハンドルを指定して任意のフォームを埋め込みます。
---
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 に送信されることはありません。
- エクスポートリンクは有効期間の短い署名付きトークンで、自動的に失効します。