Webhooks
Formgong envía un POST JSON y una firma HMAC-SHA256 del cuerpo en bruto. El secreto está en los ajustes del formulario. Hasta 5 intentos; los reintentos esperan 30 s, 2 min, 10 min y 30 min.
Si el último intento también falla, Formgong envía un email al dueño del formulario. El mismo email se envía cuando, tras esos reintentos, falla un webhook de Slack o Discord, cualquier otro webhook, Google Sheets o Telegram. Como mucho un email al día por formulario y canal, en cualquier plan, incluido Free. El email de Telegram dice el problema con palabras claras (por ejemplo, el bot fue eliminado del grupo, no se encontró el chat o el usuario bloqueó el bot) y cómo volver a conectar: crea un código nuevo en los ajustes del formulario, abre el enlace del bot o añade el bot al grupo y envía /connect con ese código.
{
"event": "submission.created",
"form": { "id": "…", "name": "…" },
"submission": {
"id": "…",
"created_at": "2026-09-29T12:00:00.000Z",
"page_url": "https://example.com/",
"fields": { "name": "Lucía", "email": "lucia@example.es" },
"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);
}
Enlaces a archivos en webhooks
Cada archivo subido en el webhook recibe un download_url firmado que se abre sin iniciar sesión hasta que caduca. Cualquiera que tenga el enlace puede descargar el archivo, así que actívalo solo si el servicio que recibe tu webhook necesita los archivos. Desactivarlo, renovar el secreto del webhook o borrar el envío detiene los enlaces al instante.
Para activarlo, abre los ajustes del formulario, acepta archivos adjuntos y luego, en la sección de webhooks, elige 24 horas o 7 días en «Enlaces a archivos en webhooks» y guarda. Solo los webhooks enviados después llevan los enlaces.
"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"
}]
Desde entonces cada archivo de submission.attachments trae también download_url y download_expires_at. El servicio que recibe el webhook descarga el archivo con una petición GET normal, sin cabeceras ni inicio de sesión. Pasada la fecha de caducidad el enlace devuelve 404, y cada archivo se puede descargar hasta 60 veces por hora. Los correos, Telegram y los mensajes de Slack o Discord nunca reciben estos enlaces.
Slack y Discord
Pega en el campo del webhook una URL de webhook entrante de Slack (https://hooks.slack.com/services/…) o de webhook de un canal de Discord (https://discord.com/api/webhooks/…). Formgong enviará entonces, en lugar del JSON de arriba, un mensaje de chat breve con el nombre del formulario, las respuestas, la página y un enlace al envío.
Las menciones como @everyone, @here y @channel se neutralizan, un visitante no puede ocultar un enlace detrás de otro texto y los envíos largos se recortan a los límites de la plataforma con un enlace al envío completo. Los archivos aparecen por su nombre. La cabecera X-Signature se sigue enviando, los reintentos y el registro de entregas funcionan como en cualquier webhook, y «Enviar prueba» muestra cómo se ve el mensaje.
Los enlaces de flujos de trabajo de Slack (hooks.slack.com/triggers/…) y cualquier otra URL reciben el JSON.
Make, n8n, Zapier
Crea un módulo de webhook (Make), un Webhook node (n8n) o un Catch Hook (Zapier) y pega esa URL en los ajustes del formulario. Desde ahí asigna submission.fields.
Recetas paso a paso (en inglés): 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
No hay conector nativo. En n8n o Make, recibe el webhook de Formgong y llama a la API de KeyCRM con tu propia clave. Los campos están en submission.fields.