# Telegram bot

Use the Fly in Public Telegram bot when you want to keep flying from your phone. You can check your flight, add a proof from a link, get staged warnings before your bird crashes, see the leaderboard, and manage notifications without opening the web app.

Bot: [@flyinpublic_bot](https://t.me/flyinpublic_bot)

## Connect your account

1. Open [@flyinpublic_bot](https://t.me/flyinpublic_bot) in Telegram.
2. Send `/start`.
3. Tap the confirmation link the bot sends back.
4. Sign in to Fly in Public if needed, then confirm the chat connection.
5. Return to Telegram and run `/status`.

You can also connect from profile settings. Click "Connect Telegram", then send the one-time code to the bot. Codes and confirmation links expire after 15 minutes.

## Crash warnings

Crash warnings are on by default after linking. When your bird is on track to crash, the bot sends staged heads-ups around 6 hours, 2 hours, and 30 minutes before the predicted crash time.

Use `/notifications crash on` or `/notifications crash off` to change this. Each stage is sent once for the current crash deadline, then resets after your deadline meaningfully changes.

## Commands

- `/start`: get a confirmation link for this chat.
- `/start <code>`: connect with a one-time code from settings.
- `/whoami`: show the linked account name, handle, email, and profile.
- `/status`: check altitude, crash timing, and streak.
- `/proof <url> [message]`: add a public proof.
- `/leaderboard`: see top flights and your rank.
- `/notifications crash on|off`: toggle 6h, 2h, and 30m crash warnings.
- `/notifications likes|comments on|off`: turn interaction alerts on or off.
- `/unlink`: disconnect this Telegram chat from your Fly in Public account.
- `/help`: show the command list.

## Examples

```text
/status
/whoami
/proof https://example.com/launch Shipped the first landing page
/notifications crash on
```

## What happens after linking

- The bot only acts on the Fly in Public account you confirmed.
- Proof URLs are posted to your current flight.
- Crash warnings follow the staged 6h, 2h, and 30m schedule.
- Like and comment notifications follow your Telegram notification settings.
- You can disconnect any time with `/unlink` or from profile settings.

## Read next

- [How it works](https://flyinpublic.com/docs/how-it-works)
- [AI skill](https://flyinpublic.com/docs/skills)
- [API docs](https://flyinpublic.com/docs/api)