Clase 01 · Módulo 07
Cómo funciona un formulario de punta a punta
Cómo funciona un formulario de punta a punta
Qué logras en esta clase
Sabes qué pasa entre el clic en «Enviar» y el mensaje que llega a tus manos, y eliges cómo recibirlo.
- Reconoces las partes de un formulario y qué viaja al enviarlo.
- Comparas tres formas de recibir un envío.
- Conoces la pieza de Astro que usarás en el resto del módulo.
02
Un formulario no envía nada solo
El HTML dibuja los campos y el botón. Alguien tiene que recibir los datos al otro lado, y esa parte la decides tú.
03
Las partes que ves en el código
<form method="POST">
<label for="email">Tu correo</label>
<input id="email" name="email" type="email" required />
<button>Enviar</button>
</form>formagrupa los campos y define a dónde y cómo se envían.labeles el texto que nombra cada campo.namees la etiqueta con que viaja el dato.typele dice al navegador qué clase de dato espera.
04
Qué viaja cuando alguien envía
El navegador arma una lista de pares: el name de cada campo y lo que la persona escribió. Esa lista sale en una petición POST, el tipo de petición HTTP que se usa para entregar datos.
05
El recorrido completo
La función de servidor es código que vive en tu alojamiento y corre solo cuando la llaman, como viste en el módulo 1. Cada paso de la segunda fila tiene su propia clase en este módulo.
06
Por qué no hacerlo todo en el navegador
Guardar en una base de datos y enviar un correo exigen claves. El código que corre en el navegador se descarga completo al computador de quien visita.
- Una clave puesta ahí queda a la vista.
- Una comprobación hecha ahí se puede saltar.
Por eso el formulario necesita una parte que corra en el servidor.
07
El navegador es territorio ajeno
Todo lo que se ejecuta en el navegador lo puede leer y modificar quien visita tu web. Lo delicado va al servidor.
08
Cuando basta un enlace a WhatsApp
Si tu acción principal es conversar, quizá no necesitas formulario. Un enlace con esta forma abre el chat con tu número:
https://wa.me/56912345678?text=Hola,%20quiero%20cotizarEl número va con código de país, sin signos ni espacios. El texto inicial es opcional.
Lo bueno: cero código de servidor. Lo malo: no queda registro en tu base y dependes de responder rápido.
09
Tres formas de recibir un envío
| Opción | Cuándo conviene | Límite |
|---|---|---|
| Función propia + base de datos + correo | Quieres tus datos y control total | Más piezas que mantener |
| Función propia + solo correo | Web chica, basta el aviso | Si el correo falla, el mensaje se pierde |
| Servicio de formularios de terceros | No quieres código de servidor | Tus contactos viven en otra empresa |
10
Cómo elegir entre las tres
- ¿Perder un mensaje te cuesta un cliente? Entonces guárdalo en una base de datos.
- ¿Vas a tener más de un formulario o quieres medir cuántos llegan? Base de datos.
- ¿Es una web personal con dos mensajes al mes? Solo correo puede bastar.
- ¿Nadie mantendrá código? Un servicio de terceros, revisando los límites de su plan gratis.
11
La opción que construye este curso
Función propia, con los mensajes guardados en Supabase y un aviso por Resend. Supabase es un servicio de base de datos y Resend uno de envío de correos; cada uno tiene su clase.
Lo bueno: nada se pierde y todo queda en tus cuentas. Lo malo: son tres piezas que debes entender y vigilar. Para un negocio que vive de sus contactos, vale la pena.
12
Actions: la función de servidor en Astro
Astro trae una herramienta para esto llamada actions. Una action es una función de servidor con nombre que:
- Se define en el archivo
src/actions/index.ts. - Declara qué datos espera recibir.
- Rechaza sola lo que no cumple, antes de ejecutar tu lógica.
- Se puede llamar desde un formulario HTML o desde un script.
13
Cómo se ve una action
import { defineAction } from "astro:actions";
import { z } from "astro/zod";
export const server = {
contacto: defineAction({
accept: "form",
input: z.object({ email: z.email(), mensaje: z.string() }),
handler: async ({ email, mensaje }) => {
// guardar y avisar
},
}),
};No tienes que escribirla: Claude lo hace. Te basta leerla. accept: "form" indica que recibe un formulario, input describe los datos válidos y handler es lo que se ejecuta.
14
Lo que el proyecto necesita para usarlas
Tu sitio es estático por defecto. Para que una parte corra en el servidor hacen falta dos cosas:
- Un adaptador, la pieza que conecta Astro con tu alojamiento. Para Cloudflare se agrega con
npx astro add cloudflare. - Que la página del formulario se resuelva en el servidor, con la línea
export const prerender = false.
El resto del sitio sigue siendo estático.
15
Qué alojamiento supone el adaptador
Agregar el adaptador no publica nada. Solo deja el proyecto preparado para tener funciones de servidor.
16
Los cuatro estados del formulario
| Estado | Qué ve la persona |
|---|---|
| Vacío | Campos claros y un botón que dice qué hace |
| Enviando | Botón desactivado y señal de espera |
| Éxito | Confirmación de que el mensaje llegó |
| Error | Qué falló y cómo corregirlo, sin borrar lo escrito |
Claude suele construir el primero y el tercero. Pide los cuatro.
17
Guardar primero, avisar después
Si el correo falla pero el mensaje quedó guardado, no perdiste al cliente. El orden de los pasos importa.
18
Pide solo lo que vas a usar
- Nombre, correo y mensaje alcanzan para la mayoría de los contactos.
- El teléfono solo si de verdad vas a llamar.
- Cada campo extra es una razón más para no terminar.
19
Un formulario que todos pueden usar
Lo que viste en el módulo 5 sobre accesibilidad aplica entero aquí:
- Cada campo con su
labelvisible. - El
typecorrecto:emailabre el teclado adecuado en el celular. - Errores escritos en texto, no solo un borde rojo.
- Todo se puede completar y enviar usando el teclado.
20
Cómo pedírselo a Claude
| Pedido vago | Pedido que funciona |
|---|---|
| «Hazme un formulario de contacto» | Campos, action que valida, los cuatro estados y qué pasa en cada falla |
21
Dos errores que se repiten
El segundo: dar por bueno el mensaje de éxito. Que la pantalla diga «enviado» no prueba nada. La prueba es ver la fila en la base de datos y el correo en tu bandeja.
22
Lo que te llevas
- Un formulario son campos con
nameque viajan porPOSTa algo que los recibe. - Lo que usa claves o debe ser confiable corre en el servidor, nunca en el navegador.
- Entre las tres formas de recibirlo, eliges según cuánto cuesta perder un mensaje.
- En Astro la función de servidor es una action y requiere adaptador.
- El orden es validar, frenar bots, guardar y recién entonces avisar.
23
Hazlo ahora
En 10 minutos, en papel o en un archivo de notas:
- Escribe los campos de tu formulario y, al lado de cada uno, para qué usarás ese dato.
- Borra los que no tengan respuesta.
- Elige una de las tres formas de recibirlo y anota por qué.
- Dibuja el recorrido de tu envío con sus pasos.
- Escribe el texto de tus cuatro estados.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026
- Astro Docs: Actionsdocs.astro.build ↗
- Astro Docs: renderizado bajo demanda y adaptadoresdocs.astro.build ↗
- Astro Docs: adaptador de Cloudflaredocs.astro.build ↗
- MDN Web Docs: aprende desarrollo web (formularios HTML)developer.mozilla.org ↗
- WhatsApp: cómo usar la función de clic para chatearwhatsapp.com ↗