Formulaires et leads

Créez des formulaires dans Studio, affichez-les sur votre site web, bloquez le spam avec Turnstile et recevez chaque demande sous forme de lead.

Cette page a été traduite de l'anglais. En cas de divergence, la version anglaise fait foi. Lire en anglais

Les formulaires Atlas collectent les demandes sur votre site web et transforment chacune d’elles en lead que votre équipe peut attribuer, suivre et exporter. Les formulaires fonctionnent sur votre site web Development et, une fois Production en ligne, sur votre site web live.

Comment cela fonctionne

Créez le formulaire dans Studio. Champs, libellés, texte de consentement, libellé du bouton d’envoi et message de succès, sous Forms & leads.
Votre site web l’affiche. Il récupère la définition du formulaire et dessine les champs avec ses propres composants, de sorte que le formulaire s’accorde à votre design.
Le visiteur l’envoie. Le navigateur envoie les données directement à Atlas. Aucun jeton n’intervient : Atlas n’accepte que les requêtes dont l’Origin est l’adresse enregistrée de votre site web.
Atlas vérifie et stocke. Les contrôles anti-spam et anti-abus s’exécutent d’abord, puis le lead est enregistré, envoyé par e-mail à votre équipe et transmis à vos webhooks.

Development et site web live

	Site web Development	Site web live (Production)
Quand les formulaires répondent	Toujours	Lorsque Production est activé et qu’une release signée est live
Quelle version du formulaire	Le dernier brouillon publié	La version contenue dans la release live
Origine acceptée	Vos adresses Development	Uniquement `https://` votre domaine de Production
Où apparaissent les leads	Leads → Development	Leads → Live website (« Leads from the live website »)
E-mails de leads	Désactivés par défaut	Activés par défaut ; peuvent être suspendus

Les formulaires passent en Production à l’intérieur des releases, comme les pages. Un formulaire modifié dans Development atteint le site web live avec la prochaine release approuvée, et un formulaire retiré d’une release cesse d’y répondre.

Tant que Production est désactivé, les adresses de ses formulaires répondent 404 CP_NOT_FOUND. Si Production est activé mais qu’aucune release signée n’est encore live, elles répondent 403 CP_PRODUCTION_LOCKED.

Afficher le formulaire

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

Affichez les fields avec vos propres champs de saisie. Si challenge.provider vaut turnstile, affichez le widget Cloudflare Turnstile avec les siteKey et action fournis, et autorisez Turnstile dans votre Content-Security-Policy.

Envoyer

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

Réponse	Signification
`201 { status: 'received' }`	Accepté. Affichez `settings.successMessage`
`422 SUBMISSION_INVALID`	Un champ n’a pas passé la validation. Affichez les erreurs de champ
`400 SUBMISSION_REJECTED`	Rejeté, par exemple après l’échec d’un défi
`429`	Trop d’envois. Demandez au visiteur de réessayer plus tard

Les envois suspects sont placés en quarantaine mais reçoivent tout de même un 201, afin que les attaquants ne puissent pas savoir ce qui a été signalé.

Protection contre le spam et les abus

Défi Cloudflare Turnstile, par site.
Champ pot de miel (honeypot) et durée minimale de remplissage.
Détection des doublons sur 10 minutes.
Limites de débit par site, formulaire, session de visiteur et adresse IP. Voir Limites.

L’onglet Spam review de Studio affiche les envois mis en quarantaine depuis Development. Les envois mis en quarantaine depuis le site web live ne peuvent pas encore être examinés dans Studio.

E-mails de leads

Le propriétaire du site ajoute une connexion e-mail (SMTP ou fournisseur d’e-mail) sous Integrations → Email. Les mots de passe et clés d’API sont stockés chiffrés et ne sont plus jamais affichés ni journalisés.

La carte Email for enquiries and leads comporte deux interrupteurs :

Live website : activé par défaut dès que Production est en ligne. Réglez-le sur « emails paused » pour arrêter les e-mails sans toucher aux formulaires.
Development : désactivé par défaut, afin que les envois de test n’envoient d’e-mail à personne. Les envois de test sont marqués [Test].

Seul un administrateur du site peut modifier ces interrupteurs. Les réponses automatiques aux visiteurs sont désactivées, sauf si vous les activez.