T
TOMO
Developer Docs
BETA These docs are under partner review. Some features described are roadmap items, not yet shipped. Verify against your sandbox before relying on any contract.
● LIVEv1.0.0safety.subscribe_emergency_sos

safety.subscribe_emergency_sos — Full Intent Specification

INTENT NAMESPACE: safety
INTENT NAME:      subscribe_emergency_sos
FULL ID:          safety.subscribe_emergency_sos
VERSION:          v1.0.0
STATUS:           live
TTBS WEIGHTS:     time 0.30 · taste 0.10 · budget 0.15 · safety 0.45
LAST UPDATED:     2026-05-14

Subscription to a 24×7 personal-safety SOS service: panic button (in-app or wearable), GPS live-share, AI fall-detection, automatic kin notification, and partner CMS that hands off to 112 / police / ambulance / family on confirmation. Distinct from safety.subscribe_alarm_monitoring because: (a) the user is mobile, not a fixed site; (b) the trigger is a panic press / fall / SOS gesture, not a sensor; (c) the partner CMS verifies-then-escalates to 112 (government emergency dispatch in India); (d) wearable device (band / pendant / KaiOS phone) may be part of plan for elderly / minors; (e) recorded audio from device-microphone-on-trigger is the evidence loop. Subscription-grade, not one-shot.


1. NATURAL LANGUAGE COVERAGE

Classifies IN

  • "personal SOS service for my mother"
  • "panic button subscription"
  • "fall detection for elderly parents"
  • "Apple Watch SOS plus India service"
  • "Whypto / Smart24x7 / Helpline panic plan"
  • "wearable for elderly with help button"
  • "annual SOS subscription family"
  • "SOS pendant + 24x7 monitoring"
  • "auto-call kin on panic"
  • "share-location-with-kin emergency button"

Classifies OUT — borderline NO

  • "site alarm monitoring" → safety.subscribe_alarm_monitoring
  • "cyber insurance" → safety.subscribe_cyber_protection
  • "private ambulance" → safety.book_private_ambulance (one-shot dispatch)
  • "personal bodyguard" → safety.book_personal_security
  • "112 government app" → free; surface but not a subscription

MULTI-INTENT TRIGGERS

  • "SOS + cyber + alarm monitoring bundle" → 3 safety intents
  • "SOS pendant for elder + ambulance subscription" → safety.subscribe_emergency_sos + (private ambulance flow)
  • "SOS for teenager + cyberbullying cover" → safety.subscribe_emergency_sos + safety.subscribe_cyber_protection

2. INPUT — TOMO → PROVIDER

{
  "intent":          "safety.subscribe_emergency_sos",
  "intent_version":  "v1.0.0",
  "request_id":      "req_sos_5q8q_2026-05-14T18:00:00Z",
  "user_session_id": "anon_user_token_or_uid",

  "household": {
    "members": [
      {
        "name":            "Mother",
        "age_band":         "senior_70_plus",
        "fall_risk":         true,
        "phone_e164":        "+91XXXXXXXXXX",
        "device_preference": "pendant",
        "device_allowed":    ["app_only", "smartwatch", "pendant", "kaios_phone"]
      },
      {
        "name":            "Daughter",
        "age_band":         "minor",
        "fall_risk":         false,
        "phone_e164":        "+91XXXXXXXXXX",
        "device_preference": "smartwatch",
        "device_allowed":    ["app_only", "smartwatch", "pendant", "kaios_phone"]
      }
    ]
  },

  "kin_tree": [
    {"step": 1, "name": "Keerthi", "phone_e164": "+91XXXXXXXXXX", "ring_seconds": 30},
    {"step": 2, "name": "Spouse",  "phone_e164": "+91XXXXXXXXXX", "ring_seconds": 30}
  ],

  "monitoring_preference": {
    "tier":           "platinum",
    "tiers_allowed":  ["basic", "standard", "platinum"],
    "verify_protocol": "verify_then_escalate",
    "verify_protocols_allowed": ["escalate_immediately", "verify_then_escalate"],
    "audio_record_on_trigger": true,
    "audio_record_allowed": ["off", "trigger_only_60s", "trigger_only_5min"]
  },

  "billing": {
    "duration_months": 12,
    "duration_options": [12, 24, 36],
    "autopay_mandate": true
  },

  "data_consent": {
    "live_location_share_to_kin_on_trigger": true,
    "storage_region": "in",
    "regions_allowed": ["in"]
  },

  "user_constants": {
    "preferred_providers": ["Whypto", "Smart24x7", "Helpline Concept", "MyGuardian India"]
  }
}

Field rules

  • members[].fall_risk: true → fall-detection algorithm mandatory; partner enforces.
  • audio_record_on_trigger ∈ ENUM; user must explicitly opt in (DPDPA consent).
  • verify_protocol: escalate_immediately raises false-alarm risk; UI surfaces tradeoff.
  • members[].age_band STRICT ENUM.

3. PROVIDER TOOLS

sos.quote

Returns annual fee + device cost (if any) + helpline SLA.

sos.psara_verify

Returns partner CMS PSARA license.

sos.subscribe

Activates plan + member profiles + kin tree.

sos.device_ship

Ships pendant / smartwatch / KaiOS phone.

sos.test_trigger

Test SOS event end-to-end; CMS confirms within SLA.

sos.live_trigger

Production event — CMS receives panic + audio + GPS.

sos.escalate_112

CMS auto-co-dispatches 112 after verification.

sos.update_kin_tree

User edits kin.

sos.cancel

Pre-renewal cancel; partner refund per contract.


4. RESPONSE SHAPE

{
  "intent": "safety.subscribe_emergency_sos",
  "request_id": "req_sos_5q8q_2026-05-14T18:00:00Z",
  "options": [
    {
      "tier": "OK",
      "provider": "Smart24x7",
      "monitoring_tier": "basic",
      "annual_fee_inr_per_member": 1499,
      "members_covered": 2,
      "device_pendant_inr_one_time": 1200,
      "fall_detection_supported": false,
      "audio_record_on_trigger": false,
      "verify_protocol": "verify_then_escalate",
      "helpline_sla_minutes": 5,
      "psara_license_no": "PSA-MH-2017-XXXX",
      "psara_valid_until_iso": "2027-12-31",
      "storage_region": "in",
      "ttbs_score": 0.65,
      "tier_reason": "cheapest — basic, no fall detection"
    },
    {
      "tier": "GOOD",
      "provider": "Whypto",
      "monitoring_tier": "standard",
      "annual_fee_inr_per_member": 2999,
      "members_covered": 2,
      "device_pendant_inr_one_time": 1499,
      "device_smartwatch_inr_one_time": 4499,
      "fall_detection_supported": true,
      "audio_record_on_trigger": true,
      "audio_record_window": "trigger_only_60s",
      "verify_protocol": "verify_then_escalate",
      "helpline_sla_minutes": 3,
      "live_location_share_to_kin": true,
      "psara_license_no": "PSA-KA-2018-XXXX",
      "psara_valid_until_iso": "2028-09-30",
      "redundant_cms_site": true,
      "encrypted_signaling_e2e": true,
      "storage_region": "in",
      "ttbs_score": 0.86,
      "tier_reason": "balanced — fall detection + audio + redundant CMS"
    },
    {
      "tier": "GREAT",
      "provider": "MyGuardian India Premium",
      "monitoring_tier": "platinum",
      "annual_fee_inr_per_member": 4999,
      "members_covered": 2,
      "device_pendant_inr_one_time": 0,
      "device_smartwatch_inr_one_time": 0,
      "device_included": true,
      "fall_detection_supported": true,
      "audio_record_on_trigger": true,
      "audio_record_window": "trigger_only_5min",
      "verify_protocol": "verify_then_escalate",
      "helpline_sla_minutes": 1,
      "live_location_share_to_kin": true,
      "psara_license_no": "PSA-MH-2016-XXXX",
      "psara_valid_until_iso": "2029-12-31",
      "redundant_cms_site": true,
      "encrypted_signaling_e2e": true,
      "ambulance_partner_pre_alert": true,
      "dedicated_agent_per_member": true,
      "storage_region": "in",
      "ttbs_score": 0.93,
      "tier_reason": "device included + 1-min SLA + ambulance pre-alert"
    }
  ]
}

5. CONTROLLED VOCABULARIES

monitoring_tier

basic · standard · platinum

device_preference

app_only · smartwatch · pendant · kaios_phone

verify_protocol

escalate_immediately · verify_then_escalate

audio_record_window

off · trigger_only_60s · trigger_only_5min

member.age_band

minor · adult · senior_60_70 · senior_70_plus

storage_region

in (enforced)

All STRICT ENUM.


6. TTBS DIMENSIONS

TIME (weight 0.30)

  • Helpline SLA minutes
  • CMS-to-112 hand-off speed
  • Device pairing time at setup
  • TIME = helpline_sla × cms_handoff × pairing

TASTE (weight 0.10)

  • Brand familiarity
  • App + device UX
  • TASTE = brand × ux

BUDGET (weight 0.15)

  • Annual fee per member × members vs best
  • Device cost transparency (included vs add-on)
  • Multi-year discount honesty
  • BUDGET = 1 − (annual − best) / best

SAFETY (weight 0.45 — dominant)

  • PSARA license valid + state-aligned
  • Verify-then-escalate (false-alarm protection)
  • Fall detection supported when fall_risk: true
  • Audio record window honored
  • Encrypted signaling
  • Redundant CMS site (DR)
  • Storage region IN
  • 112 co-dispatch protocol
  • SAFETY = psara × verify × fall × audio × encrypted × redundant × region × dispatch

HARD FILTERS

  1. PSARA license valid + state-aligned.
  2. Fall detection if any member has fall_risk: true.
  3. Storage region in.
  4. Audio record window matches user consent.
  5. 112 co-dispatch protocol present.

7. COMPLETION CONTRACT

Success criteria

  1. Quote accepted; policy + members + kin tree captured.
  2. Devices shipped + paired.
  3. Test trigger end-to-end within SLA.
  4. Autopay mandate (if multi-year).
  5. Welcome pack: helpline number, app, member ID cards.
  6. CPC webhook fires.

CPC webhook

{
  "event": "safety.subscribe_emergency_sos.activated",
  "intent_id": "safety.subscribe_emergency_sos",
  "request_id": "req_sos_5q8q_2026-05-14T18:00:00Z",
  "subscription_id": "SOS-WP-2026-44129",
  "provider": "Whypto",
  "monitoring_tier": "standard",
  "members_covered": 2,
  "annual_fee_inr_total": 5998,
  "device_cost_inr_total": 5998,
  "tomo_commission_base_inr": 900,
  "tomo_commission_inr": 90,
  "pass_through_inr": 11096,
  "psara_license_no": "PSA-KA-2018-XXXX",
  "test_trigger_passed": true,
  "activated_at_iso": "2026-05-18T14:30:00+05:30",
  "signature_hmac_sha256": "…"
}

Failure cases

  • device_dead_on_arrival → DOA replacement.
  • test_trigger_failed → engineer revisit.
  • false_alarm_excessive → coaching; partner may surcharge.
  • autopay_mandate_failed → invoice fallback.
  • psara_lapse_during_term → user notified, contract paused or shifted.

8. WIDGET

{
  "widget": "EmergencySOSWidget",
  "header": {
    "members_strip": "2 members · Mother (70+, fall risk) + Daughter (minor)",
    "tier_strip":    "Standard · fall detection + audio 60s + verify-then-escalate",
    "data_strip":    "Stored in India · live location to kin on trigger"
  },
  "regions": {
    "region_1_intelligence": ["PSARA license valid 2028-09-30", "encrypted signaling", "redundant CMS", "audio only on panic, max 60s"],
    "region_2_summary": "Annual subscription per member · devices shipped within 3 days",
    "region_3_visual": "device_photo_url (partner-supplied, signed)",
    "region_4_now_pin": "Pay + ship — pairing in 10 minutes after delivery",
    "region_5_tomo_choices": [
      {"tier": "OK", "label": "Smart24x7 Basic · ₹1,499/member/yr + pendant ₹1,200", "reason": "cheapest"},
      {"tier": "GOOD", "label": "Whypto Standard · ₹2,999/member/yr + fall + audio + encrypted", "reason": "balanced"},
      {"tier": "GREAT", "label": "MyGuardian Premium · ₹4,999/member/yr · device included · 1-min SLA", "reason": "highest safety"}
    ]
  },
  "footer_disclosures": [
    "Verify-then-escalate means CMS first calls the user before dialing 112 — cuts false alarms but adds a few seconds.",
    "Audio record window is short and trigger-only — never always-on; partner stores per consent and you can wipe anytime.",
    "112 is the legal emergency channel — partner CMS hands off to it; police/ambulance reach you on their own SLA."
  ]
}

9. CACHING POLICY

  • Quote: 24h TTL.
  • PSARA license: 90d cache.
  • Member profile + kin tree: encrypted at partner; pointer at TOMO.
  • Device pairing token: never cached.
  • Past triggers: at partner per audit; pointer on-device 1 year.
  • Audio recordings: at partner; auto-delete per consent window (60s or 5min retention is at storage layer; full retention separate per dispute).

10. ERROR CODES

Code Meaning UI surface
ERR_PSARA_INVALID license lapsed Drop option
ERR_FALL_DETECTION_UNSUPPORTED flag set, partner can't Drop option
ERR_DEVICE_DOA device dead Replacement window
ERR_DEVICE_PAIR_FAILED pairing failed Engineer remote help
ERR_TEST_TRIGGER_FAILED CMS didn't receive Engineer revisit
ERR_AUTOPAY_FAILED mandate rejected Invoice fallback
ERR_FALSE_ALARM_THRESHOLD excess false alarms Coaching + surcharge
ERR_KIN_PHONE_UNREACHABLE kin contact bouncing Update contact
ERR_STORAGE_REGION_MISMATCH partner can't honor IN Drop option
ERR_PARTNER_OFFLINE partner API down Try next

11. SANDBOX → PRODUCTION CHECKLIST

  • Sandbox PSARA verify gate.
  • Sandbox fall-detection feature gate.
  • Sandbox audio-record window respected (60s vs 5min).
  • Sandbox test trigger end-to-end within SLA.
  • Sandbox 112 co-dispatch flow.
  • Sandbox Autopay mandate test across 3 banks.
  • Production PSARA database synced weekly per state.
  • Production audio-recording retention policy attested.
  • Production rate limit: 1 active SOS subscription / household.
  • Production CPC HMAC-SHA256 5-min replay verified.
  • Production data-deletion endpoint tested (user request).

12. ANTI-FABRICATION RULES

  • NO paid_placement on providers.
  • NO synthetic device photos.
  • NO "AI fall detection 100% accurate" claim — partner-attested threshold only.
  • NO bundling promo into annual fee.
  • NO always-on audio recording — trigger-only with user consent.
  • NO claim of police partnership — 112 is the escalation target.
  • NO TOMO-issued PSARA badge.
  • NO holding audio at TOMO.
  • NO synthetic encrypted-signaling claim.
  • NO marketing language ("smart SOS").

13. REGULATORY FRAMING

  • PSARA 2005 + state rules — CMS license per state of operation.
  • DPDPA 2023 — member profile + audio + kin tree + location = personal data; partner is processor.
  • IT Act 2000 §43A — reasonable security practices at CMS.
  • Telegraph Act 1885 — emergency dispatch via 112 (Police Emergency Number Service).
  • Aadhaar Act 2016 — TOMO does NOT collect Aadhaar; partner may with explicit consent.
  • CrPC — only police can detain/enter; partner CMS hands off escalation.
  • Consumer Protection Act 2019 — partner is service provider.
  • TOMO is router only — does NOT operate CMS, does NOT make devices, does NOT dispatch.