Formulario de contacto para Next.js

Formgong team ·

Pega esto en Next.js. Los envíos van a Formgong. Sin base de datos y sin Resend.

250 envíos gratis al mes

Cómo funcionan los formularios en Next.js

En el App Router, la forma nativa de gestionar un formulario es mediante una acción de servidor o un controlador de ruta, que normalmente llama a una API de correo electrónico con una clave secreta. Eso requiere un entorno de ejecución en el servidor, y las acciones de servidor no son compatibles cuando exportas el sitio con output: 'export'.

Un componente de cliente que envía datos a https://formgong.com/submit no necesita nada de eso. Funciona en Vercel, en cualquier servidor Node y como exportación estática, y cada contacto se envía por correo electrónico y Telegram, con una copia en la bandeja de entrada de Formgong.

Configuración en Next.js

  1. Crea un formulario en Formgong y copia la clave de acceso.
  2. Añade el componente que aparece a continuación. Empieza por "use client" porque gestiona un evento del navegador.
  3. Sustituye la clave o léela de una variable de NEXT_PUBLIC_; solo esas llegan al código del navegador.
  4. Muestra el componente en tu página, ejecuta next dev y envía una prueba.
  5. ¿Prefieres un paquete? @formgong/react te ofrece un <ContactForm> ya listo, y el starter de Next.js en GitHub es un proyecto completo.
Next.js
"use client";
import { useState } from "react";

export function ContactForm() {
  const [status, setStatus] = useState("");
  async function onSubmit(event) {
    event.preventDefault();
    const fields = Object.fromEntries(new FormData(event.currentTarget));
    const response = await fetch("https://formgong.com/submit", {
      method: "POST",
      headers: { "Content-Type": "application/json", Accept: "application/json" },
      body: JSON.stringify({ _lang: "es", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Enviado. ¡Gracias!" : "No se pudo enviar. Inténtalo de nuevo."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Nombre <input name="name" placeholder="Tu nombre" required /></label>
      <label>Correo electrónico <input name="email" type="email" placeholder="tu@ejemplo.com" required /></label>
      <label>Mensaje <textarea name="message" placeholder="¿En qué podemos ayudarte?" required /></label>
      <div aria-hidden="true" style={{ position: "absolute", insetInlineStart: 0, top: 0, width: 1, height: 1, overflow: "hidden", clipPath: "inset(50%)" }}>
        <input name="botcheck" tabIndex={-1} autoComplete="off" />
      </div>
      <button type="submit">Enviar</button>
      <p role="status">{status}</p>
    </form>
  );
}

Plantilla lista en GitHub: github.com/formgong/nextjs-starter. Licencia MIT: pulsa «Use this template» o copia los archivos.

Proyecto nuevo con un comando: npm create formgong@latest -- --template nextjs (npm: create-formgong)

Paquete de componentes: npm install @formgong/next (npm: @formgong/next)

Añadir a un proyecto existente: npx formgong init (npm: formgong)

¿Formgong o una acción de servidor?

Escribe una «Acción de servidor» cuando el envío tenga que modificar tus datos o verificar a un usuario que haya iniciado sesión.

Usa Formgong para formularios de contacto, presupuestos y clientes potenciales: sin proveedor de correo electrónico, sin claves secretas y sin tener que gestionar el spam en tu código.

Preguntas y respuestas

¿Puedo usar una acción de servidor como intermediario para ocultar la clave?

Puedes hacerlo, pero no hay nada que ocultar: la clave es pública. Además, un proxy hace que cada envío parezca provenir de la IP de tu servidor, lo que atenúa los límites de frecuencia y las señales de spam.

¿Funciona con la exportación estática?

Sí. Un componente de cliente que envía datos a Formgong no necesita servidor, mientras que las acciones de servidor no son compatibles con la exportación estática.

¿Pages Router o App Router?

Ambos. En el «Pages Router», elimina la línea "use client"; el resto se mantiene igual.

¿Necesito Resend o una Server Action?

No, para un formulario de contacto. Resend exige un dominio verificado y registros DNS, y la clave de API se queda en el servidor. Escribe una Server Action cuando el envío deba cambiar tu base de datos o comprobar un usuario con sesión iniciada.

¿Cómo freno el spam en un formulario de Next.js?

Deja botcheck vacío. Formgong marca un honeypot relleno como spam y no lo envía por correo ni a Telegram. Turnstile es opcional. Añade el widget solo después de activarlo en los ajustes del formulario. El secreto se queda en Formgong.

Empezar gratis