instantly-observability

# Instantly Observability ## Overview Build monitoring and alerting for Instantly integrations. Covers campaign health checks, account warmup monitoring, webhook delivery tracking, deliverability alerts, and performance dashboards. Uses Instantly API v2 analytics endpoints combined with webhook events for real-time awareness. ## Prerequisites - Completed `instantly-install-auth` setup - API key with `campaigns:read`, `accounts:read`, and `all:read` scopes - Notification channel (Slack, email, PagerDuty, etc.) ## Instructions ### Step 1: Campaign Health Monitor ```typescript import { InstantlyClient } from "./src/instantly/client"; const client = new InstantlyClient(); interface HealthCheck { check: string; status: "ok" | "warning" | "critical"; message: string; } async function campaignHealthCheck(): Promise<HealthCheck[]> { const checks: HealthCheck[] = []; const campaigns = await client.campaigns.list(100); for (const campaign of campaigns.filter((c) => c.status === 1)) { // Active only const analytics = await client.campaigns.analytics(campaign.id); const sent = analytics.emails_sent || 1; // Bounce rate check (critical if > 5%) const bounceRate = (analytics.emails_bounced / sent) * 100; if (bounceRate > 5) { checks.push({ check: `bounce_rate:${campaign.name}`, status: "critical", message: `Bounce rate ${bounceRate.toFixed(1)}% exceeds 5% threshold. Campaign may be auto-paused.`, }); } else if...