Update runbook: /api/lead → NPH funnel wire is done + verified

66d30ecdaca457133331d2de304722a847ad9dfc · 2026-05-31 17:13:41 -0700 · steve

Files touched

M DEPLOY.md

Diff

commit 66d30ecdaca457133331d2de304722a847ad9dfc
Author: steve <steve@designerwallcoverings.com>
Date:   Sun May 31 17:13:41 2026 -0700

    Update runbook: /api/lead → NPH funnel wire is done + verified
---
 DEPLOY.md | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/DEPLOY.md b/DEPLOY.md
index 0c433ce..7412d2b 100644
--- a/DEPLOY.md
+++ b/DEPLOY.md
@@ -35,7 +35,16 @@ ssh my-server 'cd /root/Projects/wallpapercontractor && pm2 start server.js --na
 # certbot --nginx -d wallpapercontractor.com -d www.wallpapercontractor.com
 ```
 
-## Lead handling
-`POST /api/lead` — confirm where leads are routed (email/DB/CRM) before launch so the
-`/find-installer` form doesn't drop submissions. Wire to the same destination as the
-nationalpaperhangers booking funnel if appropriate.
+## Lead handling — WIRED ✅ (2026-05-31)
+`POST /api/lead` validates + captures the lead locally to `data/leads.jsonl`
+(gitignored — customer PII never enters git), then returns a `redirect` into the
+**nationalpaperhangers funnel**: `https://nationalpaperhangers.com/find?...` with the
+project segment mapped (`residential|multifamily→luxury_residential`,
+`hospitality→hospitality`, `retail→retail`; corporate/healthcare omit segment → full
+breadth) plus UTM attribution + `lead_id`. Verified: residential lead → `/find?...&segment=luxury_residential` → 200 live.
+
+- NPH has **no generic lead-intake API** (its funnel is `/find` → `/installer/:slug` →
+  `POST /api/installers/:slug/book`), so the integration is funnel-redirect + local
+  capture, not a server-to-server lead POST.
+- **Optional follow-up:** if you want NPH *ops* to be emailed each contractor lead, that
+  needs a small new endpoint on NPH (none exists today) — say the word and I'll add it.

← b8a8f85 gitignore + untrack data/leads.jsonl — customer lead PII mus · back to Wallpapercontractor · Notify NPH ops on each lead: fire-and-forget POST to /api/pa d0fa59a →