🎮 PuzzleSecretary

Frequently Asked Questions

Learn how the PuzzleSecretary bot works

How does the bot respond to messages?

Successfully parsed game results: When you send a valid game result that we understand, we'll mark your message as read. No other response is sent to keep your chat clean.

Messages we don't understand: If we can't parse your message as a game result, we leave it unread. This helps you see which messages need attention.

Commands and errors: When you send a command like /help, we'll send you a text reply with information.

What games are supported?

Currently supported games:

  • NYT Wordle - Daily word puzzle
  • Clues by Sam - Daily crossword-style puzzle game
  • NYT Mini Crossword - Quick crossword puzzle
  • NYT Midi Crossword - Mid-size crossword puzzle
  • NYT Daily Crossword - Full-size daily crossword puzzle
  • NYT Strands - Word search puzzle
  • Airportle - Airport code guessing game
  • Gisnep - Daily crossword puzzle

How do I access my stats?

Your personal stats are available at your unique URL. This URL was sent to you when you first used the bot. You can access your stats page anytime without logging in.

Important: Keep your stats URL private. Anyone with the link can view your game history. If you lose access to your messaging account (phone number, Signal/WhatsApp ID), you may not be able to recover your stats.

How do I start using the bot?

Simply forward or send a game result to the bot's number on WhatsApp or Signal. The bot will automatically:

  1. Create your account
  2. Parse your game result
  3. Send you your personal stats URL
  4. Mark the message as read

No registration or setup required!

What happens to my data?

We store:

  • The system you use to send us messages, WhatsApp or Signal, and the identifier they send us for you.
  • Game results you send
  • Messages you send (for audit/debugging) for up to 120 days.

Can I delete my data?

Data deletion features are planned for a future release. For now, if you need your data deleted, contact the service operator.

Can I link multiple phone numbers or accounts?

Yes! You can link multiple WhatsApp numbers, Signal numbers, or a mix of both to a single account. All your games will count toward the same stats.

How to link accounts:

  1. From your primary account, send /link
  2. The bot will reply with a link code (e.g., /link word-word-word)
  3. From your other account, send that exact message
  4. Your accounts are now linked! All games count toward the same stats.

Important:

  • Link codes expire after 24 hours
  • You can link as many accounts as you want
  • You can link across different platforms (Signal + WhatsApp)

To unlink a number: Send /unlink from that number and follow the confirmation prompt. Your games stay with your account - only the account you send the unlink command from is removed.

Why didn't the bot respond to my message?

The bot only responds with text to commands (like /help) or errors. For successfully parsed games, we only send a read receipt to keep your chat clean.

If your message was left unread, the bot didn't recognize it as a supported game format. Try:

  • Sending the complete game result (copy/paste from the game)
  • Checking that it's a supported game
  • Sending /help to verify the bot is working

How do group leaderboards work?

Group leaderboards let you compete with friends and family on the same games.

Creating a group:

  1. Send /group create to the bot
  2. Complete the web form to name your group and choose your display name
  3. Share the invite code with people you want to join

Joining a group:

  1. Get the 3-word invite code from the group owner
  2. Send /join word-word-word to the bot
  3. Complete the web form to choose your display name

Managing groups: Send /groups to see all your groups and get management links. Owners can regenerate invite codes and remove members. Members can change their display name or leave the group.

Privacy: Group leaderboards are private and only accessible via the unique URL. Members see each other's display names and game results, but not phone numbers or personal stats URLs.

How are games ranked on group leaderboards?

Each game has its own ranking criteria. When two players submit the same game, we compare their results using game-specific rules:

  • ✈️ Airportle: Fewer guesses wins. Ties broken by: more greens, more yellows, row-by-row green comparison, then earlier submission if over 48 hours apart.
  • 🔍 Clues by Sam: Fewest double hints wins, then fewest single hints, fewest yellow (mistakes), most green (correct), then fastest time. If still tied, earlier submission wins if over 48 hours apart.
  • 🧩 Gisnep: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
  • 📰 NYT Daily Crossword: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
  • 📰 NYT Midi Crossword: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
  • 📰 NYT Mini Crossword: Fastest time wins. If tied, earlier submission wins if over 48 hours apart.
  • 🟡 Strands: Fewest hints wins. Ties broken by earlier spangram position in the grid, then earlier submission if over 48 hours apart.
  • 🟨 Wordle: Fewer guesses wins. Ties broken by: hard mode bonus, more greens, more yellows, row-by-row green comparison, then earlier submission if over 48 hours apart.

Why the 48-hour tiebreaker?

You may have noticed that many games use "earlier submission wins if over 48 hours apart" as a final tiebreaker. This exists because the system does not assign games to a specific day, even when the games themselves are dated.

Many games reset at midnight local time, so a puzzle dated "January 5th" might be submitted on the 5th by someone in one time zone and the 6th by someone in another timezone, relative to the first person. We cannot reliably tell whether a late submission is a backfill (someone catching up on a missed day) or a timely submission from a different time zone.

The 48-hour window handles this gracefully: submissions within 48 hours of each other are treated as equivalent for tiebreaking purposes. Only when submissions are more than 48 hours apart does the earlier one win — at that point it is very likely that the later submission is a backfill rather than a same-day play.

Is the bot using AI?

No.

The bot uses no AI, machine learning, generative AI or LLMs. It is 100% regular code reading and parsing the game results and using a very traditional database driven architecture and actual math to build your stats.