NaraForm

每筆新回覆送出時，NaraForm 可以即時向你的系統發送 HTTP POST 通知。常見用途：推送到 Slack、寫入 Notion、觸發自動化流程。

設定方式

進入表單設定

在 Builder 切換到「設定」頁籤，找到「Webhook 通知」區塊。

填入 Webhook URL

輸入你的接收端 URL，必須使用 HTTPS。HTTP 網址會被拒絕儲存。

啟用開關

打開「啟用 Webhook」開關，儲存設定。之後每筆新回覆都會觸發通知。

Payload 格式

每次觸發時，系統會發送以下 JSON：

{
  "event": "form.submitted",
  "formId": "clx123abc",
  "formTitle": "客戶滿意度調查",
  "responseId": "clx456def",
  "submittedAt": "2025-03-29T10:30:00.000Z",
  "answersPreview": [
    { "key": "q1", "value": "非常滿意" },
    { "key": "q2", "value": "5" },
    { "key": "q3", "value": "介面很直觀" }
  ]
}

欄位	說明
`event`	固定為 `form.submitted`
`formId`	表單 ID
`formTitle`	表單標題
`responseId`	這筆回覆的 ID
`submittedAt`	提交時間（ISO 8601）
`answersPreview`	前 5 題的答案預覽

answersPreview 最多包含前 5 題。若需要完整答案，請用 responseId 呼叫後台 API 取得。

行為特性

非阻塞：Webhook 在回覆送出後非同步發送，不影響填寫者看到的回應速度
10 秒 timeout：若接收端超過 10 秒未回應，視為失敗，記錄錯誤日誌，不重試
不重試：目前不支援自動重試，若需要可靠投遞請在接收端設計冪等處理

測試方式

使用 webhook.site 建立臨時測試端點：

開啟 webhook.site，複製產生的 HTTPS URL
貼到表單 Webhook URL 欄位，啟用後儲存
填寫並送出一筆測試回覆
回到 webhook.site 確認收到 payload 內容

Webhook 通知