Domande frequenti e risoluzione dei problemi

Qui raccogliamo le domande più frequenti tratte dalle e-mail di assistenza e dalle chiamate dei clienti. Se non trovi la risposta alla tua domanda, scrivici: hello@propform.io.


🔌 Integrazione con onOffice

Il mio modulo non salva i dati in onOffice

In 9 casi su 10 il problema è dovuto ai diritti API dell'utente onOffice — spunta "Privato" sull'indirizzo, mancanza di assegnazione al gruppo nel modulo Gruppi, diritti limitati sui record nei modelli, ecc.

Istruzioni complete e soluzioni

I campi non vengono visualizzati nell'editor propform

Cause più frequenti:

  • Il campo non è attivato nell'amministrazione di onOffice → in onOffice, in Strumenti → Impostazioni → Attiva amministrazione
  • Nel modulo Criteri di ricerca: il campo deve essere definito esplicitamente in onOffice come campo dei criteri di ricerca
  • L'utente API non dispone dei diritti di lettura sul modulo

> L'elenco dei campi viene aggiornato una volta al giorno al mattino e all'apertura della panoramica dei moduli. Se hai appena creato un nuovo campo in onOffice, ricarica la panoramica dei moduli in propform.

Marketplace vs. utente API classico — qual è la differenza?

  • Marketplace: Configurazione con un clic tramite onOffice Marketplace, propform comunica tramite un token Marketplace. I diritti sono predefiniti dalla configurazione del Marketplace.
  • Utente API classico: crei manualmente un utente API in onOffice, assegni tu stesso i diritti in modo dettagliato, inserisci token e secret in propform. Maggiore controllo, ma configurazione leggermente più complessa.

Maggiori informazioni: Connettiti a onOffice.


📧 E-mail

L'e-mail di conferma non arriva

Cause più frequenti:

  • L'e-mail finisce nella cartella Spam — controlla la cartella Spam
  • I file caricati superano complessivamente i 25 MB — in tal caso non vengono allegati (l'e-mail arriva comunque, senza allegati)
  • Il firewall/filtro antispam del tuo provider di posta blocca automaticamente le e-mail inviate

L'e-mail di onOffice viene inviata all'indirizzo sbagliato

Si verifica in genere quando l'e-mail del destinatario esiste in onOffice solo come indirizzo secondario o terziario. In questo caso, propform crea automaticamente un nuovo record di indirizzo con questa e-mail, in modo che l'e-mail arrivi alla persona giusta — vedi la descrizione nel capitolo Notifica via e-mail.


📁 Caricamento e download di file

Come posso rendere disponibili i file da onOffice per il download da parte di chi richiama il modulo?

Tramite campi di download — configurabili in base alle caratteristiche del documento, al modello di file, all'anteprima PDF on-the-fly o a un URL fisso. I file multipli vengono automaticamente raggruppati in un file ZIP. Istruzioni complete: Campi di download.

L'upload del file non va a buon fine / il file non arriva in onOffice

Cause più frequenti:

  • La dimensione del file supera i 128 MB per singolo file (limite nginx lato server)
  • L'utente API non dispone dei diritti di scrittura sui file nel modulo corrispondente
  • La caratteristica del documento è disattivata in onOffice o non esiste
  • Per il modulo Estate: l'utente API potrebbe aver bisogno del diritto "Commercializzazione (sito web)" se, una volta attivati, i file devono essere pubblicati su un sito web

Le immagini HEIC dall'iPhone non vengono visualizzate

propform converte automaticamente le immagini HEIC dell'iPhone in JPEG prima che vengano caricate su onOffice — non devi fare nulla.

Come posso unire più file in un unico file ZIP o PDF?

Nelle impostazioni del campo di caricamento file troverai l'opzione "Unisci più file in..." — seleziona ZIP o PDF. Utile, ad esempio, per più foto dell'ufficio tecnico.

> Per il raggruppamento in PDF: funzionano solo immagini e file PDF. Altri tipi di file comprometterebbero la creazione del PDF.


🌐 Richiamo del modulo e parametri URL

Il precompilamento tramite UUID non funziona

Cause più frequenti:

  • Il campo "uuid" non è attivato nell'amministrazione di onOffice (modulo Indirizzi sotto Dati anagrafici, modulo Immobili sotto Dati tecnici)
  • Nelle impostazioni del modulo, l’opzione “Precompilazione con UUID” non è attivata
  • Parametro URL errato — Indirizzo: address[ID]=... (I maiuscola, D maiuscola), Immobile: estate[Id]=... (I maiuscola, d minuscola)
  • L'utente API non dispone dei diritti di lettura sul record

"Record di indirizzo con questo UUID non trovato"

Quattro possibili cause: (1) Il record è stato cancellato, (2) Utente API senza diritti di lettura, (3) diritti di condivisione/record troppo restrittivi, (4) il record è contrassegnato come "Privato". Diagnosi completa su Record di indirizzo UUID non trovato.

Il modulo dice "Sessione scaduta" o "Token non valido"

Il token CSRF scade dopo 24 ore. Soluzione: ricaricare il modulo e ripetere l'inserimento dei dati. Maggiori informazioni su Modulo scaduto.

Come posso inserire dinamicamente i parametri URL in un modello di e-mail onOffice?

Utilizza la macro UUID corrispondente:

https://propform.io/form/dein-slug?address[ID]=_Uuidaddress&estate[Id]=_Uuidestate

_Uuidaddress e _Uuidestate vengono sostituiti automaticamente da onOffice durante l'invio dell'e-mail con gli UUID dei record collegati.

Il mio modulo non si apre / "Data di scadenza superata"

Se nelle impostazioni del modulo è richiesta una data di scadenza, nell'URL del modulo deve essere presente ?exp=YYYY-MM-DD HH:MM:SS — e la data deve essere futura. Puoi inserire la data di scadenza in modo statico o farla calcolare dinamicamente tramite una formula onOffice (ad es. "14 giorni dall'invio"). Maggiori informazioni su Account → Data di scadenza.


🎨 Stile e design

Il font che desidero non è nella selezione

Ospitiamo Google Fonts localmente per motivi di protezione dei dati (nessuna connessione a Google quando si richiama il modulo). Se il carattere che desideri non è presente, scrivici brevemente all'indirizzo hello@propform.io — lo integreremo.

Come posso integrare il modulo nel mio sito web senza soluzione di continuità?

Utilizza l'incorporamento iFrame dalle impostazioni del modulo. Suggerimenti per un'integrazione perfetta:

  • Imposta lo sfondo su trasparente / bianco
  • Adatta il colore di accento alla CI del tuo sito web
  • Scegli uno stile di design adatto allo stile del tuo sito web (angolare / arrotondato / pillola)
  • Rimuovi il logo se la tua pagina ne mostra già uno

Il mio modulo non viene visualizzato correttamente

Causa più comune: la larghezza/altezza dell'iFrame non è corretta o il contenitore principale del tuo sito web è troppo stretto. Maggiori informazioni alla voce Modulo visualizzato in modo errato.


📄 PDF e modelli

I valori non vengono trasferiti al PDF

Causa più comune: macro errate (le macro degli indirizzi sono in CamelCase, quelle immobiliari in minuscolo) oppure i campi degli indirizzi vengono richiamati direttamente invece che tramite la pre-macro _Kaeufer / _Eigent. Maggiori informazioni su I valori non vengono trasferiti al PDF.


🛡️ Sicurezza

In che modo il mio modulo è protetto dagli spam bot?

Di default, automaticamente tramite un campo honeypot nascosto e la verifica del token CSRF. Maggiori informazioni su Protezione antispam e difesa dai bot.


🌍 Multilinguismo

Posso utilizzare il mio modulo in più lingue?

Attualmente solo tramite una copia tradotta manualmente con un URL dedicato — il multilinguismo automatico è in programma. Maggiori informazioni su Moduli multilingue.


📊 Monitoraggio nell'iFrame

Il tracciamento delle conversioni non funziona nel modulo incorporato

Gli script di tracciamento dovrebbero idealmente essere inseriti direttamente nel modulo (Impostazioni modulo → Tracciamento), non solo nella pagina che lo incorpora. Maggiori informazioni su Tracciamento nel modulo incorporato.


👥 Più record in un unico modulo

Come posso collegare più acquirenti / proprietari con un unico modulo?

Utilizzando due moduli interconnessi (Panoramica + Modifica) più macro ricorsive per i cicli di indirizzi (_buyerbrek_1_ / _ownerbrek_1_). Istruzioni complete con esempi di codice alla voce Collegare più record o FAQ breve alla voce Collegare più acquirenti / proprietari.


🛡️ Protezione dei moduli

Come posso limitare quali record possono essere modificati in un modulo pubblico?

Tramite Filtro per modulo — propform interroga solo i record presenti nel filtro onOffice. Protezione contro la manipolazione dell'UUID. Maggiori informazioni su Filtro per modulo.

Come posso proteggere un modulo con password, whitelist IP o token?

Panoramica di tutti i meccanismi di protezione disponibili (honeypot, whitelist IP, password del modulo, chiave del modulo tramite URL, data di scadenza, requisito UUID) su Protezione dei moduli e controllo degli accessi.

Come posso impedire che un modulo venga richiamato senza l'UUID del record?

Con l'impostazione del modulo "Immobile e/o indirizzo richiesti per il richiamo del modulo" — si impedisce la manomissione dell'URL e la creazione accidentale di record vuoti. Importante per i moduli di download e modifica. Maggiori informazioni alla voce Protezione dei moduli → Requisito UUID.


🧮 Calcoli, condizioni e tipi di campo speciali

È possibile calcolare automaticamente i campi (totali, commissioni)?

Sì — nella scheda "Condizioni e regole" con l'azione "Calcola valore" e la sintassi pipe: {{multiply:field:X|field:Y|/100}}. Istruzioni complete con esempi su Condizioni e regole → Calcoli tra campi.

Come posso mostrare/nascondere i campi, rendere obbligatori i campi in modo dinamico o modificare le etichette?

Tramite l'editor di condizioni e regole nelle impostazioni del modulo — basato su GUI, senza ID campo da DevTools. Maggiori informazioni su Condizioni e regole.

Posso utilizzare un cursore di intervallo al posto di un campo di immissione?

Sì — i campi numerici possono essere configurati come campo speciale "Cursore di intervallo" (Min/Max/Intervallo + etichette). Maggiori informazioni su Campi calcolati e tipi di campo speciali.


🔀 Invio automatico e instradamento condizionale

È possibile modificare un valore in onOffice con un clic sul link dell’e-mail senza visualizzare il modulo?

Sì — I moduli con invio automatico reindirizzano direttamente al momento dell’accesso. Inoltre: l’URL della pagina di ringraziamento può reindirizzare a destinazioni diverse tramite _calculate(IF(...)) a seconda del valore del campo. Maggiori informazioni su Invio automatico e instradamento condizionale.


🔍 Profili di ricerca

Come posso consentire agli acquirenti/locatari di gestire autonomamente i propri profili di ricerca?

Tramite una configurazione self-service: e-mail di riepilogo con loop _bScRek_("status:1") + pulsanti a 1 clic (_pfButton) per accedere ai moduli di modifica e disattivazione. Modello completo in Modifica / disattivazione profili di ricerca.

Il mio nuovo campo dei criteri di ricerca non compare in propform

Causa più frequente: il campo è stato creato in onOffice in un modello alternativo dei criteri di ricerca, ma l'API legge solo il modello predefinito. Soluzione: trasferire il campo nel modello predefinito. Maggiori informazioni in Profili di ricerca → Insidie.

Devo utilizzare la ricerca per raggio o l'aggiunta regionale?

Dipende dalla tua configurazione: il raggio è più semplice, l'aggiunta regionale è più granulare. Confronto in Profili di ricerca → Ricerca geografica.


🏘️ Best practice per i record di dati onOffice

Devo riutilizzare lo stesso record immobiliare per una nuova locazione?

No — è meglio duplicarlo e svuotare i vecchi dati dell'operazione nel nuovo record (firme, documenti, note). Maggiori informazioni su Duplicare un immobile in caso di nuova commercializzazione.

Il mio campo formula in onOffice è vuoto nei vecchi record

Le formule vengono calcolate solo al momento del salvataggio. Trucco: aggiornamento di massa senza modifiche. Maggiori informazioni su Ricalcolo dei campi formula.


🤖 Funzioni IA

Come posso utilizzare l'input vocale o il completamento automatico per il mio modulo?

Inserisci la chiave API OpenAI nelle impostazioni dell'account → attivalo nelle impostazioni del modulo. Istruzioni complete con configurazione, costi e note sulla privacy su Funzioni IA.

Quanto costa l'utilizzo delle funzioni IA?

Molto conveniente — in genere meno di 1 $ per 100 inserimenti vocali o compilazioni automatiche. Paghi direttamente a OpenAI in base al consumo. Dettagli su Funzioni IA → Costi.


🎨 Design e branding

Come posso adattare il logo, i colori e il carattere al mio corporate design?

Nelle impostazioni dell'account → Stile predefinito dei moduli. Maggiori informazioni su Design e branding.

Il font che desidero non è disponibile nella selezione

Scrivici indicando il nome del font: se è disponibile su Google Fonts, lo integreremo gratuitamente entro 1-2 giorni lavorativi.


💰 Account e fatturazione

Come posso cambiare il mio piano?

  • Tramite Marketplace: Nella panoramica di onOffice Marketplace → propform.io → Gestisci abbonamento
  • Piano classico (Paddle): Nelle impostazioni dell'account propform.io → Abbonamento

Ho un account Marketplace — posso utilizzare anche le funzioni specifiche dell'account propform?

Sì, tutte le funzioni sono disponibili indipendentemente dal metodo di fatturazione. Il Marketplace riguarda solo l'autenticazione e il modello di abbonamento.


🆘 Il mio problema non è elencato qui sopra

Scrivici fornendo il maggior numero possibile di dettagli:

  • URL del modulo (o ID del modulo)
  • Data e ora dell'incidente
  • Cosa ti aspettavi, cosa è successo?
  • In caso di messaggio di errore: screenshot

📧 hello@propform.io 📞 0163 / 64 18 132