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 から読んでください。

KeyCRM: 手順ガイド(英語)