Corrispondenza dei contatti
La corrispondenza dei contatti riconosce automaticamente che due record in arrivo appartengono alla stessa persona reale — anche quando arrivano da canali diversi (numero WhatsApp, indirizzo e-mail, ID Instagram). Obiettivo: un unico record cliente per persona, niente duplicati.
Cos'è la corrispondenza dei contatti?
La corrispondenza dei contatti (spesso «identity resolution» o «rilevamento duplicati») è la logica che permette a una piattaforma di decidere: «Questo messaggio WhatsApp in arrivo dal +39 333 1234567 appartiene alla stessa persona della quale conosciamo già l'e-mail [email protected].» Il risultato è un record cliente unico, non un cimitero di mezzi profili.
Perché la corrispondenza è essenziale
Senza corrispondenza si finisce rapidamente qui:
- Anna è nella lista e-mail come [email protected]
- Anna è un contatto WhatsApp al +39 333 …
- Anna si è iscritta tramite form della newsletter come «Anna K.»
- Tre record, una sola persona reale — senza corrispondenza, vengono contattati tutti e tre separatamente.
Le conseguenze: messaggi marketing doppi, lifetime value calcolato male, cronologia di assistenza frammentata, problemi GDPR sulle richieste degli interessati.
Segnali di corrispondenza
Le piattaforme usano tipicamente questi identificatori:
| Segnale | Forza | Nota |
|---|---|---|
| Numero di telefono (formato E.164) | Molto forte | Univoco se formattato in modo uniforme. |
| Indirizzo e-mail | Molto forte | Univoco, ma capitano refusi. |
| ID di piattaforma (WhatsApp ID, Telegram ID, handle Instagram) | Molto forte | Emesso dal provider, immutabile. |
| Nome | Debole | Molte Anna nel sistema — utile solo in combinazione. |
Tre modalità a confronto
| Modalità | Cosa succede in collisione | Quando usarla |
|---|---|---|
| Fusione automatica (default) | Il contatto esistente viene aggiornato invece di crearne uno nuovo. Il contatto più vecchio rimane principale; i campi mancanti vengono completati. | Default per la maggior parte delle PMI. Restituisce un record cliente pulito senza lavoro manuale. |
| Consenti duplicati | Entrambi i contatti vengono creati. La piattaforma segnala nella risposta che possono esistere duplicati (lista di suggerimenti). | Raro — es. setup marketplace in cui ogni iscrizione è un account a sé. |
| Blocca duplicati | La piattaforma rifiuta la creazione (HTTP 409) e restituisce il contatto esistente. | Quando si vuole unicità rigorosa — es. nelle vendite B2B. |
Regole di fusione (cosa succede in una fusione)
- Il contatto più vecchio resta primario. Entrambi gli ID continuano a risolvere sul record sopravvissuto.
- Vincono i valori non vuoti. In conflitto decide la data di creazione più vecchia.
- Campi appiccicosi:
is_blockedeis_archivedrimangono «true» se uno dei due record li aveva — una fusione non deve mai sbloccare silenziosamente un contatto. - La cronologia migra: Conversazioni, messaggi, note, tag, campi personalizzati e metodi di contatto finiscono tutti sul sopravvissuto.
- Nota di sistema nell'audit log: Cosa è stato fuso, cosa era in conflitto — completamente documentato.
Cosa succede agli ID vecchi
Le integrazioni esterne, i webhook e i CRM spesso fanno riferimento a ID di contatto vecchi. Dopo una fusione quegli ID vecchi non devono fare 404. Soluzione: l'API risolve in modo trasparente il vecchio ID sul sopravvissuto, restituisce inoltre un campo merged_from e imposta un header X-Merged-Into. Le integrazioni esistenti non si rompono.
Caso limite di canale: primo contatto su un nuovo canale
Eccezione importante: quando arriva un messaggio WhatsApp per un numero di telefono già noto — ma il contatto non ha ancora un ID WhatsApp —, non si tratta di un duplicato. È un nuovo metodo di contatto sul contatto esistente. La fusione automatica si applica indipendentemente dalla modalità.
Fusione manuale
Non tutti i duplicati vengono rilevati automaticamente. Nomi foneticamente simili, nome/cognome invertiti, account separati di proposito — questi richiedono una fusione manuale. Una vista «Trova duplicati» mostra i candidati raggruppati per segnale di corrispondenza, con opzione di fusione bulk.
Corrispondenza dei contatti in SendSeven
SendSeven supporta tutte e tre le modalità (Fusione automatica come default, Consenti, Blocca), un override per richiesta tramite il campo duplicate_mode, fusione manuale nell'UI e tramite la REST API (POST /contacts/{id}/merge). I segnali di corrispondenza sono telefono, e-mail, ID di piattaforma e nome (come segnale debole nella lista di suggerimenti). Tutte le fusioni sono registrate nell'audit log; i vecchi UUID restano risolvibili.