Webhook
FormgongはJSONをPOSTし、生の本文にHMAC-SHA256の署名を付けます。シークレットはフォーム設定にあります。送信は最大5回で、再送の間隔は30秒、2分、10分、30分です。
最後の試行も失敗すると、Formgong はフォームの所有者にメールを送ります。同じ再試行のあと、Slack や Discord の Webhook、その他の Webhook、Google スプレッドシート、Telegram が失敗したときも同じメールです。フォームとチャネルごとに1日1通までで、Free を含むすべてのプランで送られます。Telegram のメールは、何が起きたかを平易な言葉で書きます(たとえばボットがグループから削除された、チャットが見つからない、ユーザーがボットをブロックした)。つなぎ直す手順も書きます。フォーム設定で新しいコードを作り、ボットのリンクを開くか、グループにボットを追加してそのコードで /connect を送ってください。
{
"event": "submission.created",
"form": { "id": "…", "name": "…" },
"submission": {
"id": "…",
"created_at": "2026-09-29T12:00:00.000Z",
"page_url": "https://example.com/",
"fields": { "name": "美咲", "email": "misaki@example.jp" },
"is_spam": false
}
}
Header X-Signature: sha256=…. Header X-Formgong-Event: submission.created.
import { createHmac, timingSafeEqual } from "node:crypto";
function verified(rawBody, signature, secret) {
const digest = createHmac("sha256", secret).update(rawBody).digest();
const got = Buffer.from(String(signature).replace(/^sha256=/, ""), "hex");
return got.length === digest.length && timingSafeEqual(got, digest);
}
Webhook のファイルリンク
Webhook 内のアップロードファイルごとに、期限まではサインインなしで開ける署名付きの download_url が付きます。リンクを持っていれば誰でもファイルをダウンロードできるため、Webhook を受け取るサービスがファイルを必要とする場合だけオンにしてください。オフにする、Webhook シークレットを更新する、送信を削除すると、リンクはすぐに使えなくなります。
有効にするには、フォームの設定でファイル添付を許可し、Webhook の項目で「Webhook のファイルリンク」から 24 時間か 7 日間を選んで保存します。リンクが付くのは、その後に送られる Webhook だけです。
"attachments": [{
"id": "…", "field": "photo", "filename": "cart.jpg", "size": 182044, "content_type": "image/jpeg",
"url": "https://formgong.com/dashboard/forms/…/attachments/…",
"download_url": "https://formgong.com/files/…?exp=…&sig=…",
"download_expires_at": "2026-11-02T12:00:00.000Z"
}]
以後、submission.attachments の各ファイルに download_url と download_expires_at が付きます。受け取るサービスは、ヘッダーもログインも不要な通常の GET リクエストでファイルをダウンロードできます。期限を過ぎたリンクは 404 を返し、1 つのファイルは 1 時間に 60 回までダウンロードできます。メール、Telegram、Slack や Discord のメッセージにはこのリンクは付きません。
Slack と Discord
Webhook 欄に Slack の Incoming Webhook URL(https://hooks.slack.com/services/…)または Discord チャンネルの Webhook URL(https://discord.com/api/webhooks/…)を貼り付けると、Formgong は上の JSON の代わりに、フォーム名・回答・ページ・送信内容へのリンクを含む短いチャットメッセージを送ります。
@everyone、@here、@channel などのメンションは無効化され、訪問者がリンクを別の文字列の裏に隠すことはできません。長い送信内容はプラットフォームの上限に合わせて短くし、全文へのリンクを付けます。ファイルは名前で表示されます。X-Signature ヘッダーは引き続き送られ、再試行と配信ログは通常の Webhook と同じように動作します。「テスト送信」でメッセージの見た目を確認できます。
Slack ワークフローのリンク(hooks.slack.com/triggers/…)とその他の URL には JSON が届きます。
Make, n8n, Zapier
Webhookモジュール(Make)、Webhookノード(n8n)、またはCatch Hook(Zapier)を作成し、そのURLをフォームの設定に貼り付けてください。そこからsubmission.fieldsをマッピングしてください。
手順ガイド(英語): Make, n8n, Zapier, KeyCRM.
Google Sheets
// Webhook URL: the web app URL + "?key=" + the same SECRET (Apps Script cannot read headers).
const SECRET = "change-me";
function doPost(e) {
if (e.parameter.key !== SECRET) return reply();
const body = JSON.parse(e.postData.contents);
if (body.event !== "submission.created") return reply(); // the dashboard test sends "webhook.test"
const lock = LockService.getScriptLock();
lock.waitLock(20000);
try {
const sheet = SpreadsheetApp.getActive().getSheetByName("Leads");
const id = body.submission.id;
// A retry after a timeout carries the same id: skip rows that are already there.
if (!sheet.getRange("A:A").createTextFinder(id).matchEntireCell(true).findNext()) {
const fields = body.submission.fields;
sheet.appendRow([id, body.submission.created_at, fields.name, fields.email, fields.message]);
}
} finally {
lock.releaseLock();
}
return reply();
}
// HtmlService, not ContentService: ContentService answers with a redirect, and a webhook counts a redirect as a failure.
function reply() {
return HtmlService.createHtmlOutput("ok");
}
KeyCRM
専用コネクタはありません。n8nかMakeでFormgongのWebhookを受け、自分のキーでKeyCRM APIを呼びます。値は submission.fields から読んでください。