Client Rescue AI

🔐 Authentication

All API requests require authentication using Bearer tokens. Include your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY_HERE

⭐ Core Churn Risk Analysis

Our primary endpoint combines GPT-4o intelligence with multi-factor analysis to predict client churn probability and recommend specific rescue actions.

{
  "client_id": "12345",
  "messages": [
    "I am very frustrated with the recent changes to your service",
    "This is completely unacceptable and I am considering switching"
  ],
  "payments": [true, false, true],
  "response_times": [24, 48, 72]
}

{
  "client_id": "12345",
  "churn_probability": 85,
  "risk_factors": {
    "emotion": "High frustration and dissatisfaction with service changes",
    "behavior": "Delayed response time indicates potential disengagement", 
    "payment": "Missed payment suggests financial instability or dissatisfaction"
  },
  "rescue_urgency": "High",
  "recommended_action": "Immediately reach out to the client with a personalized apology and offer a solution or incentive to address their concerns and retain their business.",
  "analysis_timestamp": "2025-06-29T22:23:30.209Z",
  "confidence_score": 0.9
}

🔗 All API Endpoints

{
  "status": "healthy",
  "timestamp": "2025-06-29T22:00:00.000Z",
  "uptime": 3600
}

{
  "api": "operational",
  "services": {
    "openai": "configured",
    "stripe": "configured"
  },
  "timestamp": "2025-06-29T22:00:00.000Z"
}

{
  "content": "I am really happy with your service and would recommend it to others"
}

{
  "success": true,
  "analysis": {
    "sentiment": "positive",
    "score": 95,
    "confidence": 0.95,
    "keywords": ["happy", "recommend", "service"],
    "riskFactors": []
  },
  "timestamp": "2025-06-29T22:00:00.000Z"
}

{
  "clientName": "John Smith",
  "riskLevel": "high",
  "reasons": ["missed payments", "delayed responses"],
  "context": "Client has been unresponsive lately"
}

{
  "success": true,
  "response": {
    "subject": "Urgent: Let's Resolve Your Account Concerns Together",
    "content": "Dear John,\n\nI hope this message finds you well. I've noticed that we've missed connecting recently, and I wanted to reach out personally to address any concerns you might have...",
    "tone": "Empathetic and resolution-focused",
    "urgency": "high"
  },
  "timestamp": "2025-06-29T22:00:00.000Z"
}

{
  "user": "api-user@clientrescue.ai",
  "tier": "starter",
  "requests_today": 142,
  "rate_limit": 5000,
  "remaining": 4858,
  "reset_time": "2025-06-30T22:00:00.000Z"
}

📦 Official Client Libraries

Use our official SDKs for faster integration and better developer experience:

pip install client-rescue-ai

npm install client-rescue-ai

Quick Example with SDKs

Python

from client_rescue_ai import ClientRescueAI

client = ClientRescueAI('your-api-key')
result = client.analyze_churn_risk(
    client_id='12345',
    messages=['I\'m frustrated with recent changes'],
    payments=[True, False, True],
    response_times=[24, 48, 72]
)

print(f"Churn Probability: {result.churn_probability}%")
print(f"Action: {result.recommended_action}")

Node.js

const { ClientRescueAI } = require('client-rescue-ai');

const client = new ClientRescueAI('your-api-key');
const result = await client.analyzeChurnRisk({
  clientId: '12345',
  messages: ['I\'m frustrated with recent changes'],
  payments: [true, false, true],
  responseTimes: [24, 48, 72]
});

console.log(`Churn Probability: ${result.churnProbability}%`);
console.log(`Action: ${result.recommendedAction}`);

💻 Raw API Examples

JavaScript/Node.js

// Core churn risk analysis
const response = await fetch('/api/v1/churn-risk', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    client_id: '12345',
    messages: [
      'I am frustrated with the recent changes',
      'Considering switching to a competitor'
    ],
    payments: [true, false, true],
    response_times: [24, 48, 72]
  })
});

const analysis = await response.json();
console.log(`Churn Probability: ${analysis.churn_probability}%`);
console.log(`Urgency: ${analysis.rescue_urgency}`);
console.log(`Action: ${analysis.recommended_action}`);
console.log(`Confidence: ${analysis.confidence_score}`);

Python

import requests

# Churn risk analysis with Python
response = requests.post('/api/v1/churn-risk', 
  headers={
    'Authorization': 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  json={
    'client_id': '12345',
    'messages': [
      'Very disappointed with recent service changes',
      'Looking at other options now'
    ],
    'payments': [True, False, True],
    'response_times': [24, 48, 72]
  }
)

analysis = response.json()
print(f"Churn Probability: {analysis['churn_probability']}%")
print(f"Urgency Level: {analysis['rescue_urgency']}")
print(f"Recommended Action: {analysis['recommended_action']}")

# Check confidence level
if analysis['confidence_score'] > 0.8:
    print("High confidence prediction - take immediate action!")
else:
    print("Medium confidence - monitor closely")

cURL

curl -X POST /api/v1/churn-risk \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "12345",
    "messages": [
      "Very frustrated with the recent changes",
      "This is completely unacceptable"
    ],
    "payments": [true, false, true],
    "response_times": [24, 48, 72]
  }' | jq .

💰 Pricing & Plans

🛠️ Support & Resources

HTTP Status Codes