Recibe las respuestas de formularios en Next.js, Node.js o Python
Guarda una copia firmada de cada respuesta de formulario en tu propia aplicación. Receptores listos para Next.js, Node.js, Python, Laravel y PHP, y las cuatro reglas si escribes el tuyo.
Muchos equipos quieren las respuestas de sus formularios en dos sitios: en Weesify, donde la persona se convierte en contacto y empiezan las automatizaciones, y en su propia aplicación, junto a sus clientes, pedidos o tickets. Hasta ahora Weesify ofrecía receptores para WordPress, PHP sencillo y Laravel. Esta versión añade Next.js, Node.js y Python, y Weesify ya reconoce esos sitios cuando los conectas.
Esta guía explica cómo conectar un sitio, elegir el receptor adecuado, qué debe comprobar el receptor y cómo pasar del almacenamiento de ejemplo a tu propia base de datos.
En esta guía
- Cómo funcionan las copias
- Conecta tu sitio
- Elige tu receptor
- Las cuatro reglas que sigue todo receptor
- De archivos JSON a tu base de datos
- Probar y ponerlo en marcha
- Otras formas de sacar las respuestas
Cómo funcionan las copias
Weesify siempre guarda primero cada respuesta. Cuando un formulario tiene activado Guardar una copia en este sitio, Weesify envía después una copia a tu sitio como una petición HTTPS firmada. Tu receptor comprueba la firma, guarda la copia una sola vez y responde que está guardada. Solo entonces Weesify da la copia por entregada.
Si tu sitio está caído o responde con un error, Weesify lo vuelve a intentar durante un día aproximadamente, con intervalos cada vez más largos. La pantalla Sitios web muestra las copias entregadas, en espera, en reintento y fallidas de cada sitio, para que siempre sepas cómo va todo.

Conecta tu sitio
- Ve a Formularios › Sitios web y pulsa Conectar un sitio.
- Escribe la dirección de tu sitio. Weesify mira su página pública, reconoce sitios WordPress, Laravel, Next.js, Node.js, Python y PHP sencillo, y sugiere la dirección de recepción adecuada, por ejemplo
/api/weesifypara Next.js. - Copia el secreto de firma. Se muestra una sola vez. Guárdalo en tu servidor como una variable de entorno llamada
WEESIFY_SECRET, nunca en una página web ni en tu repositorio. - Descarga el receptor de tu tecnología desde el mismo panel.
Si Weesify no puede saber cómo está hecho tu sitio, elige Mi propio servidor y escribe la dirección tú mismo. Sirve cualquier tecnología que pueda recibir un POST por HTTPS.
Elige tu receptor
Next.js (App Router). Guarda route.ts como app/api/weesify/route.ts. Funciona con el runtime de Node.js, lee el cuerpo sin procesar, comprueba la firma y responde en JSON. Tiene un lugar claramente marcado para tu llamada a la base de datos, con Prisma, Drizzle, Supabase o lo que ya uses.
Node.js. weesify-receiver.mjs necesita Node 18 o posterior y ningún paquete. Ejecútalo solo detrás de HTTPS, o móntalo en Express con app.post('/weesify/receive', weesifyExpress()). No pongas un analizador de cuerpo JSON en esa ruta: la firma se comprueba sobre los bytes exactos que envió Weesify.
Python. weesify_receiver.py usa solo la biblioteca estándar, Python 3.8 o posterior. Ejecútalo solo, o llama a su función handle() desde una ruta de Flask o una vista de Django. En Django, marca la vista con @csrf_exempt: lo que la protege es la firma.
Laravel. WeesifyFormCopyController.php va en app/Http/Controllers, con una ruta en routes/api.php y una pequeña tabla para las copias. El archivo muestra ambas cosas.
PHP. weesify-receiver.php funciona en cualquier alojamiento con PHP 7.4+, incluido el compartido. Súbelo y pon el secreto.
Cada archivo se explica al principio, para que puedas leer exactamente lo que hace antes de que se acerque a tu servidor.
Las cuatro reglas que sigue todo receptor
Si prefieres escribir el tuyo, esto es lo único que tiene que hacer.
1. Comprobar la firma. Cada petición tiene dos cabeceras: X-Weesify-Timestamp (en segundos) y X-Weesify-Signature, que es v1= seguido del HMAC-SHA256 en hexadecimal de timestamp.body con tu secreto. Calcula el mismo valor a partir del cuerpo sin procesar y compáralo en tiempo constante.
2. Rechazar peticiones antiguas. Si la marca de tiempo se aleja más de cinco minutos del reloj de tu servidor, responde 401. Así nadie puede reenviar más tarde una petición capturada.
3. Responder a los ping. Cuando pulsas Probar en Weesify, envía {"event": "ping"}. Responde {"ok": true}.
4. Guardar cada copia una sola vez. Una copia real tiene "event": "submission.copy" y una idempotency_key. Guárdala si no has visto esa clave y responde {"stored": true}; si ya la has visto, responde {"duplicate": true}. Los reintentos usan la misma clave, así que una copia que llega dos veces se guarda una.
Cualquier respuesta que no sea un 2xx con stored o duplicate se trata como «inténtalo más tarde». Es a propósito: si tu base de datos cae un momento, responder 500 hace que Weesify mantenga la copia en espera en lugar de perderla.
Probamos estas reglas con nuestros propios receptores en cada versión: el firmante de Weesify genera una petición real, los archivos de Node.js y Python se ejecutan como lo harían en tu servidor, y las comprobaciones anteriores deben cumplirse, incluido el rechazo de una marca de tiempo caducada.
De archivos JSON a tu base de datos
Los receptores de PHP, Node.js y Python guardan cada copia como un archivo JSON en una carpeta privada, para que funcionen en cuanto los subes. Eso basta para una prueba o un sitio con poco volumen. Para algo real, cambia la función store() para que escriba una fila en tu base de datos:
- usa
idempotency_keycomo columna única, para que la propia base rechace los duplicados; - guarda
submission.id, la referencia al original en Weesify; - guarda
answerscomo JSON, o lleva las preguntas que te importan a sus propias columnas; filesenumera los archivos subidos con su nombre y una dirección de descarga.
El receptor de Next.js trae un conjunto en memoria en lugar de archivos, porque la mayoría de alojamientos de Next.js no tienen disco permanente. Está claramente marcado como no duradero, con un ejemplo comentado de la llamada a la base de datos que lo sustituye.
Probar y ponerlo en marcha
- Despliega el receptor con
WEESIFY_SECRETconfigurado. - En Formularios › Sitios web, pulsa Probar. Un «conectado» en verde significa que la firma, el reloj y el ping funcionan.
- Abre un formulario, ve a Copias y activa Guardar una copia en este sitio para tu sitio.
- Envía el formulario una vez y mira cómo la copia aparece como entregada.
Si la prueba falla, el mensaje explica por qué con palabras sencillas: no se pudo llegar a la dirección, la respuesta no era JSON o la firma no coincidía (normalmente un secreto pegado con un espacio de más, o un analizador de cuerpo que cambia los bytes).
Otras formas de sacar las respuestas
Las copias a tu servidor son una de varias vías, y puedes usar más de una a la vez:
- Apps. Google Sheets, Airtable, Notion, HubSpot y Salesforce, cada una con su propio inicio de sesión, desde la misma pantalla Sitios web.
- Webhooks y la API. Cada respuesta es un evento que puedes enviar a cualquier sitio, y la API lee formularios y respuestas. Nuestro artículo sobre la API y la CLI de Weesify explica ambas.
- Asistentes de IA. El servidor MCP de Weesify permite que un asistente que uses lea tus formularios y respuestas y cree borradores de formularios, con un token que tú controlas.

Elijas la vía que elijas, Weesify guarda el original, así que puedes desactivar un destino, arreglarlo y volver a activarlo sin perder ni una respuesta.
Recibe nuevas entradas por correo
Artículos nuevos de Blog de Weesify, directamente en tu bandeja de entrada. Sin spam; puedes darte de baja cuando quieras.
Al suscribirte aceptas recibir correos de Blog de Weesify. Puedes darte de baja cuando quieras.
Comentarios
Aún no hay comentarios. Empieza la conversación.