Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.tuco.ai/llms.txt

Use this file to discover all available pages before exploring further.

Spam Monitoring

Monitor your lines for spam risk based on delivery failure rates and consecutive failures.

API

GET /api/lines/spam-monitor
Response:
{
  "lines": [
    {
      "lineId": "abc123",
      "linePhone": "+19045551234",
      "lineType": "phone",
      "totalSentLast24h": 150,
      "failedLast24h": 3,
      "failureRate": 2.0,
      "consecutiveFailures": 0,
      "spamRisk": "low",
      "recommendation": "Line is healthy."
    }
  ]
}

Risk Levels

RiskFailure RateAction
Low< 5%No action needed
Medium5-15%Reduce send volume by 50%, monitor 24h
High> 15%Pause campaigns immediately, wait 24-48h

Automated Alerts

The health check cron calculates failure rates and logs events to Loki:
Loki: {service="workers-*"} |= "line.spam_risk.high"
Loki: {service="workers-*"} |= "line.spam_risk.medium"
Line-down email alerts are sent automatically after 7 consecutive failures.