Help
Setup & troubleshooting
Help for when you’re setting up or something didn’t fire. New here? Start on the home page.
Getting started
- Add VamOS
- Open @vamOS_hitbot, tap Start, then add it to your padel Telegram group (or use Add to Telegram on the site).
- Start the bot
- Private Start unlocks DMs for ledger login, reminders, and booking tasks. Do this before you need credentials.
- Add it to your group
- Add @vamOS_hitbot to the group. Onboarding asks for language, admin, and venue — about a minute.
- Choose your venue
- Link Venue? paste a booking URL (auto-match or soft create), Use Pàdel 7 Glòries, or skip. Change later with /setup. Browse the catalog on the website under Venues.
Playing
- Start a game
- Say “Padel Thursday?” or use /game → Existing or New → time → 60/90.
- Join a game
- Tap Join on the game card, or /join and pick a date. The card updates in place as people join.
- Leave a game
- Tap Leave on the card, or say “Can’t make it” / “me bajo”.
- Multiple games
- Thursday night and Tuesday morning can recruit at once. /upcoming lists them; /join picks by date.
- Does VamOS book the court?
- Not yet. When the game is full, VamOS assigns a booker and sends them straight to the club's booking page. They book the court and tap Booked ✓ so everyone knows it's sorted.
Telegram
- Why doesn’t VamOS see messages?
- Telegram privacy hides plain group text from bots. Make @vamOS_hitbot a group admin (Group info → Edit → Administrators → Add admin), or BotFather → /setprivacy → Disable and re-add the bot. /game always works. Or @mention the bot.
- Bot permissions
- Admin lets VamOS hear natural language and notice new members so Join buttons resurface.
- Telegram privacy
- Default bot privacy blocks most group messages. Admin is the easy fix for “Padel Thursday?”.
Money
- Payments
- After Booked ✓: who paid → court price. VamOS splits and nets across games.
- Balances
- /balances in Telegram, or the web ledger. Chase kicks in above the group threshold (~15€).
- Ledger
- Organiser: open the bot in DM (/start) → /ledgercreds. Web: /ledger on this site.
Scores
- Fixed pairs
- Same partners for the session — enter full sets (6–4…). Feeds the ladder.
- Switch
- Rotate partners — short scores OK (4–3…). Also feeds the ladder.
- How does the ladder work?
- Send /ladder in your group, or open the public ladder link. Each quarter (Jan–Mar, Apr–Jun, Jul–Sep, Oct–Dec, Madrid time) ranks players by the share of sets they win, once they've played 6 sets. Your full match history on the web covers all time.