Integrazione sito e CRM: verifica che le richieste arrivino
Neaptide · 7 settembre 2026 · 6 min di lettura
Collega i moduli al CRM, conserva la provenienza e gestisci i tentativi senza duplicati. Con uno scenario di errore e una checklist di collaudo.
In questo articolo
Un messaggio di ringraziamento non dimostra che la richiesta sia arrivata nel CRM. Prima di approvare il sito, verifica l’invio salvato, la scheda corrispondente e il commerciale incaricato. Se il processo si interrompe, il team deve poter individuare il passaggio in cui si è fermato.
L’integrazione trasmette i dati del modulo al sistema commerciale e applica le regole concordate per richieste, contatti e assegnazioni. Un modulo nativo, un connettore o codice dedicato possono svolgere questo compito.
Definisci quando una richiesta è ricevuta
Distingui tre passaggi: salvataggio sul sito, conferma del CRM e assegnazione al commerciale. Un’email o una notifica Telegram non dimostrano da sole che tutti e tre siano riusciti.
Se il CRM è indisponibile, il sito può conservare la richiesta in modo affidabile e trasmetterla dopo. Può quindi confermarne la ricezione. Se anche il salvataggio fallisce, deve offrire un nuovo tentativo o un altro contatto, senza dichiarare un successo.
Parti dalla soluzione adatta più semplice
Verifica moduli e connettori esistenti rispetto a campi, assegnazioni e recupero degli errori. Chiedi una dimostrazione: lo sviluppo su misura non è automaticamente più affidabile.
Una coda separa ricezione ed elaborazione, ma richiede il controllo dei messaggi in attesa o falliti. Per un flusso ridotto e stabile, un servizio di code separato può essere superfluo. Valuta anche la manutenzione.
Conserva il contesto della richiesta
Prepara una tabella che associ ogni campo del modulo a quello corrispondente nel CRM. Includi i dati aggiunti dal sito: pagina, identificativo del modulo, ora di ricezione e fonte conosciuta della visita. Controlla anche i campi obbligatori e i valori ammessi nelle liste di scelta.
Decidi se conservare la prima fonte conosciuta, quella della richiesta attuale o entrambe. L’assenza di UTM non dimostra una visita diretta: la fonte può essere sconosciuta.
Le credenziali del CRM devono restare sul server. Limita l’accesso ai log ed evita di copiarvi inutilmente i messaggi completi dei clienti.
Un nuovo tentativo non è una nuova richiesta
Scenario ipotetico: il sito salva S-104, il CRM crea C-208, ma la conferma si perde. Il sito rileva un timeout. Ripetere la creazione senza verificare l’esito può generare un duplicato.
Usa lo stesso identificativo quando ritenti l’invio. Se l’API supporta l’idempotenza, può trattare i tentativi ripetuti come una sola operazione. Altrimenti serve un meccanismo adatto per associare e verificare le registrazioni. Cercare una scheda prima di crearla non basta quando due richieste arrivano insieme. Un timeout non dimostra che il primo salvataggio sia fallito.
Se domani la stessa persona chiede un altro servizio, si tratta di una nuova richiesta S-105. Puoi collegarla al contatto esistente conservandone il contenuto. Eliminare tutti gli invii con lo stesso numero nasconderebbe richieste reali.
Verifica il comportamento in caso di guasto
La tabella definisce risultati attesi in un ambiente di prova, non prestazioni misurate di un CRM. Usala per tutti i moduli e le lingue. Registra gli identificativi per confrontare la stessa richiesta nei diversi sistemi.
| Caso | Verifica attesa |
|---|---|
| Richiesta normale | Campi, provenienza, record e referente corretti. |
| CRM indisponibile | Richiesta salvata, attesa visibile, consegna ripresa. |
| Timeout dopo la creazione | Il reinvio non crea un’altra richiesta; l’esito si verifica tramite l’identificativo. |
| Campo obbligatorio non valido | Errore visibile, senza tentativi infiniti. |
| Nuova richiesta, stesso numero | Contenuto conservato secondo le regole concordate. |
| Nessun parametro UTM | Nessuna campagna inventata al posto della fonte sconosciuta. |
Prepara la gestione dopo il lancio
Alla consegna, richiedi la tabella dei campi, le regole per le nuove richieste di contatti già presenti e le istruzioni per consultare gli errori. Assegna un responsabile e concorda i tempi di trasmissione. Fatti mostrare anche come riprendere il lavoro dopo un errore senza creare duplicati.
Il numero di nuove opportunità non basta per verificare le consegne. Alcune richieste si collegano a contatti o opportunità esistenti. Confronta identificativi e stati, distinguendo test, spam e richieste in attesa.
Per un progetto web con Neaptide, invia l’indirizzo del sito, il CRM, l’elenco dei moduli e un esempio del record desiderato senza dati personali. Specifica come trattare i clienti che tornano e chi approva il lavoro per il reparto commerciale.