Notifications troubleshooting

Diagnose: Telegram silent, email spam, push expired, Slack misconfig, owner fan-out, missing entirely, digest skipped, in-app inbox empty.

Written By Salvatore Sinigaglia

Last updated 18 days ago

Diagnose: Telegram silent, email spam, push expired, Slack misconfig, owner fan-out, missing entirely, digest skipped, in-app inbox empty.

Notifications troubleshooting

Common notification issues with diagnosis + actionable fix. Always check preferences first (/settings → Notifications) — most missing notifications trace back to a preference being off (user-level, team-level, or role default).

Who is this for

Anyone wondering why an expected notification didn't arrive or why an unwanted one keeps coming.

Issue 1: Telegram notifications silent

Symptoms

Connected Telegram, expecting alerts, but bot is silent.

Causes + fixes

  1. Bot blocked / chat archived — Telegram returned 403; telegram_link.is_active = false. Fix: unblock the bot in Telegram → unlink in Wevion (DELETE /unlink or via UI) → re-link via deep_link
  2. Preference disabled for that alert type. Fix: enable it in Settings → Notifications → Telegram
  3. No notifications happening — verify in-app inbox; if also empty, issue is upstream (no events firing)
  4. Bot link inactive — check the link status in Settings → Notifications → Telegram

Issue 2: Email in spam folder

Symptoms

Emails sent but landing in spam.

Causes + fixes

  1. Sender not allowlisted — noreply@wevion.ai flagged as unknown. Fix: allowlist noreply@wevion.ai in your email provider
  2. First-time receiver — Gmail / Outlook may mark first contact as spam. Fix: mark "Not spam" once → future emails arrive normally
  3. Corporate email filter — IT may block external automated emails. Fix: ask IT to allowlist domain wevion.ai

Issue 3: Push notifications not arriving

Symptoms

Push subscribed but no alerts arrive.

Causes + fixes

  1. Browser permission denied — VAPID web push requires browser grant. Fix: re-grant in browser settings + re-subscribe in Wevion /settings → Notifications → Push
  2. Subscription expired (410 / 404) — the push worker hard-deletes the subscription row (deleteByEndpoint on the endpoint), it is not just deactivated. Fix: re-subscribe via UI; a new endpoint is persisted
  3. Mobile push expected — only web push (VAPID, PWA) is implemented. No native mobile push — use Telegram instead

Issue 4: Slack notifications not delivering

Symptoms

Slack integration set up but no messages in the channel.

Causes + fixes

  1. Destination not verified. Fix: re-run the Slack install/authorization
  2. Token revoked at workspace — Slack workspace admin removed Wevion app. Fix: re-install OAuth
  3. Wrong event type — only the conservative default event set routes to Slack (account.disconnected, account.token_expiring, campaign.publish_failed, rule.action_failed, sync.failed, billing.payment_failed, billing.subscription_expired). Other notifications don't reach Slack. Fix: configure additional Slack routing via notification_policy overrides (advanced — contact admin)
  4. Channel deleted / archived — destination broken. Fix: re-configure with valid channel
  5. Permission scope insufficient — Wevion needs chat:write, channels:read, incoming-webhook. Fix: re-install OAuth to refresh scopes

Issue 5: Owner getting notifications they don't want

Symptoms

You're the team owner and inbox / Telegram is flooded with team members' notifications.

Cause

Owner fan-out by design — owners receive team members' alerts to maintain oversight. Configured in ROLE_DEFAULTS matrix.

Fix

Disable owner-fan-out per type in your preferences:

  • /settings → Notifications → for each noisy type, toggle off the channel(s)
  • Or: set specific overrides in Settings → Notifications

You'll still see things in in-app inbox (filterable); other channels off.

Issue 6: Notification missing entirely

Symptoms

Expected notification didn't arrive in any channel.

Causes + fixes

Check preferences precedence:

  1. Team-scoped override: admin may have disabled team-wide for this type. Fix: ask admin to re-enable
  2. User-scoped override: you disabled it for yourself. Fix: /settings → Notifications → enable
  3. Role default: your role has it off by default. Fix: explicit user override to enable
  4. Catalog default: notification type itself disabled in catalog (rare). Fix: not user-configurable

Decision IGNORE from policy engine = no delivery. To debug: check audit log or event_promotion table for the event_occurrence.

Issue 7: Telegram digest didn't arrive

Symptoms

Configured daily / weekly digest, expected at certain hour, didn't arrive.

Causes + fixes

  1. Daily / weekly toggle off — verify the daily/weekly digest toggles in Settings → Notifications → Telegram
  2. Wrong timezone — digest_timezone IANA string; verify against your actual TZ
  3. Wrong hour — daily_digest_hour (0-23) in user TZ; off-by-one common
  4. Dedup window hit — telegram_digest_log past 14 days; if you already received today's digest, won't re-send
  5. Bot inactive — telegram_link.is_active = false; re-link
  6. Cron didn't fire — system issue; contact admin to check cron health (lock ID 100011)

Issue 8: In-app inbox empty

Symptoms

Notification center shows no items even though you know events fired.

Causes + fixes

  1. Team filter mismatch — notification-inbox v2 is team-scoped; v1 is user-scoped. If UI shows v2 by default: switch team context or use v1
  2. All notifications archived — toggle filter to show archived
  3. All notifications read + filter is unread-only — toggle filter
  4. Notifications never created — events may have been IGNOREd by policy; check preferences

Issue 9: Receiving duplicate notifications

Symptoms

Same event triggers multiple notifications across channels (expected) OR multiple notifications of same type in same channel (unexpected).

Causes + fixes

  • Multi-channel by design: same event → in-app + email + telegram if all enabled. Expected.
  • Owner + member fan-out: same event → you (member) + your owner (separately). Expected.
  • Real duplicates same channel: grouping_key / cooldown_key should prevent. If happens: report bug

Issue 10: Wrong user receives notification

Symptoms

Notification arrived to a user it shouldn't (e.g. teammate's account event arrived to you, but you're not the owner).

Causes + fixes

  1. Wrong team_id — notification mis-targeted; report as bug with notification ID
  2. Mis-configured ownership — user.owner_id may be wrong; admin can verify
  3. Shared session — if you have access to teammate's data via super_admin role, may receive their notifications

Issue 11: Slack notifications stopped working

Symptoms

Slack worked initially, now stopped.

Causes + fixes

  1. Token revoked — workspace admin disabled Wevion app. Fix: re-install OAuth
  2. Channel archived — destination broken. Fix: re-configure destination
  3. Slack workspace migrated — install on new workspace
  4. Rate limit — temporary; Slack returns 429. Fix: wait + retry; should self-resolve

Issue 12: Notification preferences not saving

Symptoms

Toggle preference in UI but reverts on reload.

Causes + fixes

  1. API error — check browser console for PUT failure
  2. Role default re-applied — if you reset preferences, role default reverts. To override: explicit enabled: true/false per type
  3. Stale frontend cache — hard refresh
  4. Backend lag — wait a few seconds, refresh

Escalation

If none of the above match:

  1. Capture: notification type + expected channel + your role + timestamp + any error messages
  2. Check notification_inbox_item table state (admin)
  3. Check event_promotion table for decision (admin)
  4. Contact support with details

Common mistakes

  • Expecting mobile push — only web push (PWA / browser)
  • Expecting a general email digest — general alerts are per-event email; the only batched email is the Ad Fatigue digest (daily/weekly). Use Telegram digest for broader summaries
  • Disabling all in-app to "reduce noise" — in-app inbox is the audit source; keep on
  • Sharing Telegram bot link with teammates — link is per-user; each user must trigger their own
  • Not allowlisting noreply@wevion.ai — emails to spam

FAQ

Why is my Telegram bot silent?

Usually a preference or link issue. Wevion deactivates the Telegram link if you blocked the bot or archived the chat — unblock, unlink, then re-link. Otherwise the specific alert type may be disabled in your preferences, or no events are firing. Check the Telegram link status in Settings → Notifications → Telegram.

Why do my Wevion emails land in spam?

Most often the sender isn't allowlisted. Allowlist noreply@wevion.ai in your provider, and mark a first email "Not spam" so future ones arrive normally. Corporate filters may block external automated mail — ask IT to allowlist the wevion.ai domain. Delivery then resumes without further changes.

Does Wevion support native mobile push notifications?

No. Wevion implements only web push via VAPID (PWA / browser), so there is no native mobile app push. If push isn't arriving, re-grant the browser permission and re-subscribe under /settings → Notifications → Push; an expired subscription (410/404) is hard-deleted by the push worker (deleteByEndpoint), not just deactivated. For mobile-friendly alerts, use Telegram instead.

Why did an expected notification never arrive in any channel?

Check preference precedence in Wevion: a team-scoped override, your own user override, a role default, or a catalog default may have it off. A policy decision of IGNORE means no delivery. Enable the type under /settings → Notifications, or ask your admin to re-enable it team-wide.

As an owner, why am I flooded with my team's notifications?

This is owner fan-out by design — owners receive team members' alerts for oversight, driven by role-based defaults. To quiet it, open Settings → Notifications and toggle off the noisy channels per type. You'll still see items in the in-app inbox.