Telegram bot commands reference

Last updated: May 19, 2026

Telegram bot commands reference

Quick reference for all commands the Wevion Telegram bot supports. Verified vs apps/backend/src/services/telegram-bot.service.ts handler functions. Bot speaks Italian by default.

Who is this for

Anyone who paired Telegram (com-114) and wants to use the bot interactively beyond just receiving notifications.

All bot commands

Command

What it does

Bot handler

/start [code]

Pair your Telegram with Wevion account using 6-digit code

handleStartCommand

/status

Show pairing state + workspace summary

handleStatusCommand

/stats

Quick performance snapshot (spend, ROAS, top campaigns)

handleStatsCommand

/help

List available commands

handleHelpCommand

/unlink

Remove the Wevion pairing from this Telegram chat

handleUnlinkCommand

That's the full set. Currently no /pause, /resume, or campaign-action commands — interactive campaign management happens in the Wevion web app.

Command details

/start [code]

Pair your Telegram chat with your Wevion user.

Usage:

/start 847291

Where 847291 is your 6-digit auth code from /connect/telegram in the Wevion web app.

Behavior:

  • If code valid: bot confirms with welcome message + saves pairing (POST /api/v1/telegram/link server-side)

  • If code expired: bot asks for fresh code

  • If already paired: bot acknowledges existing pairing

  • Bot replies in Italian: "Account collegato. Riceverai le notifiche da Wevion."

/status

Show current state.

Usage: /status

Bot replies (Italian):

  • Account collegato a [your email]

  • Workspace attivo: [name]

  • Notifiche attive: [list of categories]

  • Ultimo evento ricevuto: [timestamp]

Useful for: verifying pairing alive, checking which notification categories are on.

/stats

Quick performance snapshot.

Usage: /stats

Bot replies:

  • Spesa oggi: [amount]

  • Spesa 7 giorni: [amount]

  • ROAS 7 giorni: [value]

  • Top campagne: [list]

This is a snapshot — for full analytics use the Wevion web app.

/help

List all commands.

Usage: /help

Bot replies (Italian):

Comandi disponibili:

/start [code] - Collega il tuo account Wevion
/status - Stato account, campagne, alert
/stats - Performance snapshot
/help - Mostra questo messaggio
/unlink - Scollega Telegram

/unlink

Remove the Telegram pairing.

Usage: /unlink

Bot replies: "Account scollegato. Non riceverai più notifiche su questo chat."

After unlinking:

  • No more notifications arrive

  • The bot stops responding to commands until you re-pair

  • Your Wevion account is untouched (only the Telegram pairing is removed)

To re-pair: get a fresh code at /connect/telegram and /start [code] again.

What the bot does NOT do

  • No campaign editing: launch/pause/edit campaigns in the Wevion web app

  • No file uploads: Creative Hub uploads via Wevion web app

  • No deep search: bot is for quick stats; full analytics in web

  • No bulk actions: web app only

  • No multi-language switching: currently Italian-only (other languages on roadmap)

Receiving notifications

Separate from interactive commands, the bot delivers notifications you configured at /settings/personal/notifications:

  • Rule firings: real-time

  • Spend alerts: when threshold crossed

  • Sync errors: ad-platform issues

  • Token expiry warnings: 7 days before

  • Security events: always on

Each notification is a formatted message with:

  • Title (e.g. "Rule fired")

  • Detail (which campaign, what changed)

  • Link to open the relevant Wevion page

Tap the link from Telegram → opens in browser → lands directly on the Wevion page (logged in if you have an active session).

Quiet hours and mute

Configure in /settings/personal/notifications:

  • Quiet hours: time range when Telegram messages are queued (delivered at end of quiet hours, deduplicated)

  • Mute all Telegram: for vacations; all messages suppressed until disabled

See team-116 customize notifications for full quiet-hours behavior.

Bot privacy

  • Bot only sees what you /send to it

  • Bot reads your chat ID + username only when you pair

  • No access to your other Telegram chats / groups

  • Wevion does not share your Telegram username with third parties

  • Audit log records pair / unpair / command events (admin view)

Multi-language

Currently Italian-only. Roadmap includes English + Spanish. For English now:

  • Manually translate when sending commands (bot understands command syntax regardless of language)

  • Use the Wevion web app for full UI in your preferred language

  • Contact support if English is critical

Common usage patterns

Pattern A: Morning routine

  1. Wake up → check Telegram for overnight rule firings + spend updates

  2. /status to confirm workspace healthy

  3. Dive into Wevion web app for any action needed

Pattern B: During the day

  1. Bot pings in real time for spend alerts

  2. Tap link → open Wevion mobile or desktop → take action

Pattern C: On vacation

  1. Mute all Telegram (/settings/personal/notifications)

  2. Bot silent until you re-enable

  3. Security events still arrive (forced-on)

Pattern D: Quick stats check

  1. /stats from anywhere with phone signal

  2. Bot replies in seconds with snapshot

  3. Web app for deep dive when needed

Common issues

  • Command not recognized: typo. Commands case-sensitive (lowercase). No spaces in command itself (only in args).

  • Bot doesn't reply: bot may be temporarily offline OR you're sending to wrong bot. Verify you're chatting with the official Wevion bot.

  • /start [code] says expired: code valid for 5 min only. Refresh /connect/telegram for fresh code.

  • Bot replies in Italian, I want English: not configurable currently. Use web app for English.

  • /stats doesn't include all workspaces: bot reports current workspace context. Use /status to switch workspace if you belong to many (planned for v2).

Related