customerio-advanced-troubleshooting

name	customerio-advanced-troubleshooting
description	Apply Customer.io advanced debugging and incident response. Use when diagnosing complex delivery issues, investigating campaign failures, or running incident playbooks. Trigger: "debug customer.io", "customer.io investigation", "customer.io troubleshoot", "customer.io incident", "customer.io not delivering".
allowed-tools	Read, Write, Edit, Bash(curl:*), Bash(npx:*), Glob, Grep
version	1.14.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","customer-io","debugging","incident-response"]
compatibility	Designed for Claude Code, also compatible with Codex and OpenClaw

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

// 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, , ));

     start = .();
     {
       ..(userId, attrs);
       latency = .() - start;
      .();
       { : , latency };
    }  (: ) {
       latency = .() - start;
      .();
      .();
      .();
      .();
       { : , latency, : err., : err. };
    }
  }

   () {
    .();
    .(, .(data, , ));

     start = .();
     {
       ..(userId, { name, data });
       latency = .() - start;
      .();
       { : , latency };
    }  (: ) {
       latency = .() - start;
      .();
      .();
      .();
       { : , latency, : err. };
    }
  }
}