| name | ai-customer-churn-predictor | |
|---|---|---|
| title | AI Customer Churn Predictor | |
| description | AI Customer Churn Predictor - analyze call/message patterns via Telnyx APIs, AI predicts churn risk and suggests interventions. | |
| language | python | |
| framework | flask | |
| telnyx_products | ||
AI Customer Churn Predictor - analyze call/message patterns via Telnyx APIs, AI predicts churn risk and suggests interventions.
AI Inference:POST /v2/ai/chat/completions
API Request
│
▼
┌──────────────────┐
│ Your App │
└────────┬─────────┘
│
├──► Telnyx AI Inference
│
├──► Classification / triage
│
▼
JSON response
Copy .env.example
to .env
and fill in:
| Variable | Type | Example | Required | Description | Where to get it |
|---|---|---|---|---|---|
TELNYX_API_KEY |
|||||
string |
|||||
KEY0123456789ABCDEF |
|||||
| yes | |||||
| Telnyx API v2 key | |||||
AI_MODEL
string
moonshotai/Kimi-K2.6
PortalPORT
integer
5000
git clone https://github.com/team-telnyx/telnyx-code-examples.git
cd telnyx-code-examples/ai-customer-churn-predictor-python
cp .env.example .env # ← fill in your credentials
pip install -r requirements.txt
python app.py # starts on http://localhost:5000
Triggers predict
curl -X POST http://localhost:5000/predict \
-H "Content-Type: application/json" \
-d '{}'
Response:
{
"id": "item-1750280400",
"status": "created",
"created_at": "2026-07-15T14:30:00Z"
}
Triggers batch
curl -X POST http://localhost:5000/predict/batch \
-H "Content-Type: application/json" \
-d '{}'
Response:
{
"id": "item-1750280400",
"status": "created",
"created_at": "2026-07-15T14:30:00Z"
}
Returns predictions
curl http://localhost:5000/predictions
Response:
{
"items": [
{
"id": "item-001",
"status": "active",
"created_at": "2026-07-15T14:30:00Z"
}
]
}
Returns health
curl http://localhost:5000/health
Response:
{
"status": "ok",
"uptime_seconds": 3842,
"active_sessions": 2,
"version": "1.0.0"
}
| Issue | Cause | Fix |
|---|---|---|
401 Unauthorized |
||
| Invalid or missing API key | Verify TELNYX_API_KEY in .env matches your key in the |
|
| Webhook not received | Local server not publicly reachable | Expose it with a tunnel (e.g. ngrok) and set the webhook URL in the |
422 Unprocessable Entity
AI After Hours Emergency Triage (Python)AI Assistant Knowledge Base (Python)AI Assistant Multi Tool (Python)AI Assistant Phone Setup (Python)AI Audiobook Narrator (Python)
Telnyx is an AI Communications Infrastructure platform - voice, messaging, SIP, AI, and IoT on one private, global network.
source & further reading
github.com — original article