Formulário de contacto para Next.js

Formgong team ·

Cole isto no Next.js. Os envios vão para o Formgong. Sem base de dados e sem Resend.

250 envios grátis por mês

Como funcionam os formulários em Next.js

No App Router, a forma nativa de gerir um formulário é através de uma Ação de Servidor ou de um manipulador de rota, que normalmente invoca uma API de e-mail com uma chave secreta. Isso requer um ambiente de execução de servidor, e as Ações de Servidor não são suportadas quando exporta o site com o output: 'export'.

Um componente cliente que envia dados para https://formgong.com/submit não necessita de nada disso. Funciona no Vercel, em qualquer servidor Node e como exportação estática, e cada lead é enviado por e-mail e pelo Telegram, com uma cópia na caixa de entrada do Formgong.

Configuração em Next.js

  1. Crie um formulário no Formgong e copie a chave de acesso.
  2. Adicione o componente abaixo. Este começa com "use client", uma vez que lida com um evento do navegador.
  3. Substitua a chave ou leia-a a partir de uma variável NEXT_PUBLIC_; apenas essas variáveis chegam ao código do navegador.
  4. Renderize o componente na sua página, aceda a next dev e envie um teste.
  5. Prefere um pacote? O @formgong/react oferece-lhe um <ContactForm> pronto a usar, e o starter do Next.js no GitHub é um projeto 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: "pt", ...fields, access_key: "fk_your_access_key" }),
    });
    const result = await response.json();
    setStatus(result.message || (result.success ? "Enviado. Obrigado!" : "Não foi possível enviar. Tente novamente."));
  }

  return (
    <form onSubmit={onSubmit}>
      <label>Nome <input name="name" placeholder="O seu nome" required /></label>
      <label>E-mail <input name="email" type="email" placeholder="voce@exemplo.com" required /></label>
      <label>Mensagem <textarea name="message" placeholder="Como podemos ajudar?" 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>
  );
}

Starter pronto no GitHub: github.com/formgong/nextjs-starter. Licença MIT: clique em “Use this template” ou copie os arquivos.

Projeto novo com um comando: npm create formgong@latest -- --template nextjs (npm: create-formgong)

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

Adicionar a um projeto existente: npx formgong init (npm: formgong)

Formgong ou de uma ação do servidor?

Escreva uma «Ação do Servidor» quando o envio tiver de alterar os seus dados ou verificar um utilizador com sessão iniciada.

Utilize o Formgong para formulários de contacto, orçamentos e leads: sem fornecedor de e-mail, sem segredos e sem gestão de spam no seu código-fonte.

Perguntas e respostas

Posso utilizar uma ação de servidor como proxy para ocultar a chave?

Pode fazê-lo, mas não há nada a ocultar: a chave é pública. Um proxy também faz com que cada envio pareça provir do IP do seu servidor, o que enfraquece os limites de taxa e os sinais de spam.

Funciona com a exportação estática?

Sim. Um componente cliente que envia dados para o Formgong não necessita de servidor, enquanto as Ações de Servidor não são suportadas na exportação estática.

Router de Páginas ou Router de Aplicações?

Ambos. No «Pages Router», elimine a linha "use client"; o resto permanece inalterado.

Preciso do Resend ou de uma Server Action?

Não, para um formulário de contacto. O Resend exige um domínio verificado e registos DNS, e a chave da API fica no servidor. Escreva uma Server Action quando o envio tiver de alterar a sua base de dados ou verificar um utilizador com sessão iniciada.

Como paro o spam num formulário Next.js?

Deixe botcheck vazio. O Formgong marca um honeypot preenchido como spam e não o envia por e-mail nem para o Telegram. O Turnstile é opcional. Adicione o widget só depois de o ligar nas definições do formulário. O segredo fica no Formgong.

Começar grátis