Kit gratuito / Speed-to-Lead Blueprint
Pacchetto Speed-to-Lead Blueprint
Sette fasi, una pipeline: dalla cattura all'assegnazione al rep in meno di dieci secondi, con la configurazione e il comportamento in caso di errore scritti nero su bianco.
Kit correlati: lo Stack di routing unisce questa pipeline allo strato di routing che decide a chi va il lead, il Kit di routing automatico dei lead è quello strato di routing da solo, e il Kit di audit dei workflow trova dove la pipeline perde.
La pipeline
Ogni invio di form, conversione ads e messaggio di chat passa per le stesse sette fasi: validazione, deduplica, arricchimento, scoring, routing e assegnazione. Questo pacchetto è la versione costruibile di quella pipeline. Fase per fase, con le chiavi che imposti e il modo in cui ogni fase fallisce.
Un unico endpoint webhook accetta invii di form, trascrizioni di chat e conversioni ads. I payload vengono normalizzati e verificati contro lo schema prima che succeda qualsiasi altra cosa. Da lì il lead va da sinistra a destra, poi riscrive e notifica.
ingress
|
v
[01 Capture] -> [02 Validation] -> [03 Dedupe] -> [04 Enrich] -> [05 Scoring]
|
v
[07 Assign] <- [06 Router] <- -----------------------------------+
| ^
| +---- conflict resolver (score or territory tie)
v
[CRM write] -> [Notifier: Slack / SMS / Email] -> [Dashboard readback]
dead-letter queue + correlation log on every hop| Fase | Nome | Compito | Ti dice quando è sbagliata |
|---|---|---|---|
| 01 | Capture | Accetta una sola forma di evento da ogni sorgente | Il conteggio degli eventi cala o cambia la forma del payload |
| 02 | Validation | Scarta la spazzatura prima che diventi un record | Il tasso di scarto sale sopra la baseline |
| 03 | Dedupe | Corrispondenza prima della creazione, merge con traccia scritta | I nuovi record schizzano a fronte di traffico stabile |
| 04 | Enrich | Contesto firmografico e di intento in parallelo | Timeout dei provider, calo del cache hit rate |
| 05 | Scoring | Un solo punteggio di fit e comportamento, da 0 a 100 | La distribuzione dei punteggi si sposta senza un cambio di traffico |
| 06 | Router | Territorio, carico e disponibilità in un solo passaggio | Proprietari non risolti, conflitti di territorio in coda |
| 07 | Assign | Consegna a un rep o a una coda, avvia il timer SLA | Notifica non confermata dentro la finestra |
Guida di build fase per fase
Gateway di cattura
Input: form di sito e landing page, webinar e download di contenuti, Facebook Lead Ads, conversioni Google Ads, LinkedIn Lead Gen Forms, trascrizioni chat Drift o Intercom.
Configurazione: un solo endpoint pubblico. Normalizza ogni sorgente nel tuo contratto di evento interno prima che qualsiasi cosa a valle lo legga. Conserva event_id, correlation_id, idempotency_key, source_system, source_record_id, utm_source, utm_campaign. Conserva il payload grezzo accanto a quello normalizzato.
Limite di sicurezza: verifica della firma HMAC sull'endpoint prima dell'elaborazione. Le submission di test non autorizzate sono una vera fonte di record spazzatura.
Comportamento in caso di errore: non-2xx al provider, payload conservato per il replay, alert se il tasso di errore si muove. Budget 150 ms.
Validazione
Input: l'evento normalizzato.
Configurazione: controlli di schema e sanity. Campi obbligatori presenti. Formato email valido. Consenso catturato dove la regolamentazione lo richiede. Campi enum limitati ai valori ammessi. Budget e urgenza verificati contro la lista su cui instradi. Il contesto di sessione e UTM passa intatto.
Regola: rifiuta verso una coda di revisione, non scrivere un record parziale. Un contatto creato con un campo obbligatorio vuoto è peggio di nessun contatto, perché la sequenza di follow-up partirà su dati vecchi.
Comportamento in caso di errore: conteggio dei rifiuti e motivi registrati per campo, la dead-letter queue tiene il payload. Budget 100 ms.
Dedupe (Redis + fuzzy)
Input: evento validato.
Configurazione: corrispondenza deterministica su email e telefono. Corrispondenza fuzzy su nome azienda e dominio normalizzato. Redis con chiave normalizzata. Finestra di ricerca di 90 giorni. Merge con traccia scritta: campo, valore precedente, valore nuovo, motivo, timestamp, chi ha fatto il merge.
Regola: il record creato vince sempre sul record aggiornato per i campi di fonte. I campi modificati dall'utente non vengono mai sovrascritti dal re-ingresso.
Comportamento in caso di errore: scrittura in coda di revisione per le corrispondenze fuzzy vicine alla soglia, alert sui conflitti. Budget 100 ms.
Arricchimento
Input: evento deduplicato.
Configurazione: chiamate a provider in parallelo con timeout rigido. Dati firmografici, contesto intento, segnali tecnografici. Cache con TTL per dominio. Fallback ai dati già in cache se il provider è giù.
Regola: non bloccare la pipeline sull'arricchimento. Se il provider è lento, servi i dati in cache e continua. L'arricchimento migliora il record, non lo rende corretto.
Comportamento in caso di errore: circuit breaker aperto, serve la cache, alert. Budget 3000 ms.
Scoring
Input: evento arricchito.
Configurazione: un solo punteggio di fit e comportamento, da 0 a 100. Fit da dati firmografici e intento. Comportamento da azioni sulla pagina, engagement delle email e segnali di urgenza. Soglie di routing mappate al punteggio.
Regola: la distribuzione dei punteggi deve essere stabile a fronte di traffico stabile. Se si sposta, il traffico non è cambiato: è il modello.
Comportamento in caso di errore: punteggio basato su regole come fallback. Budget 400 ms.
Router
Input: evento con punteggio.
Configurazione: regole di territorio, carico e disponibilità in un solo passaggio. Conflitti risolti per punteggio o territorio. Coda manuale per i casi non risolti.
Regola: nessun lead resta senza proprietario. Se il router non risolve, il lead va in coda manuale con un alert, non in silenzio in un campo null.
Comportamento in caso di errore: risolutore di conflitti, poi coda manuale. Budget 250 ms.
Assegnazione
Input: evento instradato.
Configurazione: consegna a un rep o a una coda, avvia il timer SLA. Notifica prioritaria su Slack, SMS o email come canale di fallback. Conferma di ricezione tracciata.
Regola: il timer SLA parte al momento dell'assegnazione, non al momento della creazione. Misura il tempo di risposta del rep, non il tempo di elaborazione del sistema.
Comportamento in caso di errore: retry, poi dead-letter queue. Budget 300 ms.
Schema dello scenario Make.com
Sequenza di moduli in chiaro. Trattala come la forma della build. La configurazione sopra è quella che copi. Metti gestori di errore su ogni modulo che scrive.
1 Webhook (custom trigger) receives raw payload
2 HTTP: verify HMAC signature reject unsigned calls
3 Tools: set variable event_id, correlation_id, received_at
4 JSON: parse + schema validate required fields, types, enums
5 Router A: valid / invalid
5a Data store: append rejected dead-letter record with reason
5b Router B: match or new
6 Search: CRM contact by email
7 Search: CRM company by domain
8 Search: CRM open deals by contact
9 HTTP: Redis GET normalized key deterministic dedupe hit
10 HTTP: fuzzy score company/domain near match under threshold
11 Router C: create / update / conflict
11a HTTP: Clearbit enrich parallel, hard timeout
11b HTTP: Apollo enrich parallel, hard timeout
11c Tools: merge cached fallback
11d HTTP: scoring service 0 to 100 + routing label
11e Router D: territory + load + owner status
11f HTTP: conflict resolver ties and high-value leads
12 HTTP: CRM create or update idempotency key header
13 HTTP: CRM associate objects contact, company, deal, note
14 Data store: append audit row before, after, rule, owner
15 Slack: priority alert to rep
16 SMS / email: fallback channel
17 Error handler (attached to 4,9,11a,11b,11d,12,15)
-> HTTP: alert on-call
-> Data store: append failure with correlation_id
-> route to DLQ for replayMetti un token bucket davanti al CRM. Operazioni bulk contro un tetto di 100 richieste al minuto lanciano 429 nel momento in cui vai live con volume reale. Gestiscilo con concorrenza, backoff esponenziale e jitter invece di un semplice loop di retry.
Esempi di payload webhook
Cattura in ingresso (dalla sorgente al tuo endpoint)
{
"event_id": "sub_01HYT9C7M4",
"source_system": "tally",
"source_record_id": "audit_request",
"received_at": "2026-04-26T10:17:33.884Z",
"email": "[email protected]",
"phone": "+39 051 000 0000",
"full_name": "Elena Moretti",
"company_name": "Example Srl",
"company_domain": "example.com",
"budget_range": "5000_15000",
"urgency": "high",
"pain_summary": "Form submissions create duplicate contacts and never route to an owner.",
"consent_to_contact": true,
"utm_source": "linkedin",
"utm_campaign": "revops_q2",
"raw_payload_stored": true
}Contratto interno normalizzato (ogni sorgente mappa qui)
{
"event_id": "sub_01HYT9C7M4",
"correlation_id": "corr_lead_01HYT9C7M4",
"idempotency_key": "lead_intake:tally:audit_request:sub_01HYT9C7M4:[email protected]",
"source_system": "tally",
"source_record_id": "audit_request",
"email": "[email protected]",
"phone": "+39 051 000 0000",
"company_domain": "example.com",
"budget_range": "5000_15000",
"urgency": "high",
"pain_summary": "Form submissions create duplicate contacts and never route to an owner.",
"consent_to_contact": true,
"utm_source": "linkedin",
"utm_campaign": "revops_q2"
}Record post-fase (ciò che il CRM riceve)
{
"correlation_id": "corr_lead_01HYT9C7M4",
"dedupe": {
"match_type": "deterministic_email",
"existing_contact_id": "123456789",
"action": "update_existing"
},
"enrichment": {
"status": "cached",
"sources": ["clearbit", "apollo"],
"employees": 120,
"industry": "software"
},
"score": { "total": 82, "fit": 74, "behaviour": 90 },
"routing": {
"label": "sales_priority",
"rule": "budget_5000_15000_and_urgency_high",
"owner_id": "987654321",
"owner_status": "active",
"territory": "italy_north"
},
"controls": {
"queue": "crm_revenue_events",
"retry_policy": "exponential_backoff_with_jitter",
"dead_letter_queue": "crm_failed_workflow_events",
"replay_safe": true
}
}Budget di latenza
Misurato fase per fase invece di stimato alla fine. Ogni fase ha un tetto rigido. Se una fase supera il tetto, quello è l'alert.
| Fase | Budget (ms) | Misurato su | In caso di superamento |
|---|---|---|---|
| Gateway di cattura | 150 | Ingresso endpoint a evento normalizzato | Page se il p95 supera per 5 min |
| Validazione | 100 | Inizio controllo schema a passaggio o rifiuto | Registra i motivi di rifiuto, alert sul tasso |
| Lookup dedupe | 100 | Redis GET più confronto fuzzy | Alert sul tasso di cache miss |
| Arricchimento (con timeout) | 3000 | Inizio chiamata parallela a ultimo provider tornato | Circuit breaker, servi la cache |
| Scoring | 400 | Input assemblati a punteggio restituito | Punteggio basato su regole come fallback |
| Router | 250 | Inizio regole a proprietario risolto | Risolutore di conflitti, poi coda manuale |
| Assegnazione | 300 | Proprietario risolto a ack di scrittura CRM | Retry, poi dead-letter queue |
| Scrittura CRM | 900 | Richiesta API a risposta | Backoff, token bucket shed |
| Notifica | 400 | Ack di scrittura a provider accettato | Page on-call, non fare rollback |
| Dashboard readback | 200 | Scrittura a visibile sulla vista del rep | Warn, non bloccante |
| Retry e margine di coda | 2000 | Peggior caso di un singolo ciclo di retry | Dead-letter con correlation ID |
| Totale tipico | 7800 | Cattura ad assegnazione confermata | Tetto rigido 10000 |
Il margine fino al tetto è deliberato. Assorbe un ciclo di retry e una coda congestionata. Non è spazio per aggiungere fasi.
Soglie di alert
Le soglie sono configurazione. Impostale prima del lancio, scrivi a chi mandano la page, e rivedile dopo il primo mese di traffico reale.
| Segnale | Soglia | Finestra | Azione |
|---|---|---|---|
| Tasso di errore dell'endpoint di cattura | > 1% | 5 minuti | Page on-call, verifica la consegna del provider |
| Tasso di rifiuto dello schema | > 3% | 15 minuti | Alert, scarica i motivi di rifiuto per campo |
| Cattura ad assegnazione p95 | > 10000 ms | 15 minuti | Warn prima, page se sostenuto per 1 ora |
| p95 di fase sopra budget | > 1,5x budget | 15 minuti | Warn nominando la fase |
| Timeout provider di arricchimento | > 10% | 15 minuti | Apri il circuito, servi la cache, alert |
| Cache hit rate | < 60% | 1 ora | Warn, rivedi TTL e lista di warm-up |
| Record duplicati creati | > 0 per ora | 1 ora | Page, congela solo il passaggio di creazione |
| Proprietario o territorio non risolto | > 0 | 15 minuti | Instrada alla coda manuale, alert ops |
| Notifica non confermata | Primaria 60 s, secondaria 300 s | Per lead | Escala su per la catena automaticamente |
| Profondità dead-letter queue | > 0 per 10 minuti | 10 minuti | Page con payload e correlation ID |
| Risposte 429 del CRM | > 0 sostenuto | 5 minuti | Shed load, abbassa la concorrenza, alert |
Checklist di revisione settimanale
- Ogni item della dead-letter della settimana ha un proprietario e una decisione: replay, fix o drop.
- Le merge di duplicati riviste, ognuna registrata con i suoi input.
- Il conteggio delle escalation riveduto e confrontato con la settimana precedente.
- Il cache hit rate riveduto contro la lista di warm-up.
- Le soglie riviste contro il traffico reale.
Piano di rollout
| Finestra | Build | Criterio di uscita |
|---|---|---|
| Settimane 1 e 2 | Strumentazione e dedupe | Tempi di risposta di baseline misurati. Dedupe live sulla sorgente di lead a volume più alto. |
| Settimane 3 e 4 | Arricchimento e scoring | Provider collegati, cache riscaldata, scoring addestrato sulle tue conversioni storiche. |
| Settimana 5 | Routing e notifica | Regole di territorio, catene di escalation e alert Slack o SMS funzionanti end to end. |
| Settimane 6 a 8 | Test di carico e cutover | Test di carico a volume pieno e drill di fallimento, poi passaggio di tutte le sorgenti rimanenti. |
Ordine di build se non puoi fare tutto insieme
- Cattura e validazione. Un endpoint, un contratto, rifiuti visibili.
- Dedupe. Cercare prima di creare batte ogni pulizia a valle.
- Assegnazione e notifica. Anche un router rozzo batte nessun router.
- Percorso di fallimento. Dead-letter queue, correlation log, alert che fanno la page.
- Arricchimento e scoring. Aggiungi quando gli strati noiosi sono affidabili.
Le fasi sopra il percorso di scrittura proteggono il record. Arricchimento e scoring rendono il record più intelligente, non lo rendono corretto. Sistema prima la correttezza.
FAQ
Questo sostituisce il blueprint dei sistemi?
No. Il blueprint spiega l'architettura. Questo pacchetto è la versione costruibile. Porta le chiavi e l'ordine dei moduli, più i payload, i budget e le soglie.
Quali strumenti di orchestrazione assume?
Make.com per lo schema, visto che gestisce bene gli iteratori annidati e la gestione degli errori. Zapier, n8n e ricevitori API custom mappano agli stessi confini di fase.
E se il mio volume è piccolo adesso?
Mantieni gli stessi confini di fase. Riduci i budget, tieni la dead-letter queue. Il volume cambia il dimensionamento. La forma resta la stessa.
Dove entra l'AI?
Classificando il testo di pain disordinato, urgenza e fit nello scoring, con una lista chiusa di output ammessi e validazione sulla scelta. Il percorso di routing finale riceve comunque uno schema rigido.
Cosa succede dopo. Quando il pacchetto non basta, gli stessi sistemi vengono consegnati come engagement per clienti. Il lavoro copre build speed-to-lead, revisione di workflow CRM e API, sistemi di qualificazione lead e workflow di produzione monitorati.
Ottieni il workbook compilabile
Tutto quanto sopra è tuo da leggere. Il workbook aggiunge i worksheet vuoti, così li compili sul tuo stack con i tuoi proprietari, campi e fallimenti. Si apre in qualsiasi browser, su qualsiasi dispositivo, e salva mentre scrivi.
Quando vuoi il mio parere sul tuo stack, il questionario speed-to-lead richiede dieci minuti, e ti rispondo con la prima correzione che farei e quanto costa.