In questa pagina
Invia due volte la stessa iscrizione di prova. Dovresti ritrovarti con un solo iscritto, una sola richiesta di conferma e una traccia di ciò che è successo. Se il secondo invio avvia un’altra sequenza di benvenuto, il collegamento va corretto.
Un’integrazione utile tra Webflow e Brevo deve gestire la seconda consegna con la stessa attenzione della prima. Questa guida offre una mappa dei campi, un confine chiaro per la conferma e un piccolo test di accettazione da usare con un servizio di automazione o con il tuo server.
Scegli il percorso più breve
| Cosa ti serve | Da dove partire | Cosa verificare |
|---|---|---|
| Iscrizione alla newsletter | Incorpora un modulo Brevo | Doppia conferma, campi obbligatori e lista di destinazione |
| Registri degli invii nativi Webflow | Mantieni il modulo Webflow e collega un servizio di automazione | Mappatura, conferma e comportamento ai nuovi tentativi |
| Instradamento personalizzato o recupero controllato | Ricevi gli eventi Webflow sul tuo server | Autenticazione, stato in attesa, deduplicazione e registro degli errori |
Il creatore di moduli Brevo supporta la doppia conferma. I nuovi iscritti devono fare clic sul link ricevuto via email prima di entrare nel database dei contatti. È un buon punto di partenza se ti serve solo una newsletter.
«Abbiamo già progettato il modulo in Webflow». Mantienilo se contano l’aspetto o i registri degli invii. La guida alle integrazioni Webflow descrive percorsi con automazioni e API. Prima di cambiare l’azione del modulo, verifica l’effetto: aggirare la gestione di Webflow cambia anche dove vengono salvati gli invii.
Decidi il significato di ogni campo
Usa un modulo dedicato alla newsletter oppure, in un modulo di contatto generale, una scelta marketing separata e non preselezionata. Chiedere una risposta commerciale non equivale a iscriversi di nascosto alla newsletter.
Questa è una mappa di esempio per una newsletter aziendale. Nome ed email di lavoro obbligatori sono una scelta di questo modulo, non requisiti universali di Webflow o Brevo.
| Campo di origine | Destinazione | Regola |
|---|---|---|
| Email di lavoro | Email del contatto | Obbligatoria; convalida sul server |
| Nome | Attributo FIRSTNAME | Obbligatorio; elimina gli spazi iniziali e finali |
| Azienda | Attributo COMPANY | Facoltativo; un invio vuoto non cancella un valore salvato |
| Scelta marketing | Prova del consenso | Riconosci solo valori espliciti; fermati se il valore è sconosciuto |
| ID dell’invio | Registro di elaborazione | Riconosci una consegna ripetuta |
| Ora e ID del modulo | Registro di elaborazione | Conserva il contesto necessario a spiegare l’origine |
Crea in Brevo gli attributi corrispondenti con i tipi corretti prima di inviare dati. L’API Contatti di Brevo accetta un oggetto di attributi e può aggiornare un contatto esistente con updateEnabled. I campi spostano dati, non concedono il permesso di inviare marketing.
Se accetti solo email aziendali, applica questa regola anche sul server. Un dominio aziendale non dimostra il consenso né garantisce che la casella appartenga a un vero cliente.
Conferma prima di aggiungere al pubblico
Per i nuovi iscritti usa questa sequenza:
- Convalida il modulo e la scelta marketing esplicita.
- Salva la richiesta come in attesa, con origine e ID dell’invio.
- Avvia una sola richiesta di double opt-in.
- Ricevi la conferma tramite il sistema scelto.
- Aggiungi il contatto confermato al pubblico marketing.
Brevo offre un endpoint API dedicato al double opt-in, POST /v3/contacts/doubleOptinConfirmation, con modello, liste di destinazione e URL di reindirizzamento. Una normale chiamata a POST /v3/contacts è un’operazione diversa. Non creare prima un contatto separato se richiedi la conferma prima della sua creazione.
Scegli un solo sistema responsabile della conferma. Se un modulo Brevo, un’automazione separata e un tuo invio di conferma reagiscono allo stesso evento, possono nascere messaggi doppi. Una risposta API riuscita non dimostra che la persona abbia cliccato sul link.
Per progettare l’abbonamento nel suo insieme, leggi la guida al double opt-in. Prova un indirizzo già disiscritto separatamente da uno nuovo.
Ricevi gli eventi su un server
Non mettere la chiave API Brevo nel codice della pagina Webflow. Deve restare nel server ricevente o nell’archivio delle credenziali del servizio di automazione.
Webflow documenta il webhook form_submission, inclusi campi, identità del modulo e ora dell’invio. Verificalo in base al modo in cui è stato creato. Webflow segnala che i webhook creati dalla dashboard non includono le intestazioni di firma previste dal percorso di integrazione firmato.
Registra stabilmente una consegna valida prima di confermarne la ricezione. Se la destinazione non è disponibile, ritenta il lavoro salvato. Distingui «ricevuto», «in attesa di conferma», «sincronizzato», «saltato» ed «errore»: un webhook accettato non è ancora una sincronizzazione completata.
Rispetta una disiscrizione successiva
Rielaborare una vecchia iscrizione non deve annullare una disiscrizione più recente. Confronta l’ora dell’evento e lo stato di iscrizione autorevole prima di aggiornare la destinazione. Una casella assente o un valore sconosciuto non diventano consenso. Un nuovo invio da solo non deve sbloccare o reiscrivere chi si era disiscritto; Brevo tratta il blocco come uno stato di iscrizione separato.
Attenzione anche ai cambi d’identità. La documentazione Brevo sull’aggiornamento avverte che cambiare l’email di un contatto bloccato può rimuovere il blocco e reiscriverlo. Tratta il cambio di indirizzo come un’operazione distinta da esaminare, non come una normale mappatura.
Per un contatto attualmente iscritto, aggiornare la scheda corrispondente può evitare una seconda scheda. Deduplica comunque l’evento: un contatto solo può ricevere due messaggi.
Esegui questi sei test di accettazione
| Test | Risultato atteso |
|---|---|
| Nuova iscrizione valida | In attesa fino alla conferma; niente marketing prima |
| Stesso invio consegnato due volte | Un esito di elaborazione; nessuna seconda conferma |
| Scelta marketing assente o ambigua | Nessuna iscrizione dedotta |
| Vecchia iscrizione ripetuta dopo disiscrizione | La disiscrizione più recente resta valida |
| Brevo temporaneamente non disponibile | Errore visibile e ritentabile; nessun falso successo |
| Azienda omessa in un invio successivo | Il valore salvato resta, salvo cancellazione voluta |
Esegui le prove su una lista isolata con indirizzi che controlli. Verifica entrambi i sistemi e i messaggi effettivamente ricevuti. Un passaggio verde nell’automazione non basta.
Dove entra Tajo
Tajo è in accesso anticipato. Porta alla verifica dell’integrazione il modulo di origine, la lista di destinazione, la mappa dei campi e i sei risultati attesi. Conferma che il flusso scelto li supporti prima di attivarlo.
Per confrontare un modulo nativo, un servizio di automazione e codice personalizzato, consulta la guida ai connettori Brevo.
Per un negozio invece di un modulo web, consulta la guida da Shopify a Brevo. Per un’implementazione personalizzata, la guida API Brevo offre altro contesto.
Raccontaci quali sistemi vuoi collegare. Parti da un modulo che resiste a una consegna ripetuta.
Domande frequenti
Qual è il modo più semplice per collegare Webflow a Brevo?
Per una newsletter, incorpora un modulo di iscrizione Brevo e attiva la doppia conferma. Mantieni il modulo nativo Webflow se ti servono i suoi invii o un instradamento personalizzato, poi usa un servizio di automazione o un'integrazione lato server.
Creare un contatto Brevo ne conferma l'iscrizione?
No. Una normale chiamata per creare o aggiornare un contatto non completa il double opt-in. Usa un flusso di conferma e inserisci un nuovo iscritto nel pubblico marketing solo dopo la conferma.
Come evito duplicati quando un invio viene ritentato?
Salva l'ID dell'invio Webflow e l'esito dell'elaborazione. Ripetere lo stesso invio non deve ripeterne gli effetti. Per un contatto già confermato, aggiorna la scheda corrispondente invece di creare una seconda identità.