Setting Up Biometric Alerts

Your body often knows you're at risk before your mind does. Whistl's biometric integration monitors stress, sleep, and heart rate to detect physiological states associated with gambling impulses. This guide shows you how to connect Apple Health or Oura Ring and configure alerts that protect you when your body signals vulnerability.

Why Biometrics Matter for Gambling

Research shows strong connections between physiological states and gambling behaviour:

• Low HRV (Heart Rate Variability): 73% of users show elevated gambling risk when HRV is low
• Poor sleep: Less than 6 hours sleep increases impulsivity by 47%
• Elevated stress: Stress is the #1 trigger for 72% of problem gamblers
• High resting heart rate: Indicates physiological arousal linked to urges

By monitoring these signals, Whistl can intervene before you consciously recognise you're at risk.

Supported Biometric Sources

Whistl integrates with these health platforms:

Apple Health (iOS)

• Required: iPhone with iOS 15+
• Optional: Apple Watch for continuous monitoring
• Data types: Heart rate, HRV, sleep, stress, activity
• Privacy: All data processed on-device

Oura Ring

• Required: Oura Ring (Gen 2 or Gen 3)
• App: Oura app must be installed
• Data types: Sleep, readiness, HRV, resting heart rate
• Privacy: Data accessed via Oura API, stored encrypted

Step 1: Connect Apple Health

Connection Process

1. Open the Whistl app
2. Tap Settings → Health Integration
3. Tap Connect Apple Health
4. Review the data types Whistl requests
5. Tap Allow to grant permissions
6. Return to Whistl—connection is complete

Required Permissions

Whistl requests access to these health metrics:

• Heart Rate: Real-time and resting heart rate
• Heart Rate Variability: HRV measurements
• Sleep Analysis: Sleep duration and quality
• Resting Heart Rate: Baseline heart rate
• Stress Level: Derived from HRV and heart rate

Note: Whistl only reads data—it never writes to Apple Health.

Step 2: Connect Oura Ring (Optional)

Connection Process

1. Go to Settings → Health Integration
2. Tap Connect Oura
3. You'll be redirected to Oura login
4. Enter your Oura credentials
5. Grant Whistl permission to access your data
6. Return to Whistl—sync begins automatically

Oura Data Types

• Sleep Score: Overall sleep quality (0-100)
• Readiness Score: Recovery and readiness (0-100)
• HRV Balance: Heart rate variability trends
• Resting Heart Rate: Daily RHR
• Sleep Stages: Deep, REM, light sleep breakdown

Step 3: Configure Biometric Alerts

Set thresholds that trigger protective interventions:

Heart Rate Variability (HRV) Alerts

Sleep Alerts

Stress Level Alerts

Step 4: Set Alert Timing

Configure when biometric alerts are active:

Timing Options

• 24/7 monitoring: Always active (recommended)
• High-risk hours only: e.g., 6pm-2am when gambling risk is highest
• Weekend only: Saturdays and Sundays
• Custom schedule: Set your own hours

Alert Frequency

• Immediate: Alert as soon as threshold crossed
• Delayed (15 min): Wait to confirm sustained condition
• Summary only: Include in daily summary, no immediate alert

How Biometric Alerts Work in Practice

Example Scenario: Poor Sleep

1. You slept only 4.5 hours last night
2. Apple Health/Oura records sleep data
3. Whistl reads data during morning sync
4. Alert triggers: "You had poor sleep last night. Your impulse control may be reduced today."
5. SpendingShield automatically moves to YELLOW state
6. AI Coach sends supportive message with coping tips
7. Partner receives optional notification if configured

Example Scenario: Elevated Stress

1. Your Apple Watch detects elevated heart rate and low HRV
2. Whistl calculates stress level as "High"
3. Alert triggers: "I notice you're stressed. This is a common trigger. Want to talk about it?"
4. Alternative actions suggested (breathing exercise, walk, call friend)
5. If you're near a gambling venue, protection increases to ORANGE

Biometric Risk Score Integration

Biometric data contributes to your overall risk score:

Risk Score Contribution

Combined biometric signals can increase risk score by 0.20-0.40 during vulnerable periods.

Privacy and Data Security

Your health data is highly sensitive. Whistl protects it:

Privacy Protections

• On-device processing: Biometric data never leaves your phone
• Encrypted storage: All health data encrypted at rest
• Minimal access: Only reads, never writes to Health
• No sharing: Health data never shared with third parties
• Easy deletion: Disconnect anytime, data deleted immediately

What Whistl Does NOT Do

• Does NOT upload health data to servers
• Does NOT share with insurance companies
• Does NOT sell to data brokers
• Does NOT use for advertising
• Does NOT retain after account deletion

Troubleshooting Biometric Integration

Problem: No Data Appearing

Solutions:

• Ensure Apple Health has data from your devices
• Check Whistl permissions in Health app settings
• Force sync by pulling down on Health Integration screen
• Restart iPhone and try again
• Ensure Apple Watch is paired and syncing (if using)

Problem: Alerts Too Frequent

Solutions:

• Increase threshold values (e.g., alert at <25ms HRV instead of <30ms)
• Change alert timing to high-risk hours only
• Switch from immediate to delayed alerts
• Disable specific biometric alerts you don't find helpful

Problem: Oura Not Syncing

Solutions:

• Ensure Oura app is updated to latest version
• Check Oura ring is charged and syncing to app
• Reconnect Oura in Whistl settings
• Check Oura API status (rare outages occur)

Problem: Battery Draining

Solutions:

• Biometric sync uses minimal battery (<1%/day)
• Reduce sync frequency in settings
• Disable continuous heart rate if not needed
• Check for other apps draining battery

Biometric Alert Best Practices

• Start conservative: Begin with stricter thresholds, relax if too sensitive
• Review weekly: Check which alerts were helpful vs. noise
• Combine with other signals: Biometrics work best with location and financial data
• Don't ignore alerts: When biometric alert triggers, pause and check in with yourself
• Use as early warning: Biometrics often change before conscious urges

Biometric Data Accuracy

Understanding limitations helps set realistic expectations:

Accuracy by Source

Conclusion

Biometric alerts add a powerful physiological dimension to Whistl's protection. By detecting stress, fatigue, and arousal before you consciously recognise them, biometric integration gives you a head start on managing impulses. Set up takes just 5 minutes but provides 24/7 insight into your body's warning signals.

Related: Apple HealthKit Setup | Risk Score Dashboard | 27 Risk Signals