Indice della guida
Il messaggio del visitatore “il form non funziona” può descrivere problemi diversi. Riprodurre il comportamento in modo ordinato permette di distinguere un campo troppo restrittivo da un blocco del server e di verificare se la correzione risolve davvero l’invio.
Descrivi il blocco prima di cambiare impostazioni
Osserva la pagina dal primo caricamento fino al tentativo di invio. Il pulsante è disattivato già prima della compilazione? Il browser evidenzia un campo? Compare un messaggio sotto il modulo? Il caricamento parte e continua senza fine? Questi dettagli orientano verso controlli diversi.
Salva il testo esatto dell’errore, senza includere dati dei clienti. Annota anche se il difetto interessa tutti i moduli o soltanto una pagina. Un problema comparso dopo una modifica al sito è un’informazione utile, ma non prova da solo che quella modifica sia la causa.
Se compare la conferma e il problema è soltanto la casella vuota, prosegui nella guida alle email del modulo che non arrivano. La diagnosi deve seguire il punto in cui il percorso si interrompe.
Ripeti una prova minima con dati riconoscibili
Usa la pagina pubblica senza essere collegato al pannello amministrativo. Compila con un nome di prova, una casella che controlli e un testo breve, per esempio “PROVA INVIO SITO 01”. Avvisa chi riceve i contatti, così il messaggio non viene trattato come una richiesta commerciale.
- Ricarica la pagina e compila soltanto i campi necessari.
- Lascia vuoti i campi facoltativi e non aggiungere allegati.
- Completa l’eventuale controllo antispam e premi Invia una sola volta.
- Annota esito, ora, browser e dispositivo.
Se questa prova riesce, aggiungi una condizione alla volta: allegato, scelta di un servizio, campo facoltativo. Se invece non riesce, non cambiare contemporaneamente plugin, destinatario e configurazione email: perderesti la possibilità di collegare il risultato a una singola correzione.
Controlla i campi obbligatori e i messaggi di errore
La validazione dei moduli HTML può impedire l’invio quando manca un valore richiesto o il formato non è accettato. Il controllo nel browser non sostituisce quello del server: una compilazione può superare il primo ed essere respinta dal secondo.
Verifica che l’errore sia visibile accanto al campo e comprensibile. Un campo nascosto, una scelta condizionata che non appare o una casella obbligatoria sotto un elemento sovrapposto possono impedire al visitatore di completare il percorso.
Prova nomi con apostrofi, numeri telefonici con prefisso e indirizzi email validi ma più lunghi del solito. Le regole devono accettare i dati realmente necessari all’attività. Se un numero corretto viene rifiutato, fai correggere la regola; non chiedere ai clienti di inserire informazioni false per aggirarla.
Verifica il CAPTCHA senza eliminare tutte le protezioni
Controlla se il componente antispam viene caricato, se mostra errori di configurazione e se il tentativo arriva alla sua conclusione. Una prova immediata e una prova lasciata aperta per alcuni minuti possono aiutare a riconoscere un problema di scadenza del controllo.
Nelle integrazioni reCAPTCHA descritte dalla documentazione di verifica Google, il token ha durata di due minuti ed è utilizzabile una sola volta. Se viene riutilizzato o verificato troppo tardi, il sito deve gestire la situazione e permettere un nuovo tentativo. Questi dettagli riguardano quella specifica integrazione: altri sistemi antispam hanno regole proprie.
Chiedi al tecnico di verificare versione utilizzata, chiavi, dominio autorizzato e risposta del servizio. Se il consenso o un blocco degli script interferiscono, va corretta l’integrazione. Disattivare permanentemente l’antispam senza aver individuato la causa può trasformare un guasto in un flusso di richieste indesiderate.
Prova il percorso da smartphone e controlla gli allegati
Apri la pagina sul telefono, compila con la tastiera visibile e verifica che il pulsante sia raggiungibile. Un banner, un menu o un elemento sovrapposto può coprire il comando senza impedire il resto della navigazione. Controlla anche i messaggi sopra il modulo: il visitatore potrebbe non accorgersi che la pagina ha segnalato un errore fuori dallo schermo.
Confronta browser e rete mobile con una prova da computer. Se il problema compare soltanto in un browser integrato in un’altra applicazione, annotalo e ripeti nel browser normale. Questa differenza è un indizio da consegnare al tecnico, non una soluzione da imporre stabilmente a tutti i clienti.
Se l’invio si blocca solo con allegati, confronta dimensione, formato e quantità ammessi. Il limite dell’interfaccia deve essere coerente con quello del server. Una foto scattata dal telefono può essere molto più pesante del file usato nel primo collaudo.
Fai verificare richiesta, risposta e registri del sito
Quando il caricamento resta fermo, il tecnico deve controllare se la richiesta parte dal browser, quale risposta restituisce il server e quale componente la elabora. Gli errori JavaScript, una protezione del sito o un servizio non disponibile possono interrompere passaggi differenti.
Un codice HTTP è un indizio: una risposta 403 può richiedere controlli sulle regole di accesso o di sicurezza; una 500 richiede di esaminare l’errore del server. Anche una risposta 200 non dimostra da sola che la richiesta sia stata salvata e notificata. Occorre leggere l’esito applicativo.
Per i siti che usano Contact Form 7, la documentazione sul messaggio di errore aiuta a distinguere alcuni esiti del componente. Non applicare automaticamente quei significati a moduli di piattaforme diverse. Condividi registri privi di password, token e contenuti personali.
Concludi il collaudo con una richiesta realmente ricevuta
Dopo la correzione ripeti la stessa prova che falliva e aggiungi un secondo controllo da telefono. Verifica il percorso completo: invio, conferma, eventuale salvataggio e ricezione da parte dell’azienda. Se arriva solo la risposta automatica al visitatore, la notifica interna resta da controllare.
Prova anche un errore volontario, come un campo obbligatorio vuoto. Il sito deve spiegare come correggerlo e consentire un nuovo tentativo senza costringere a riscrivere inutilmente tutto il messaggio. Un clic ripetuto non dovrebbe generare richieste duplicate.
Infine controlla che le statistiche misurino l’esito previsto. Contare il clic su Invia come richiesta riuscita può nascondere il guasto: approfondisci come misurare le richieste di preventivo con GA4. Mantieni disponibile un recapito alternativo leggibile, così chi incontra un problema può comunque contattare l’attività.
Fonti ufficiali e approfondimenti
Consulta la documentazione ufficiale per verificare requisiti e funzioni applicabili al tuo caso.
Domande frequenti
Perché il pulsante Invia non fa nulla?
Può esserci un campo non valido, un controllo antispam incompleto, un errore dello script o un elemento che copre il pulsante. Osserva il comportamento e ripeti una prova minima prima di modificare la configurazione.
Perché il modulo funziona dal computer ma non dal telefono?
Confronta layout, browser, tastiera, banner, rete e allegati. Un errore presente solo su un dispositivo va riprodotto nella stessa situazione, conservando pagina, browser ed esito della prova.
Conviene togliere il CAPTCHA?
Prima verifica quale controllo fallisce e perché. La soluzione può essere correggere configurazione, caricamento o rinnovo del token. La disattivazione permanente non è una diagnosi e può aumentare lo spam.
Se il caricamento resta fermo, la richiesta è stata persa?
Non si può dedurre solo dalla schermata. La richiesta potrebbe essere stata elaborata senza che la conferma arrivasse al browser. Controlla eventuale archivio e registri prima di ripetere l’invio, per evitare duplicati.
