Formularios y clientes potenciales

Los formularios de Atlas recogen las consultas de su sitio web y convierten cada una en un cliente potencial (lead) que su equipo puede asignar, seguir y exportar. Los formularios funcionan en su sitio web de Desarrollo y, una vez que Producción está en vivo, en su sitio web en vivo.

Cómo funciona

1. Cree el formulario en Studio. Campos, etiquetas, texto de consentimiento, etiqueta del botón de envío y mensaje de éxito, en Forms & leads.

2. Su sitio web lo muestra. Obtiene la definición del formulario y dibuja los campos con sus propios componentes, de modo que el formulario coincide con su diseño.

3. El visitante lo envía. El navegador envía los datos directamente a Atlas. No interviene ningún token: Atlas solo acepta solicitudes cuyo Origin sea la dirección registrada de su sitio web.

4. Atlas lo comprueba y lo almacena. Primero se ejecutan las comprobaciones de spam y abuso; después el cliente potencial se guarda, se envía por correo a su equipo y se envía a sus webhooks.

Desarrollo y el sitio web en vivo

	Sitio web de Desarrollo	Sitio web en vivo (Producción)
Cuándo responden los formularios	Siempre	Cuando Producción está activada y hay un lanzamiento firmado en vivo
Qué versión del formulario	El último borrador publicado	La versión incluida en el lanzamiento en vivo
Origen aceptado	Sus direcciones de Desarrollo	Solo https:// su dominio de Producción
Dónde aparecen los clientes potenciales	Leads → Development	Leads → Live website (“Leads from the live website”)
Correos de clientes potenciales	Desactivados de forma predeterminada	Activados de forma predeterminada; pueden pausarse

Los formularios viajan a Producción dentro de los lanzamientos, igual que las páginas. Un formulario que cambie en Desarrollo llega al sitio web en vivo con el siguiente lanzamiento aprobado, y un formulario eliminado de un lanzamiento deja de responder allí.

Mientras Producción está desactivada, las direcciones de sus formularios responden 404 CP_NOT_FOUND. Si Producción está activada pero todavía no hay un lanzamiento firmado en vivo, responden 403 CP_PRODUCTION_LOCKED.

Muestre el formulario

// GET /v1/public/environments/{environmentId}/forms/{formKey}
// → { key, name, version, fields, settings: { submitLabel, successMessage, consentText },
//     challenge: { provider: 'turnstile', action, siteKey } }

Muestre los fields con sus propios campos de entrada. Si challenge.provider es turnstile, muestre el widget de Cloudflare Turnstile con el siteKey y la action indicados, y permita Turnstile en su Content-Security-Policy.

Envío

// POST /v1/public/environments/{environmentId}/forms/{formKey}/submissions
{
  "idempotencyKey": "<new UUID per attempt>",
  "sessionId": "<16–128 chars, A–Z a–z 0–9 _ ->",
  "startedAt": 1761210000000,       // when the visitor opened the form, in ms
  "challengeToken": "<Turnstile token>",
  "website": "",                    // hidden honeypot field; leave empty
  "consent": true,
  "fields": { "name": "…", "email": "…", "message": "…" }
}

Respuesta	Significado
201 { status: 'received' }	Aceptado. Muestre settings.successMessage
422 SUBMISSION_INVALID	Un campo no superó la validación. Muestre los errores de los campos
400 SUBMISSION_REJECTED	Rechazado, por ejemplo por un desafío fallido
429	Demasiados envíos. Pida al visitante que lo intente de nuevo más tarde

Los envíos sospechosos se ponen en cuarentena pero igualmente reciben un 201, de modo que los atacantes no pueden saber qué se marcó.

Protección contra spam y abuso

• Desafío Turnstile de Cloudflare, por sitio.
• Campo trampa (honeypot) y tiempo mínimo de relleno.
• Detección de duplicados en un plazo de 10 minutos.
• Límites de frecuencia por sitio, formulario, sesión de visitante y dirección IP. Consulte Límites.

La pestaña Spam review de Studio muestra los envíos en cuarentena de Desarrollo. Los envíos en cuarentena del sitio web en vivo todavía no pueden revisarse en Studio.

Correos de clientes potenciales

El propietario del sitio añade una conexión de correo (SMTP o un proveedor de correo) en Integrations → Email. Las contraseñas y las claves de API se almacenan cifradas y nunca se vuelven a mostrar ni se registran.

La tarjeta Email for enquiries and leads tiene dos interruptores:

• Live website: activado de forma predeterminada una vez que Producción está en vivo. Póngalo en “emails paused” para detener los correos sin tocar los formularios.
• Development: desactivado de forma predeterminada, de modo que los envíos de prueba no envían correos a nadie. Los envíos de prueba se marcan como [Test].

Solo un administrador del sitio puede cambiar estos interruptores. Las respuestas automáticas a los visitantes están desactivadas a menos que usted las active.

Qué leer a continuación

Trabajar con clientes potencialesAsigne, fusione, exporte y depure clientes potenciales, y envíelos a su CRM.Salir en vivoPublique un lanzamiento y active Producción para que los formularios respondan a visitantes reales.