customerio-webhooks-events

# Customer.io Webhooks & Events ## Overview Implement Customer.io reporting webhook handling: receive real-time delivery events (sent, delivered, opened, clicked, bounced, complained, unsubscribed), verify HMAC-SHA256 signatures, process events reliably with queuing, and stream to a data warehouse. ## How Reporting Webhooks Work ``` Customer.io Your Server Data Warehouse ────────── ─────────── ────────────── Email sent → POST /webhooks/cio → Verify signature Email opened → POST /webhooks/cio → Parse event type Link clicked → POST /webhooks/cio → Route to handler → INSERT INTO events Email bounced → POST /webhooks/cio → Suppress user ``` Configure at: Data & Integrations > Integrations > Reporting Webhooks ## Prerequisites - Public HTTPS endpoint for webhook receiver - Webhook signing key from Customer.io dashboard - Express or similar HTTP framework ## Instructions ### Step 1: Define Webhook Event Types ```typescript // types/customerio-webhooks.ts // Customer.io reporting webhook event metrics type CioMetric = | "sent" // Message sent to delivery provider | "delivered" // Delivery provider confirmed receipt | "opened" // Recipient opened the email | "clicked" // Recipient clicked a link | "converted" // Recipient completed a conversion goal | "bounced" // Email bounced (hard or soft) | "spammed" // Recipient marked as spa...