customerio-advanced-troubleshooting

# Customer.io Advanced Troubleshooting ## Overview Advanced debugging techniques for complex Customer.io issues: systematic investigation framework, API debug client, user profile analysis, campaign/broadcast debugging, network diagnostics, and incident response runbooks. ## Prerequisites - Access to Customer.io dashboard (admin recommended) - Application logs access - `curl` for API testing ## Troubleshooting Framework For every issue, answer these five questions first: 1. **What** is the expected vs actual behavior? 2. **When** did the issue start? (Check deploy history, CIO status page) 3. **Who** is affected — one user, a segment, or everyone? 4. **Where** in the pipeline — API call, delivery, or rendering? 5. **How** often — every time, intermittent, or one-time? ## Instructions ### Step 1: API Debug Client ```typescript // lib/customerio-debug.ts import { TrackClient, APIClient, RegionUS } from "customerio-node"; export class DebugCioClient { private track: TrackClient; constructor() { this.track = new TrackClient( process.env.CUSTOMERIO_SITE_ID!, process.env.CUSTOMERIO_TRACK_API_KEY!, { region: RegionUS } ); } async debugIdentify(userId: string, attrs: Record<string, any>) { console.log(`\n--- Debug: identify("${userId}") ---`); console.log("Attributes:", JSON.stringify(attrs, null, 2)); const start = Date.now(); try { await this.track.identify(userId, attrs); const latency = Date.now() - start...