Troubleshooting
The most common problems, and how to fix them yourself. Still stuck? Write to whoever invited you.
On this page
- The bot doesn’t answer
- “First finish the setup above”
- A reminder didn’t arrive
- I missed a question, or answered it wrong
- “This link has expired”
- Garmin or WHOOP stopped syncing
- Connecting an Android phone
- The phone stopped sending, or some data is missing
- A Fitbit sends nothing
- Connecting an iPhone or Apple Watch
- Claude’s sign-in code doesn’t work
- Claude doesn’t use my data
- Two sources show different numbers
- Times are off by an hour or more
- No AI insights
- “Send to a friend” shows no invite card
The bot doesn’t answer
Send /start. If the bot is already set up it says so; otherwise it carries on with the setup.
If nothing comes back at all, the server may be restarting for an update. Try again in a few minutes.
“First finish the setup above”
Commands wait until the setup is done (except /start, /help and /delete_me). Answer the step you’re on, or send /start to bring it back if it scrolled away.
A reminder didn’t arrive
- Check your timezone in
/settings. Reminders come at their time in that timezone. - Check quiet hours in
/settings. A reminder that falls inside them waits until they end. - Check the reminder in
/reminders. It may be ⏸ Paused, or set to other days.
I missed a question, or answered it wrong
/log lets you log or change any answer for today or any of the last 7 days. The new answer replaces the old one for that day.
“This link has expired”
The bot’s web links (connecting Garmin or WHOOP, detecting your timezone) work once, for 15 minutes. Ask for a fresh one: /connect for a watch, /settings for the timezone.
Garmin or WHOOP stopped syncing
Their sign-ins expire every so often, and after a password change. Open /connect and tap 🔗 Reconnect. It takes a minute, and the data you already have stays.
Connecting an Android phone
Open /connect → 📱 Android and open the setup page on your Android phone; the link works once, for 15 minutes. It walks you through:
- Installing HC Webhook from Google Play (free and open-source).
- Downloading your settings file, and importing it in HC Webhook: Settings → Settings backup → Import.
- Allowing access (and background access), then 🔄 Sync now.
Already paired the bot’s earlier Android app with a code? It keeps working.
The phone stopped sending, or some data is missing
- HC Webhook syncs by itself every hour. On its Home screen, allow background access if it asks.
- If it warns about battery saving, let it run in the background: some phones stop background apps otherwise.
- A kind of data that never arrives needs its device’s app (Samsung Health, Oura, Withings…) to share with Health Connect. Turn that on in the device’s app.
- Its Test button checks the connection: the bot replies in Telegram (the test data isn’t stored). Sync now sends your data at once.
A Fitbit sends nothing
Allowing Fitbit in Health Connect isn’t enough: the Fitbit app (now called Google Health) also has to send its data.
- Open Google Health, tap the settings gear (or your profile picture first), then Health Connect.
- Under “What data would you like to sync?”, tick Fitness and wellness data and tap Continue.
- Pull down in Google Health to sync with the watch, then tap Sync now in HC Webhook.
Sleep, heart rate, resting heart rate and calories then come through. HRV and blood oxygen don’t: Fitbit doesn’t send those to Health Connect.
Connecting an iPhone or Apple Watch
Open /connect → 🍎 iPhone / Apple Watch and open the setup page on your iPhone; the link works once, for 15 minutes. It sets up the PulsHealth app, which syncs by itself in the background. Its free plan syncs up to 5 kinds of data; the page says which 5 to pick.
Claude’s sign-in code doesn’t work
Type the code from the bot’s latest message: each sign-in sends a new one. A sign-in lasts 10 minutes, and 5 wrong codes lock it. Then start connecting again from Claude.
Claude doesn’t use my data
Check that Wellness Bot is switched on in the chat’s tools, and mention it in the question (“from my Wellness Bot data…”). If it was disconnected in /settings → 🔌 Connected apps, connect it again from Claude.
Two sources show different numbers
When two sources (say, a watch and the phone) report the same thing for the same day, the bot shows the one higher in your list. Change the order in /settings → 🔀 Data sources; past days are recalculated.
Times are off by an hour or more
Your timezone is probably wrong, for example after a trip. Fix it in /settings → 🕐 Timezone.
No AI insights
AI is off unless you turn it on. Open /settings → 🧠 AI insights to turn it on and choose when insights come.
“Send to a friend” shows no invite card
The card needs the bot’s inline mode, which whoever runs the bot turns on once. Until then, use 🔗 Or copy a link in /friends and send the link yourself — it works the same. In Telegram, pick a private chat: the card isn’t offered in groups or channels.