Connect Telegram → deep link → open in Telegram → bot verifies token. Owner fan-out. Bot blocking auto-deactivates.

Connect Telegram for real-time alerts

Connect Telegram generates a one-time link token + a Telegram deep link. Click the deep link → opens Telegram → you start the bot → the bot verifies the token → your account is linked. Notifications fan out to the direct user AND the owner (with a "Team: [memberName]" prefix). Bot blocking detection: if you block the bot, the link is deactivated automatically.

Who is this for

Anyone wanting real-time alerts in Telegram (instant, mobile-friendly). Especially: on-call mediabuyers, agency owners monitoring multiple clients.

Prerequisites

• Telegram account
• Wevion account (any role with mediabuyer+ permission)
• Smartphone or desktop Telegram app

The Wevion workspace's Telegram bot must be configured at the deployment level (admin task — see com-114 Telegram bot setup). If your workspace's bot isn't connected: admin needs to set it up first.

How to connect

Step 1: Trigger the link flow

In Wevion UI: Settings → Notifications → Telegram → click Connect Telegram. Wevion generates a one-time token and a Telegram deep link (https://t.me/yourbot?start=...) that you open to link the bot.

Step 2: Open the deep_link

Click the deep_link OR copy to a device with Telegram installed.

Opens Telegram → conversation with Wevion's bot → bot shows greeting.

Step 3: Send /start to the bot

If the bot doesn't auto-respond: send /start.

Bot verifies the link token → creates telegram_link row:

• user_id (unique per Wevion user)
• chat_id (unique per Telegram chat)
• username + first_name (from Telegram)
• linked_at (timestamp)
• is_active (true)

Step 4: Verify connection

The status view shows whether Telegram is linked and active, your Telegram username and name, and when it was linked. When linked, the UI shows a green badge "Telegram Connected".

Step 5: Test it

In Settings → Notifications → Telegram, click Send Test.

Test message arrives instantly in Telegram. If it doesn't: see troubleshooting below.

What you'll receive

Per the alert toggles in telegram_notification_pref:

Plus digest if enabled (see ntf-106 digest).

Configure in Settings → Notifications → Telegram:

• Per-alert toggles (for example spend cap, sync completed)
• Daily digest on/off, with a delivery hour and timezone

Severity icons

Each Telegram message starts with a severity icon:

Owner fan-out

If you're a team member (e.g. mediabuyer) with user.owner_id set:

• Direct notifications go to you
• AND to your owner (with "Team: [your name]" prefix)

This lets owners stay informed of team activity. Owners can disable via their own preferences.

Bot blocking detection

If you block the Wevion bot in Telegram (or revoke conversation):

• Wevion's next send fails with status 403 or "bot was blocked"
• Worker automatically sets telegram_link.is_active = false
• No further Telegram notifications sent

To re-enable: unlink + re-link via the connect flow.

Disconnect Telegram

Unlinking removes the link.

Or send /unlink to the bot directly (see ntf-105 commands).

After unlink:

• telegram_link.is_active = false
• No more Telegram notifications
• Link token expired
• You can re-link anytime

Same bot for tracker callbacks

Note: the same Telegram bot may also handle tracker postback callbacks (see com-114 Telegram bot setup). The notification side + tracker side are separate workflows on the same bot infrastructure. Linking for notifications doesn't affect tracker setup or vice versa.

Privacy

When linked, Telegram bot sees:

• Your chat_id + username + first_name (from Telegram)
• Notification content delivered to you
• Your /start /status /stats /help /unlink commands

Bot does NOT see your other Telegram conversations.

Wevion does NOT send personal info to Telegram beyond what's in the notification message itself.

Common issues

• Deep_link expires before I can click: link tokens are single-use and expire after 24 hours. Re-trigger link if expired.
• Bot didn't respond to /start: check workspace's bot is configured (admin → Connect Telegram for notifications)
• Test message didn't arrive: bot may be blocked; check is_active via GET /status; unlink + re-link
• Notifications stopped after working initially: bot blocked / chat archived; same fix (unlink + re-link)
• Owner getting my notifications: by design — owner fan-out. Owner can disable in their own preferences.
• Notifications too noisy: disable specific alert_* toggles via PUT /preferences or use the UI

FAQ

How do I connect Telegram to Wevion?

In Wevion go to Settings → Notifications → Telegram and click Connect Telegram, which generates a one-time token and a Telegram deep link. Open the deep link, send /start to the bot, and it verifies the token and links your account. A green "Telegram Connected" badge confirms it.

What happens if I block the Wevion bot?

If you block Wevion's bot or revoke the conversation, the next send fails with status 403, and the worker automatically sets telegram_link.is_active = false, stopping all further Telegram notifications. To re-enable them, unblock the bot in Telegram, then unlink and re-link through the connect flow in /settings → Notifications → Telegram.

Why is my owner receiving my notifications?

That's owner fan-out, by design in Wevion. If you're a team member with user.owner_id set, your direct notifications also go to your owner, prefixed with "Team: [your name]", so owners stay informed of team activity. Owners who don't want this can disable it through their own notification preferences.

How do I disconnect Telegram?

Unlink from Settings → Notifications → Telegram in Wevion, or send /unlink directly to the bot. After unlinking, the link is deactivated, no further Telegram notifications are sent, and the link token expires. You can re-link anytime through the standard deep-link connect flow.

Related articles

• Telegram bot commands
• Telegram digest — daily and weekly reports
• Connect Telegram for notifications
• Notifications across channels — complete guide