Turn Every
Customer Signal
into the Right Action

const response = await fetch('https://api.ceract.io/v1/events/track', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer YOUR_API_KEY'
  },
  body: JSON.stringify({
    user_id: 'usr_8k2p9x',
    event: 'order_completed',
    properties: {
      order_id: 'ord_44821',
      revenue: 149.99,
      currency: 'USD',
      products: [{ id: 'p_991', name: 'Pro Plan' }]
    },
    timestamp: '2026-04-20T09:14:22Z'
  })
});

const result = await response.json();
// { event_id: "evt_kx9...", journeys_triggered: 2, latency_ms: 11 }

{
  "event_id": "evt_kx9mzv2p",
  "status": "processed",
  "user_id": "usr_8k2p9x",
  "journeys_triggered": 2,
  "segments_updated": 3,
  "actions_fired": 1,
  "latency_ms": 11,
  "timestamp": "2026-04-20T09:14:22.011Z"
}

{
  "user_id": "usr_8k2p9x",
  "churn_risk": 0.81,
  "ltv_score": 0.74,
  "actions": [
    {
      "rank": 1,
      "action": "send_retention_offer",
      "channel": "push",
      "confidence": 0.87,
      "expected_uplift": "+23% conversion"
    },
    {
      "rank": 2,
      "action": "trigger_loyalty_reward",
      "channel": "email",
      "confidence": 0.71,
      "expected_uplift": "+14% engagement"
    }
  ],
  "latency_ms": 8
}

import ceract

client = ceract.Client(api_key="YOUR_API_KEY")

response = client.messages.sms.send(
    to="usr_8k2p9x",
    # or: to=["+254712345678"]
    body="Hi {{ first_name }}! Your {{ discount }}% offer expires tonight: {{ smart_link }}",
    personalisation={
        "first_name": "Sarah",
        "discount": 30
    },
    sender_id="MYAPP",
    track_clicks=True,
    opt_out_keyword="STOP"
)

print(response.message_id)  # msg_v9x2k...
print(response.status)     # "delivered"

curl -X POST https://api.ceract.io/v1/messages/push \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to": { "segment_id": "seg_highvalue_atrisk" },
    "notification": {
      "title": "{{ first_name }}, your reward is waiting 🎁",
      "body": "Claim your exclusive offer before midnight.",
      "image": "https://cdn.myapp.com/offer.jpg",
      "deep_link": "myapp://offers/exclusive",
      "actions": [
        { "id": "claim", "title": "Claim Now" },
        { "id": "remind", "title": "Remind me" }
      ]
    },
    "optimise_send_time": true
  }'

await ceract.identify({
  userId: 'usr_8k2p9x',
  traits: {
    name: 'Sarah Kim',
    email: 'sarah@example.com',
    phone: '+1-555-0100',
    plan: 'growth',
    company: 'Finova Inc',
    mrr: 3500,
    signup_date: '2025-11-01'
  }
});
// Returns: { user_id, segments_joined: 4, profile_updated: true }

response = client.journeys.trigger(
    journey_id="jrn_winback_vip",
    user_id="usr_8k2p9x",
    context={
        "trigger_reason": "manual_csm",
        "offer_variant": "30_pct_discount"
    }
)
# Returns: { enrollment_id, step: 1, next_action_at: "..." }

{
  "segments": [
    {
      "id": "seg_highvalue_atrisk",
      "name": "High Value At Risk",
      "member_count": 3218,
      "type": "ml_predictive",
      "last_evaluated": "2026-04-20T09:14:20Z",
      "update_frequency": "real_time"
    }
  ],
  "total": 44
}

{
  "user_id": "usr_8k2p9x",
  "scores": {
    "churn_probability": 0.81,
    "ltv_score": 0.74,
    "purchase_propensity": 0.62,
    "upsell_readiness": 0.48,
    "optimal_send_window": "18:00–20:00 local"
  },
  "model_version": "v4.2.1",
  "latency_ms": 6
}