Dedup příchozího kontaktu podle telefonu — notifikace odešla na starý e-mail a záznam „zmizel“ z přehledu
import { Aside } from ‘@astrojs/starlight/components’;
Symptom
Sekce “Symptom”Uživatel poslal z webu testovací poptávku pod novým jménem a novým e-mailem, ale se svým obvyklým telefonem. V CRM se objevila jako lead u sedm měsíců staré karty s cizím jménem, adresou „00000“ a starými doklady; potvrzovací e-mail přišel na starou adresu z karty, ne na tu z formuláře; a lead nebyl vidět v přehledu leadů vůbec. Dojem: „systém to znetvořil a leady chybí“.
Root cause
Sekce “Root cause”Tři správně fungující pravidla, která dohromady vytvořila matoucí výsledek:
- Dedup člověka jen podle telefonu/e-mailu (záměrně ne podle jména).
E-mail neseděl, telefon ano → poptávka šla ke staré kartě. Nový e-mail se
na kartu nezapsal, protože
email1už byl obsazený. - Automat potvrzení četl kontakt z karty (
client.email1), ne z payloadu poptávky. Při spárování podle telefonu je karta zastaralá. - Přehled filtruje podle stavu nadřazené entity: seznam leadů ukazuje jen leady kontaktů ve fázi „lead“. Stará karta už byla „klient“ (měla smlouvu a fakturu), takže nový lead v přehledu nebyl a detail přesměroval na kartu.
Druhá vrstva téhož: „chybí 700 záznamů“ byl rozdíl mezi nejvyšším číslem v číselné řadě a počtem řádků v přehledu — mezery po smazaných záznamech plus právě tyto filtrem skryté řádky. Nic se neztratilo.
Fix
Sekce “Fix”automat(leadId, { email, phone }) // kontakt z poptávky má přednost před kartouwebhook: spárováno podle telefonu && e-mail z poptávky není na kartě → doplnit do prvního volného slotu (email2/email3)Filtr přehledu zůstal (je to produktové rozhodnutí), ale počty z něj
vyloučených řádků se dají reportovat: max(číslo) − count(*) rozložit na
mezery po smazání, řádky skryté filtrem nadřazené entity a archiv.
Jak to poznat příště
Sekce “Jak to poznat příště”- „Chybí záznamy“: nejdřív porovnej počet příchozích requestů v access logu (status 2xx) s řádky import logu a s řádky entity po dnech. Když sedí, nic se neztratilo — hledej filtr nebo dedup.
- Notifikace na „špatný“ kontakt: hledej v automatu
entity.parent.emailmístopayload.email. - Testy na produkci dělej s telefonem i e-mailem, které v DB nejsou.
Test
Sekce “Test”Integrační test automatu: klient s email1 = starý, volání s
{ email: nový } → odesláno na nový, poznámka obsahuje nový; neplatný
override → fallback na kartu. Test webhooku: spárování podle telefonu +
jiný e-mail → update.email2 = nový, email1 nedotčen; stejný e-mail už
na kartě → žádný update.