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.

6segnali di fallimento, ognuno con la sua posizione di ricerca
4worksheet da compilare sul tuo stack
9sezioni, nell'ordine che fa la diagnosi

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.

01

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
FaseNomeCompitoTi dice quando è sbagliata
01CaptureAccetta una sola forma di evento da ogni sorgenteIl conteggio degli eventi cala o cambia la forma del payload
02ValidationScarta la spazzatura prima che diventi un recordIl tasso di scarto sale sopra la baseline
03DedupeCorrispondenza prima della creazione, merge con traccia scrittaI nuovi record schizzano a fronte di traffico stabile
04EnrichContesto firmografico e di intento in paralleloTimeout dei provider, calo del cache hit rate
05ScoringUn solo punteggio di fit e comportamento, da 0 a 100La distribuzione dei punteggi si sposta senza un cambio di traffico
06RouterTerritorio, carico e disponibilità in un solo passaggioProprietari non risolti, conflitti di territorio in coda
07AssignConsegna a un rep o a una coda, avvia il timer SLANotifica non confermata dentro la finestra
02

Guida di build fase per fase

01

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.

02

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.

03

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.

04

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.

05

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.

06

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.

07

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.

03

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 replay
Limiti di utilizzo

Metti 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.

04

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 } }
05

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.

FaseBudget (ms)Misurato suIn caso di superamento
Gateway di cattura150Ingresso endpoint a evento normalizzatoPage se il p95 supera per 5 min
Validazione100Inizio controllo schema a passaggio o rifiutoRegistra i motivi di rifiuto, alert sul tasso
Lookup dedupe100Redis GET più confronto fuzzyAlert sul tasso di cache miss
Arricchimento (con timeout)3000Inizio chiamata parallela a ultimo provider tornatoCircuit breaker, servi la cache
Scoring400Input assemblati a punteggio restituitoPunteggio basato su regole come fallback
Router250Inizio regole a proprietario risoltoRisolutore di conflitti, poi coda manuale
Assegnazione300Proprietario risolto a ack di scrittura CRMRetry, poi dead-letter queue
Scrittura CRM900Richiesta API a rispostaBackoff, token bucket shed
Notifica400Ack di scrittura a provider accettatoPage on-call, non fare rollback
Dashboard readback200Scrittura a visibile sulla vista del repWarn, non bloccante
Retry e margine di coda2000Peggior caso di un singolo ciclo di retryDead-letter con correlation ID
Totale tipico7800Cattura ad assegnazione confermataTetto rigido 10000

Il margine fino al tetto è deliberato. Assorbe un ciclo di retry e una coda congestionata. Non è spazio per aggiungere fasi.

06

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.

SegnaleSogliaFinestraAzione
Tasso di errore dell'endpoint di cattura> 1%5 minutiPage on-call, verifica la consegna del provider
Tasso di rifiuto dello schema> 3%15 minutiAlert, scarica i motivi di rifiuto per campo
Cattura ad assegnazione p95> 10000 ms15 minutiWarn prima, page se sostenuto per 1 ora
p95 di fase sopra budget> 1,5x budget15 minutiWarn nominando la fase
Timeout provider di arricchimento> 10%15 minutiApri il circuito, servi la cache, alert
Cache hit rate< 60%1 oraWarn, rivedi TTL e lista di warm-up
Record duplicati creati> 0 per ora1 oraPage, congela solo il passaggio di creazione
Proprietario o territorio non risolto> 015 minutiInstrada alla coda manuale, alert ops
Notifica non confermataPrimaria 60 s, secondaria 300 sPer leadEscala su per la catena automaticamente
Profondità dead-letter queue> 0 per 10 minuti10 minutiPage con payload e correlation ID
Risposte 429 del CRM> 0 sostenuto5 minutiShed 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.
07

Piano di rollout

FinestraBuildCriterio di uscita
Settimane 1 e 2Strumentazione e dedupeTempi di risposta di baseline misurati. Dedupe live sulla sorgente di lead a volume più alto.
Settimane 3 e 4Arricchimento e scoringProvider collegati, cache riscaldata, scoring addestrato sulle tue conversioni storiche.
Settimana 5Routing e notificaRegole di territorio, catene di escalation e alert Slack o SMS funzionanti end to end.
Settimane 6 a 8Test di carico e cutoverTest di carico a volume pieno e drill di fallimento, poi passaggio di tutte le sorgenti rimanenti.
08

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.
Perché quell'ordine

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.

09

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.

10

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.