Formulare und Leads

Atlas-Formulare sammeln Anfragen auf Ihrer Website und machen aus jeder einen Lead, den Ihr Team zuweisen, nachverfolgen und exportieren kann. Formulare funktionieren auf Ihrer Development-Website und, sobald Production live ist, auf Ihrer Live-Website.

So funktioniert es

1. Erstellen Sie das Formular in Studio. Felder, Beschriftungen, Einwilligungstext, Beschriftung der Absenden-Schaltfläche und Erfolgsmeldung, unter Forms & leads.

2. Ihre Website rendert es. Sie ruft die Formulardefinition ab und zeichnet die Felder mit ihren eigenen Komponenten, sodass das Formular zu Ihrem Design passt.

3. Der Besucher sendet es ab. Der Browser sendet direkt an Atlas. Es ist kein Token beteiligt: Atlas akzeptiert nur Anfragen, deren Origin die registrierte Adresse Ihrer Website ist.

4. Atlas prüft und speichert es. Zuerst laufen die Spam- und Missbrauchsprüfungen, dann wird der Lead gespeichert, per E-Mail an Ihr Team gesendet und an Ihre Webhooks übergeben.

Development und die Live-Website

	Development-Website	Live-Website (Production)
Wann Formulare antworten	Immer	Wenn Production eingeschaltet ist und ein signiertes Release aktiv ist
Welche Formularversion	Der neueste veröffentlichte Entwurf	Die Version im aktiven Release
Akzeptierter Origin	Ihre Development-Adressen	Nur https:// Ihre Production-Domain
Wo Leads erscheinen	Leads → Development	Leads → Live website („Leads from the live website“)
Lead-E-Mails	Standardmäßig aus	Standardmäßig an; können pausiert werden

Formulare reisen wie Seiten in Releases nach Production. Ein Formular, das Sie in Development ändern, erreicht die Live-Website mit dem nächsten freigegebenen Release, und ein aus einem Release entferntes Formular antwortet dort nicht mehr.

Solange Production ausgeschaltet ist, antworten die Formularadressen mit 404 CP_NOT_FOUND. Ist Production eingeschaltet, aber noch kein signiertes Release aktiv, antworten sie mit 403 CP_PRODUCTION_LOCKED.

Das Formular rendern

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

Rendern Sie die fields mit Ihren eigenen Eingabefeldern. Ist challenge.provider gleich turnstile, rendern Sie das Cloudflare-Turnstile-Widget mit dem angegebenen siteKey und action und erlauben Sie Turnstile in Ihrer Content-Security-Policy.

Absenden

// 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": "…" }
}

Antwort	Bedeutung
201 { status: 'received' }	Angenommen. Zeigen Sie settings.successMessage an
422 SUBMISSION_INVALID	Ein Feld hat die Validierung nicht bestanden. Zeigen Sie die Feldfehler an
400 SUBMISSION_REJECTED	Abgelehnt, zum Beispiel wegen einer fehlgeschlagenen Challenge
429	Zu viele Einsendungen. Bitten Sie den Besucher, es später erneut zu versuchen

Verdächtige Einsendungen werden in Quarantäne gestellt, erhalten aber trotzdem ein 201, damit Angreifer nicht erfahren, was markiert wurde.

Schutz vor Spam und Missbrauch

• Cloudflare-Turnstile-Challenge, pro Site.
• Honeypot-Feld und Mindest-Ausfüllzeit.
• Erkennung von Duplikaten innerhalb von 10 Minuten.
• Ratenbegrenzungen pro Site, Formular, Besuchersitzung und IP-Adresse. Siehe Limits.

Der Tab Spam review in Studio zeigt Einsendungen aus Development, die in Quarantäne gestellt wurden. In Quarantäne gestellte Einsendungen der Live-Website lassen sich in Studio noch nicht prüfen.

Lead-E-Mails

Der Site-Inhaber fügt unter Integrations → Email eine E-Mail-Verbindung hinzu (SMTP oder ein E-Mail-Anbieter). Passwörter und API-Schlüssel werden verschlüsselt gespeichert und nie wieder angezeigt oder protokolliert.

Die Karte Email for enquiries and leads hat zwei Schalter:

• Live website: standardmäßig an, sobald Production live ist. Stellen Sie ihn auf „emails paused“, um E-Mails zu stoppen, ohne die Formulare anzufassen.
• Development: standardmäßig aus, damit Testeinsendungen niemanden anschreiben. Testeinsendungen sind mit [Test] gekennzeichnet.

Nur ein Site-Admin kann diese Schalter ändern. Automatische Antworten an Besucher sind aus, solange Sie sie nicht einschalten.

Was Sie als Nächstes lesen sollten

Mit Leads arbeitenLeads zuweisen, zusammenführen, exportieren und bereinigen und sie an Ihr CRM senden.Live gehenEin Release veröffentlichen und Production einschalten, damit Formulare echte Besucher beantworten.