> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://help.fotostudio.io/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).
# Come collegare il modulo del mio sito a Fotostudio
# Collegare il tuo modulo a Fotostudio
Hai già un modulo di contatto sul tuo sito (WordPress, Webflow, Wix, HTML…) e vuoi che le compilazioni arrivino direttamente in Fotostudio? Questa guida spiega come fare.
Il vantaggio principale: il tuo modulo rimane 100% nel tuo stile: i tuoi colori, il tuo layout, il tuo design. Fotostudio riceve i dati in background senza mai apparire sul tuo sito.
> Questo metodo è diverso dall'**iframe**: con l'iframe, è il modulo di Fotostudio ad essere visualizzato sul sito. Qui è *il tuo* modulo esistente a inviare i dati a Fotostudio.
## 1. Ottenere l'URL di connessione
Ogni modulo Fotostudio ha un URL univoco. Quando il tuo modulo invia i dati a questo URL, Fotostudio crea automaticamente il contatto, attiva i suoi workflow e ti invia la notifica abituale.
Per trovare questo URL:
1. Vai in **Impostazioni → Moduli**
2. Clicca sul modulo interessato
3. Apri **Ottieni il codice → Collega il tuo modulo**
Questo popup genera anche un codice HTML completo, pronto da incollare sul sito. Contiene già tutti i campi configurati nel tuo modulo Fotostudio, con i corretti attributi `name`. È il punto di partenza più semplice se parti da zero o vuoi verificare i nomi esatti dei campi.
Il tuo URL è simile a:
```
https://app.fotostudio.io/f/abc123def456...
```
## 2. Nominare i campi
Fotostudio riconosce i campi del modulo in base al loro attributo `name`. Utilizza i seguenti nomi:
| Attributo `name` | Dato salvato |
| ---- |
| `email` | Email |
| `firstname` | Nome |
| `lastname` | Cognome |
| `phone` | Telefono |
| `message` | Messaggio |
| `company` | Azienda |
| `start_date` | Data del servizio (`YYYY-MM-DD`) |
| `project_type` | ID del tipo di servizio |
| `place` | Luogo del servizio |
Il codice generato nel popup (passo 1) elenca esattamente i campi disponibili per il tuo modulo.
**Hai altri campi?** Nessun problema. Qualsiasi campo non riconosciuto viene automaticamente salvato come nota sul contatto (es. un campo `budget` verrà salvato così com'è). Non si perde nulla.
## 3. Aggiungere un anti-spam (consigliato)
Aggiungi questo campo invisibile al tuo modulo. I bot lo compilano, le persone no. Fotostudio rifiuta silenziosamente le compilazioni in cui questo campo è valorizzato.
```
```
## 4. Configurazione per piattaforma
### Sito HTML personalizzato
Il metodo più semplice. Aggiungi `action` e `method` al tag `
```
Dopo l'invio, il visitatore viene reindirizzato all'URL configurato in **Impostazioni modulo → URL di reindirizzamento**.
### Webflow
1. Seleziona il tuo blocco **Form**.
2. Nelle impostazioni del modulo, inserisci il tuo URL Fotostudio come **Action**.
3. Imposta il **Method** su `POST`.
4. Nomina ogni campo (attributo **Name**) secondo la tabella precedente.
5. Aggiungi un campo di testo chiamato `_gotcha`, imposta il suo valore predefinito su vuoto e nascondilo tramite le opzioni di visibilità.
### WordPress — Gravity Forms
1. Crea il modulo con i campi desiderati.
2. Vai in **Impostazioni → Webhooks** (richiede l'add-on Webhooks di Gravity Forms).
3. Aggiungi un nuovo webhook:
* **URL**: il tuo URL Fotostudio
* **Metodo**: POST
* **Formato**: Form
4. Nella sezione **Campi**, assegna ogni campo di Gravity Forms al suo nome Fotostudio (`email`, `firstname`, ecc.).
### WordPress — WPForms
1. Crea il modulo.
2. In **Impostazioni → Webhooks** (WPForms Pro), aggiungi un webhook:
* **URL della richiesta**: il tuo URL Fotostudio
* **Metodo**: POST
3. Assegna ogni campo al suo nome Fotostudio.
### WordPress — Contact Form 7
CF7 non permette di modificare l'azione nativamente. Installa il plugin **CF7 to API** e configura l'URL Fotostudio nelle sue impostazioni. Nomina i campi secondo la tabella precedente.
### Wix
Wix non permette di modificare l'azione di un modulo nativo. Utilizza **Wix Automations**:
1. Crea il modulo in Wix.
2. Vai in **Automazioni → Nuova automazione**.
3. Trigger: **Modulo inviato**.
4. Azione: **Invia un webhook** → inserisci il tuo URL Fotostudio.
5. Assegna i campi Wix ai nomi Fotostudio nel corpo della richiesta.
### Typeform / Tally
Questi strumenti dispongono di un'integrazione webhook nativa:
* **Typeform**: Connetti → Webhooks → inserisci il tuo URL Fotostudio
* **Tally**: Integrazioni → Webhook → inserisci il tuo URL Fotostudio
Assegna ogni domanda al suo corrispondente nome Fotostudio.
### Squarespace
Squarespace non permette di modificare l'azione di un modulo nativo nei piani base. Due opzioni:
* **Piano Business o superiore**: utilizza un blocco di codice HTML con un modulo personalizzato (vedi la sezione *Sito HTML personalizzato* sopra).
* **Tutti i piani**: utilizza Make o Zapier per inoltrare le compilazioni a Fotostudio.
## FAQ
**Le compilazioni duplicate sono protette?**
Sì. Se lo stesso indirizzo IP invia lo stesso modulo due volte in meno di 30 secondi (es. doppio clic sul pulsante), la seconda compilazione viene ignorata silenziosamente.
**Il mio iframe continua a funzionare?**
Sì, entrambi i metodi (iframe e connessione esterna) sono completamente indipendenti. L'uno non influenza l'altro.
**Posso reindirizzare il visitatore dopo l'invio?**
Sì. Configura l'**URL di reindirizzamento** nelle impostazioni del tuo modulo Fotostudio. Il visitatore vi sarà reindirizzato dopo aver inviato il tuo modulo esterno.