Integrations

Moduli del sito web, WordPress e SDK di cattura

Cattura lead da qualsiasi modulo sul tuo sito web (WordPress, Wix, HTML semplice) direttamente nel CRM: incolla un modulo HTML già pronto oppure l'SDK di cattura JS. Ogni invio diventa automaticamente un Lead.

L'integrazione "Moduli del sito web / WordPress" cattura lead da qualsiasi modulo sul tuo sito e crea un Lead nel CRM ad ogni invio. È realizzata da noi, senza account esterni: devi solo generare un indirizzo di cattura (un token pubblico) e puntare un modulo ad esso. I campi vengono mappati in modo flessibile (nome/email/telefono/azienda/messaggio), e l'origine del lead resta "website" (o il valore che imposti nel campo "source").

Accetta l'invio sia come modulo HTML normale (application/x-www-form-urlencoded) sia come JSON, quindi funziona sia con un <form> che incolli sia con chiamate da codice. L'indirizzo accetta POST da qualsiasi dominio (CORS aperto), dato che lo scopo è proprio ricevere l'invio dal sito del cliente. Parte inerte: non viene catturato nulla finché non generi l'indirizzo e lo abiliti.

Prerequisiti

Nessun account o credenziale esterna: la cattura è realizzata da noi.
Accesso per modificare il tuo sito: incollare un <form> o uno <script> (in WordPress, un blocco "HTML personalizzato" o il footer del tema; funziona anche con Contact Form 7, Elementor, Wix o HTML semplice).
In Sellio, essere amministratore per generare l'indirizzo di cattura e abilitare l'integrazione in Impostazioni → Integrazioni.

Come abilitare

Apri Impostazioni → Integrazioni e vai alla scheda "Moduli del sito web / WordPress".
Clicca su "Genera indirizzo di cattura" per creare l'URL del webhook (un token di cattura unico e pubblico).
Copia il modulo HTML già pronto (o l'SDK) e incollalo sul tuo sito, come descritto di seguito.
Clicca su "Abilita". Da quel momento gli invii iniziano a creare Lead nel CRM.

Opzione A: modulo HTML già pronto

Nella scheda, copia il blocco <form> già pronto (punta già al tuo indirizzo di cattura) e incollalo dove vuoi mostrare il modulo. In WordPress, usa un blocco "HTML personalizzato". Puoi regolare liberamente i campi: i nomi name, email, phone, company e message vengono riconosciuti automaticamente. Un campo nascosto facoltativo "redirect" porta il visitatore a una pagina di ringraziamento dopo l'invio.

Example: <form action="https://app.yourdomain.com/api/inbound/webform/YOUR_TOKEN" method="POST"> … <input name="email" required> … </form>

Opzione B: SDK di cattura JS (sviluppatori)

Per siti che hanno già propri moduli (o app), incolla lo <script> dell'SDK sul tuo sito. Espone due metodi nel browser, senza dati sensibili (nello script c'è solo il token pubblico di cattura):

window.Sellio.capture({ name, email, phone, company, message, source }) invia un lead direttamente (utile in pulsanti, popup o flussi dell'app).
Sellio.trackForm('#my-form') intercetta l'invio di un modulo esistente e manda i campi al CRM, senza che tu tocchi l'HTML del modulo.

Example: <script src="https://app.yourdomain.com/api/sdk/YOUR_TOKEN/sellio.js" async></script> → poi: Sellio.trackForm('.wpcf7-form')

WordPress: Contact Form 7, Elementor e blocco HTML

Blocco HTML: incolla il modulo già pronto (Opzione A) in un blocco "HTML personalizzato" nella pagina.
Contact Form 7: mantieni il tuo modulo CF7 e aggiungi l'SDK (Opzione B) al footer del tema; poi chiama Sellio.trackForm(".wpcf7-form"). I nomi dei campi CF7 (your-name, your-email) sono già riconosciuti.
Elementor: mantieni l'Elementor Form e aggiungi l'SDK al sito; usa Sellio.trackForm() con il selettore del tuo modulo per inviare ogni invio al CRM.

Cosa diventa un Lead

Ogni invio con qualcosa di identificabile (email, telefono o nome) crea un Lead, con l'origine definita dal campo "source" (predefinito "website"). I campi che invii e che non sono quelli standard vengono aggiunti al messaggio del lead, così non si perde nulla. La cattura è idempotente su base best-effort: se invii un "external_id", i reinvii dello stesso id non duplicano; senza external_id, i lead con la stessa email non vengono comunque duplicati.

Sicurezza

Il token dell'URL è PUBBLICO e serve solo per la cattura: identifica il tuo account, ma non espone dati né permette di leggere nulla. Non mettere mai un segreto nel modulo o nell'SDK.
Se hai bisogno di invalidare l'indirizzo attuale, usa "Genera nuovo token", e il vecchio modulo/SDK smette di funzionare.
Un token non valido o un'integrazione disabilitata restituisce 404; gli invii vuoti (senza nulla di identificabile) vengono ignorati silenziosamente.

💡 Inizia con il modulo HTML già pronto per validare rapidamente, e passa all'SDK (trackForm) quando vuoi mantenere l'aspetto del tuo attuale modulo WordPress.

Come testare

Incolla il modulo HTML già pronto (Opzione A) in una pagina di prova del tuo sito e abilita l'integrazione.
Compila e invia il modulo con un'email di prova.
Nel CRM, apri l'elenco Lead e conferma che sia apparso un Lead con origine "website" (o il valore del campo "source").
Reinvia con la stessa email (o lo stesso external_id) e conferma che NON duplichi.

Risoluzione problemi

Non crea un Lead: conferma che l'integrazione sia "Abilitata" e che il <form>/SDK punti all'indirizzo di cattura corretto. Gli invii completamente vuoti (senza email, telefono o nome) vengono ignorati silenziosamente.
404 sull'URL: il token dell'indirizzo è cambiato (hai cliccato su "Genera nuovo token") oppure l'integrazione è disabilitata. Copia l'indirizzo attuale e aggiorna il modulo/SDK.
L'SDK non intercetta il modulo: controlla il selettore passato a Sellio.trackForm() (ad es. ".wpcf7-form"); in CF7/Elementor l'SDK deve caricarsi sul sito (footer del tema).
I campi non arrivano: usa i nomi riconosciuti (name, email, phone, company, message); i nomi CF7 (your-name, your-email) sono già accettati. I campi extra vengono aggiunti al messaggio del lead.
Non mettere segreti nel modulo: il token dell'URL è PUBBLICO e serve solo per la cattura, e non espone né legge dati.

Open this article inside the system →