bizbot API Reference

curl -X POST https://bizbottech.com/api/auth \
  -H "Content-Type: application/json" \
  -d '{"email":"you@example.com","password":"••••••••"}'

{
  "ok":    true,
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "email": "you@example.com",
  "plan":  "growth"
}

curl -X POST https://bizbottech.com/api/auth \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"action":"verify"}'

{
  "ok":     true,
  "valid":  true,
  "email":  "you@example.com",
  "plan":   "growth",
  "expiresAt": "2026-04-19T12:00:00Z"
}

curl -X POST https://bizbottech.com/api/lead-finder \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "industry": "plumbing",
    "location": "Austin, TX",
    "limit": 20
  }'

{
  "ok":    true,
  "count": 18,
  "leads": [
    {
      "businessName": "Austin Plumbing Co.",
      "ownerName":    "Mike Torres",
      "email":        "mike@austinplumbing.com",
      "phone":        "+15125550188",
      "score":        87,
      "source":       "organic"
    }
    // ... more leads
  ]
}

curl "https://bizbottech.com/api/lead-qualify?email=mike@austinplumbing.com&businessName=Austin+Plumbing+Co." \
  -H "Authorization: Bearer <token>"

{
  "ok":        true,
  "score":      82,
  "qualified":  true,
  "reasoning":  "Active business, valid email, strong industry fit",
  "signals":    ["verified_email", "has_website", "local_business"]
}

curl -X POST https://bizbottech.com/api/lead-quality-batch \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "leads": [
      { "email": "a@example.com", "businessName": "Acme HVAC" },
      { "email": "b@example.com", "businessName": "Blue Sky Electric" }
    ]
  }'

{
  "ok":      true,
  "scored":  2,
  "remaining": 23,  // free-tier monthly allowance
  "results": [
    { "email": "a@example.com", "score": 91, "qualified": true  },
    { "email": "b@example.com", "score": 64, "qualified": false }
  ]
}

curl -X POST https://bizbottech.com/api/chat \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "message": "What should I say to a lead who went cold after 2 weeks?",
    "sessionId": "sess_abc123"
  }'

{
  "ok":        true,
  "reply":     "Try a value-add re-engage: share a quick tip specific to their industry...",
  "sessionId": "sess_abc123",
  "tokens":    312
}

curl "https://bizbottech.com/api/pql-check" \
  -H "Authorization: Bearer <token>"

{
  "ok":           true,
  "nearLimit":   true,
  "usagePercent": 84,
  "features": {
    "chat":         { "used": 420, "limit": 500, "pct": 84 },
    "lead_scoring": { "used": 18,  "limit": 25,  "pct": 72 }
  },
  "upgradeUrl":   "https://bizbottech.com/pricing.html"
}

curl -X POST https://bizbottech.com/api/log-usage \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"feature":"lead_finder","action":"search","meta":{"industry":"plumbing"}}'

{
  "ok":        true,
  "logged":    true,
  "eventId":   "evt_8a3f2c...",
  "timestamp": "2026-04-18T09:15:00Z"
}

curl "https://bizbottech.com/api/health-score" \
  -H "Authorization: Bearer <token>"

{
  "ok":        true,
  "score":     74,
  "tier":      "healthy",  // "healthy" | "at_risk" | "critical"
  "signals": {
    "loginRecency":   10,
    "featureAdoption":8,
    "chatEngagement": 9,
    "leadActivity":   7,
    // ... 6 more signals
  },
  "updatedAt": "2026-04-18T06:00:00Z"
}

curl "https://bizbottech.com/api/churn-predict?threshold=70" \
  -H "Authorization: Bearer <token>"

{
  "ok":      true,
  "atRisk":  3,
  "clients": [
    {
      "email":           "client@example.com",
      "businessName":   "Sunset HVAC",
      "churnProbability":78,
      "healthScore":    31,
      "lastLogin":      "2026-04-04T10:00:00Z",
      "recommendation": "Schedule check-in call within 48 hours"
    }
  ]
}

curl -X POST https://bizbottech.com/api/zapier-webhook \
  -H "X-Zapier-Secret: <ZAPIER_WEBHOOK_SECRET>" \
  -H "Content-Type: application/json" \
  -d '{
    "event":  "new_lead",
    "name":   "Jane Smith",
    "email":  "jane@example.com",
    "source": "Typeform"
  }'

{
  "ok":        true,
  "event":     "new_lead",
  "processed": true,
  "bizbotId":  "a3f2b1c0-..."
}

curl -X POST https://bizbottech.com/api/zapier-webhook/subscribe \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"hookUrl":"https://hooks.zapier.com/hooks/catch/abc123/","event":"new_lead"}'

{
  "ok": true,
  "id": "hook_7f3a9c..."
}

curl "https://bizbottech.com/api/zapier-webhook/sample"

{
  "ok": true,
  "samples": {
    "new_lead":    { "event": "new_lead",    "name": "Jane Smith", "email": "jane@example.com" },
    "new_client":  { "event": "new_client",  "businessName": "Acme LLC", "email": "acme@example.com" },
    "contact_form":{ "event": "contact_form","name": "Bob Lee",     "email": "bob@example.com"  }
  }
}