Moduli e contatti commerciali

I moduli di Atlas raccolgono le richieste sul Suo sito web e trasformano ciascuna in un contatto commerciale (lead) che il Suo team può assegnare, seguire ed esportare. I moduli funzionano sul Suo sito web di Sviluppo e, una volta online la Produzione, sul Suo sito web online.

Come funziona

1. Crei il modulo in Studio. Campi, etichette, testo del consenso, etichetta di invio e messaggio di conferma, in Forms & leads.

2. Il Suo sito web lo mostra. Recupera la definizione del modulo e disegna i campi con i propri componenti, così il modulo si adatta al Suo design.

3. Il visitatore invia il modulo. Il browser invia i dati direttamente ad Atlas. Non è coinvolto alcun token: Atlas accetta solo richieste il cui Origin è l’indirizzo registrato del Suo sito web.

4. Atlas controlla e archivia. Prima vengono eseguiti i controlli anti-spam e anti-abuso, poi il contatto viene salvato, inviato per email al Suo team e trasmesso ai Suoi webhook.

Sviluppo e sito web online

	Sito web di Sviluppo	Sito web online (Produzione)
Quando i moduli rispondono	Sempre	Quando la Produzione è attiva e un rilascio firmato è online
Quale versione del modulo	L’ultima bozza pubblicata	La versione contenuta nel rilascio online
Origine accettata	I Suoi indirizzi di Sviluppo	Solo https:// il Suo dominio di Produzione
Dove compaiono i contatti	Leads → Development	Leads → Live website (“Leads from the live website”)
Email dei contatti	Disattivate per impostazione predefinita	Attive per impostazione predefinita; possono essere sospese

I moduli arrivano in Produzione all’interno dei rilasci, esattamente come le pagine. Un modulo modificato in Sviluppo raggiunge il sito web online con il successivo rilascio approvato, e un modulo rimosso da un rilascio smette di rispondere lì.

Finché la Produzione è disattivata, gli indirizzi dei suoi moduli rispondono 404 CP_NOT_FOUND. Se la Produzione è attiva ma non c’è ancora un rilascio firmato online, rispondono 403 CP_PRODUCTION_LOCKED.

Mostrare il modulo

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

Mostri i fields con i Suoi campi di input. Se challenge.provider è turnstile, mostri il widget Cloudflare Turnstile con siteKey e action indicati e consenta Turnstile nella Sua Content-Security-Policy.

Inviare

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

Risposta	Significato
201 { status: 'received' }	Accettato. Mostri settings.successMessage
422 SUBMISSION_INVALID	Un campo non ha superato la convalida. Mostri gli errori dei campi
400 SUBMISSION_REJECTED	Rifiutato, per esempio per una verifica non superata
429	Troppi invii. Chieda al visitatore di riprovare più tardi

Gli invii sospetti vengono messi in quarantena ma ricevono comunque un 201, così chi attacca non può sapere che cosa è stato segnalato.

Protezione da spam e abusi

• Verifica Turnstile di Cloudflare, per sito.
• Campo honeypot e tempo minimo di compilazione.
• Rilevamento dei duplicati entro 10 minuti.
• Limiti di frequenza per sito, modulo, sessione del visitatore e indirizzo IP. Vedere Limiti.

La scheda Spam review in Studio mostra gli invii in quarantena provenienti dallo Sviluppo. Gli invii in quarantena provenienti dal sito web online non possono ancora essere esaminati in Studio.

Email dei contatti commerciali

Il proprietario del sito aggiunge una connessione email (SMTP o un provider di posta) in Integrations → Email. Password e chiavi API vengono archiviate cifrate e non vengono mai più mostrate né registrate nei log.

La scheda Email for enquiries and leads ha due interruttori:

• Live website: attivo per impostazione predefinita una volta online la Produzione. Lo imposti su “emails paused” per fermare le email senza toccare i moduli.
• Development: disattivato per impostazione predefinita, così gli invii di prova non inviano email a nessuno. Gli invii di prova sono contrassegnati con [Test].

Solo un amministratore del sito può modificare questi interruttori. Le risposte automatiche ai visitatori sono disattivate, salvo che le attivi.

Cosa leggere dopo

Gestire i contatti commercialiAssegni, unisca, esporti e ripulisca i contatti e li invii al Suo CRM.Messa onlinePubblichi un rilascio e attivi la Produzione, così i moduli rispondono ai visitatori reali.