Skip to content

Telegram

PeakLine has a Telegram bot that delivers notifications, accepts GPX uploads, and gates access to the Secret Club. Connecting takes one click in PeakLine and one tap in Telegram.

What it does

Once you've linked your Telegram account, the bot can:

  • Send push notifications — new achievements, challenge progress, gear wear alerts, weekly summaries.
  • Accept GPX uploads in chat — drop a .gpx file into the bot DM and get back an analyzed report (including a PeakLine Score and metrics summary).
  • Run the GPX Fixer in chat — same flow as the web tool.
  • Deliver activity summaries automatically right after a ride syncs, if you opt in.
  • Gate Secret Club access — see Secret Club.

Connecting

  1. Open Settings → Integrations → Telegram in PeakLine.
  2. Click Connect. PeakLine shows a personal one-time link to the bot.
  3. Tap the link (or open the bot directly and paste the one-time code).
  4. Send /start to the bot.
  5. The bot replies confirming your PeakLine ↔ Telegram link.

You'll see the connection status update in PeakLine within a few seconds.

Notification settings

Each notification category can be toggled independently in Settings → Notifications:

Category Default Examples
Achievement unlocks On "You earned the Century Ride badge"
Challenge milestones On "You're at 75% of the May Distance Challenge"
Weekly training summary On Sunday-night rollup of the week
Gear wear alerts On "Your chain has 200 km left"
Activity auto-summary Off Brief summary right after a new ride
New features / changelog On When a notable feature ships
Maintenance / outage notices On Rare, only for incidents

You can also pause all Telegram notifications for a custom window from Settings → Notifications → Pause.

Sending a GPX to the bot

The simplest workflow:

  1. Open the bot DM.
  2. Attach a .gpx file (drag-and-drop on desktop, paperclip → file on mobile).
  3. Optionally caption it with a command:
    • No caption → run full analysis.
    • Caption /fix → run the GPX Fixer and return the cleaned file.
    • Caption /segment → treat the GPX as a single segment-like effort and analyze accordingly.

The bot replies with a formatted summary in chat and (for full analysis) a link to the activity page on PeakLine.

This is genuinely useful when:

  • You recorded with a device that doesn't auto-sync to anything (old Garmin, custom bikenav, phone GPS app).
  • You want a quick analysis without opening a browser.
  • You're sharing the ride with a friend over Telegram anyway.

Disconnecting

In PeakLine, Settings → Integrations → Telegram → Disconnect. The bot stops sending you anything. You can /start again later to reconnect, and your settings are preserved across reconnects.

Privacy

  • The bot stores your Telegram chat ID and a link to your PeakLine user ID. Nothing else.
  • We don't read your other Telegram chats, contacts, or media.
  • The bot is hosted on PeakLine's own servers, not on a third-party automation platform.
  • Disconnect at any time. Chat IDs are removed from the database immediately.

See also