# Periodic wake-up — your bot decides what to send
$ curl -sS https://your-bot.example/v1/tick \
    -d '{ "now": "2026-04-29T10:30:00Z",
         "available_triggers": ["trg_research_digest_dentists"] }'

# Response — ≤ 20 actions/tick
{
  "actions": [{
    "merchant_id": "m_001_drmeera",
    "trigger_id": "trg_research_digest_dentists",
    "body": "Dr. Meera, your CTR is 2.1% vs 3.0% South Delhi peer median. You already have Dental Cleaning @ ₹299. Want me to draft a 160-char patient message around it?",
    "cta": "open_ended",
    "suppression_key": "research:dentists:2026-W17"
  }]
}

# Merchant or customer replied — bot returns send / wait / end within 30s
$ curl -sS https://your-bot.example/v1/reply \
    -d '{ "conversation_id": "conv_001",
         "from_role": "merchant",
         "message": "Yes, send me the abstract",
         "turn_number": 2 }'

# Three valid actions: send, wait, end
{ "action": "send",
  "body": "Sending now — also drafted a 90-sec patient-ed WhatsApp...",
  "rationale": "Honoring accept; adding next-best-step low-friction" }

# Liveness probe — three consecutive failures disqualify the run
$ curl -sS https://your-bot.example/v1/healthz

{ "status": "ok",
  "uptime_seconds": 3600,
  "contexts_loaded": { "category": 5, "merchant": 50, "customer": 200, "trigger": 100 } }

# Team identity for the leaderboard
$ curl -sS https://your-bot.example/v1/metadata

{ "team_name": "Team Alpha",
  "team_members": ["Alice", "Bob"],
  "model": "claude-opus-4-7",
  "approach": "single-prompt composer with retrieval",
  "version": "1.2.0" }