Wevion Telegram bot commands reference: /start, /status, /stats, /help, /unlink. Italian default.

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

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 [token]

Pair your Telegram chat with your Wevion user.

Usage:

/start 0123456789abcdef0123456789abcdef

Where the 32-character hex token is generated by /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: login from new device, 2FA changes, API key created — where the event catalog exposes them; these follow your notification preferences

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).

Controlling what you receive

Telegram delivery is controlled by per-alert toggles and digest scheduling at /settings/personal/notifications, backed by GET/PUT /api/v1/telegram/preferences (apps/backend/src/routes/api/telegram.route.ts). There is no quiet-hours window, no mute-all switch, and no server-side queuing/deduplication for the Telegram channel in the current code.

To reduce noise:

• Turn off individual alerts: disable the alert types you don't want (e.g. alert_sync_completed, alert_report_ready)
• Use digests instead of real-time: enable the daily and/or weekly digest and set the hour/day and timezone
• Unlink the bot: send /unlink (or DELETE /api/v1/telegram/unlink) to stop all Telegram delivery

See team-116 customize notifications for the full preference set.

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. Turn off the alert types you don't want at /settings/personal/notifications, or send /unlink to stop all Telegram delivery
2. Re-enable the alerts (or /start [code] to re-pair) when you're back

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: the pairing token is valid for 24 hours. Refresh /connect/telegram for a fresh token.
• 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).

FAQ

What commands does the Wevion Telegram bot support?

The Wevion Telegram bot supports five commands: /start [token] to pair your account, /status for pairing state and workspace summary, /stats for a spend, ROAS, and top-campaigns snapshot, /help to list commands, and /unlink to remove the pairing. There are no pause, resume, or campaign-action commands — interactive campaign management happens in the Wevion web app.

Can I pause or edit campaigns from the Telegram bot?

No — the Wevion Telegram bot does not edit campaigns. It offers quick stats and notifications only, with no campaign launch, pause, or edit, no file uploads, no deep search, and no bulk actions. For any campaign action, tap the notification link or open the Wevion web app, where launch, pause, and editing all happen.

What language does the Wevion Telegram bot use?

The Wevion Telegram bot is currently Italian-only, replying in Italian to commands like /status and /help. English and Spanish are on the roadmap. For now you can send commands in any language (the bot understands the command syntax regardless), or use the Wevion web app for full UI in your preferred language.

Why does /start [code] say the code is expired?

The pairing token is valid for 24 hours, so an expired message means too much time passed since you generated it. Refresh /connect/telegram in the Wevion web app to get a fresh 32-character token, then send /start [code] again. If the bot says you're already paired, no action is needed.

How do I stop receiving Wevion notifications on Telegram?

Send /unlink to the Wevion bot to remove the pairing — notifications stop, the bot stops responding to commands, and your Wevion account is untouched. To reduce noise without unlinking, turn off individual alert types at /settings/personal/notifications. To re-pair later, get a fresh code at /connect/telegram and send /start [code] again.

Related articles

• Connect Telegram for notifications
• Set up notifications and Telegram alerts
• Customize notification preferences