WHOOP

Ray can pull your data directly from WHOOP. This matters because of how WHOOP shares data with Apple Health: when you wear a WHOOP band, WHOOP decides what reaches your phone — and it deliberately holds back HRV and reports only the energy from WHOOP-tracked workouts. So if Ray reads your data through Apple Health, a lot of what makes WHOOP useful never arrives. (With an Apple Watch, Apple Health gets the full picture — this gap is specific to relying on a third-party wearable like WHOOP.) Connecting WHOOP to Ray closes that gap: Ray reads your recovery, HRV, sleep, and full daily energy straight from the source.

Best of all, there’s nothing to install. No Shortcuts, no webhook URLs — just one tap and a quick sign-in.

What gets synced

Channel	Fields
🛌 Recovery	HRV, resting heart rate, recovery state
🛌 Sleep	sleep duration
📈 Activity	daily energy burned, strain

Once data arrives, Ray uses it in every recommendation. Ask “What’s my HRV trend this week?” or “Am I recovered enough to train hard today?” and Ray will answer from your real WHOOP numbers.

Connect WHOOP

1. Open the Integrations hub in the bot.

   Go to ⚙️ Settings → 🔌 Integrations, then tap ⌚ WHOOP.

2. Tap ⌚ Connect WHOOP.

   Your browser opens WHOOP’s sign-in page.

3. Sign in and approve.

   Log in with your WHOOP account and tap Approve to let Ray read your data. You’ll see a ✅ WHOOP connected page — tap Back to Ray to return to Telegram.

That’s it. Ray immediately backfills your last week of data, then keeps it fresh automatically — there’s no automation to set up and nothing to run by hand.

Confirm the data is flowing

Open ⚙️ Settings → 🔌 Integrations again. With WHOOP connected, the hub shows it as your active source along with a recent Last sync time. As a final check, ask Ray “What was my recovery this morning?” — if the numbers match your WHOOP app, you’re all set.

What Ray can (and can’t) see

Ray asks WHOOP for only four permissions, and they’re the minimum needed to coach you:

• Recovery — HRV and resting heart rate
• Sleep — how long you slept
• Cycles — your daily strain and energy
• Offline access — so Ray can keep syncing in the background without you signing in again

Ray does not request access to your name, email, or profile. You can revoke access at any time, either from inside Ray or from your WHOOP account settings.

WHOOP becomes your single source

To avoid mixing numbers from two devices, Ray uses one active data source at a time. While WHOOP is connected it’s your active source, and any Apple Health uploads are ignored. Disconnecting WHOOP hands the active role back to Apple Health if you’ve set it up — otherwise no source stays connected. Data already synced is kept either way.

Switch back or disconnect

To stop using WHOOP, open ⚙️ Settings → 🔌 Integrations → ⌚ WHOOP → ⌚ Disconnect WHOOP and confirm. Ray revokes its access at WHOOP and stops pulling new data. If you have Apple Health set up, Ray switches to it; otherwise no source stays connected (Ray won’t assume Apple Health — handy if you’re on Android). Your previously synced recovery and activity history stays in place.