Toimii è in soft launch, quindi queste guide descrivono un servizio a cui puoi già iscriverti e che puoi usare oggi. Qualche pezzo è ancora in arrivo: le app per iOS e Android arrivano entro la fine del 2026.

Aggiungi un modulo di contatto al tuo sito statico: Astro, Hugo, 11ty, Jekyll

Un unico codice nel template del layout. Funziona con Astro, Hugo, 11ty, Jekyll e qualsiasi altro generatore di siti statici.

<script src="https://cdn.toimii.io/components/your-code.js" async></script>
<toimii-your-code></toimii-your-code>

Funziona davvero?

Sì — e i siti statici sono il caso più semplice. Nessun sandbox di plugin, nessun editor che elimina gli script, nessun piano richiesto. Le due righe vanno nel template del layout nello stesso modo in cui andrebbero in qualsiasi file HTML.

Passo dopo passo

Apri il template del layout

Apri il template che avvolge ogni pagina — quello che contiene già il tuo tag <body>.

Incolla il codice di incorporamento

Incolla le due righe dalla pagina del tuo componente in Toimii dentro <body>. Per mostrare il modulo solo su certe pagine, racchiudi entrambe le righe nel costrutto condizionale del tuo generatore — lo script e il tag vanno tenuti insieme.

Compila e distribuisci

Compila e distribuisci come fai di solito. Poi apri la pagina pubblicata e invia un messaggio di prova.

Trappole

Metti il tag in un template, non in un file di contenuto Markdown. Che l'HTML grezzo sopravviva al Markdown dipende da un'impostazione specifica di ogni generatore — in Hugo serve markup.goldmark.renderer.unsafe — mentre un template non passa affatto per il Markdown.
Astro raggruppa nel bundle i tag script il cui unico attributo è src. Il nostro ha anche async, e qualsiasi attributo oltre a src fa sì che Astro lasci stare il tag — quindi funziona così com'è. Se un giorno lo riduci al solo src, aggiungi is:inline.
Gli host statici non aggiungono una Content-Security-Policy per impostazione predefinita. Se ne imposti una tu — come intestazione della risposta HTTP o come tag <meta> — autorizza cdn.toimii.io in script-src e api.toimii.io in connect-src.

Domande frequenti

Come lo aggiungo in Astro, Hugo, 11ty o Jekyll?

Non c'è nessuna differenza tra loro — i passaggi qui sopra sono l'intera procedura in tutti e quattro. Non indichiamo di proposito il percorso del file del template: ogni generatore lo chiama in modo diverso e i nomi sono cambiati da una versione all'altra, quindi controlla la documentazione del tuo generatore.

Funziona su GitHub Pages, Netlify, Vercel o Cloudflare Pages?

Sì, e su qualsiasi altro host che serva file statici — dalla tua parte non gira niente. Conta l'indirizzo più dell'host: gli invii vengono accettati solo dal dominio che hai indicato in Toimii, quindi una build di anteprima sul sottodominio dell'host renderizza il modulo ma rifiuta il messaggio.

Rallenta la mia build?

No. Lo script si carica a runtime, non durante la build — la tua build emette il tag script e il browser recupera il componente effettivo quando un visitatore apre la pagina. Astro, Hugo, 11ty, Jekyll: tutti invariati.

Stai incorporando su una piattaforma diversa?

Le stesse due righe di codice, spiegate per ogni piattaforma.

WordPress

Blocco HTML personalizzato, Block Editor o Classico. Nessuna installazione di plugin. Una cosa da sapere — il tuo ruolo utente deve avere la capacità unfiltered_html.

Leggi la guida completa

Squarespace

Inserisci un Blocco Codice su qualsiasi pagina. Serve un piano i cui blocchi di codice possono eseguire JavaScript.

Leggi la guida completa

Webflow

Trascina un elemento Code Embed e incolla le due righe. In Webflow il codice personalizzato è una funzione a pagamento — è l'unica condizione.

Leggi la guida completa

Wix

Usa il Custom Element di Wix: l'URL dello script del tuo componente in Server URL, il suo tag in Tag Name. L'elemento Embed HTML non funziona — è un iframe sandbox.

Leggi la guida completa

Shopify

Aggiungi una sezione Custom Liquid nell'editor del tema di Shopify — nessuna app da installare, nessuna modifica al codice del tema. Le pagine di checkout sono l'unico posto in cui non può stare.

Leggi la guida completa

HTML / Personalizzato

Basta una pagina HTML semplice. Aprila in un editor di testo, incolla, salva, carica. Tre passi e sei online.

Leggi la guida completa

React / Vue / Angular

Usa l'elemento personalizzato direttamente in JSX, nei template Vue o nei componenti Angular. Nessun componente wrapper, nessun pacchetto aggiuntivo.

Leggi la guida completa

Pronto a provare?

30 giorni di prova gratuita. Nessuna carta di credito. Pronto in pochi minuti.

Inizia la prova gratuita

Nessuna carta di credito. Pronto in 2 minuti.