Skip to main content

Setting up notifications

3DPrintForge can notify you about everything from completed prints to critical errors — via Telegram, Discord, email, or browser push notifications.

Overview of notification channels

ChannelBest forRequires
TelegramQuick, anywhereTelegram account + bot token
DiscordTeam/communityDiscord server + webhook URL
Email (SMTP)Official notificationsSMTP server
Browser pushDesktop notificationsBrowser with push support

Telegram bot

Step 1 — Create the bot

  1. Open Telegram and search for @BotFather
  2. Send /newbot
  3. Give the bot a name (e.g. "Bambu Alerts")
  4. Give the bot a username (e.g. bambu_alerts_bot) — must end in bot
  5. BotFather replies with an API token: 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
  6. Copy and save this token

Step 2 — Find your Chat ID

  1. Start a conversation with your bot (search for the username and click Start)
  2. Send a message to the bot (e.g. "hello")
  3. Go to https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates in your browser
  4. Find "chat":{"id": 123456789} — that is your Chat ID

Step 3 — Connect to the dashboard

  1. Go to Settings → Notifications → Telegram
  2. Paste the Bot Token
  3. Paste the Chat ID
  4. Click Test notification — you should receive a test message in Telegram
  5. Click Save
Group notifications

Want to notify an entire group? Add the bot to a Telegram group, find the group Chat ID (a negative number, e.g. -100123456789) and use that instead.


Discord webhook

Step 1 — Create webhook in Discord

  1. Go to your Discord server
  2. Right-click on the channel you want alerts in → Edit channel
  3. Go to Integrations → Webhooks
  4. Click New Webhook
  5. Give it a name (e.g. "3DPrintForge")
  6. Select an avatar (optional)
  7. Click Copy Webhook URL

The URL looks like this:

https://discord.com/api/webhooks/123456789/abcdefghijk...

Step 2 — Add to the dashboard

  1. Go to Settings → Notifications → Discord
  2. Paste the Webhook URL
  3. Click Test notification — the Discord channel should receive a test message
  4. Click Save

Email (SMTP)

Required information

You need the SMTP settings from your email provider:

ProviderSMTP serverPortEncryption
Gmailsmtp.gmail.com587TLS
Outlook/Hotmailsmtp-mail.outlook.com587TLS
Yahoosmtp.mail.yahoo.com587TLS
Custom domainsmtp.yourdomain.com587TLS
Gmail requires an app password

Gmail blocks sign-in with a regular password. You must create an App password under Google account → Security → 2-step verification → App passwords.

Configuration in the dashboard

  1. Go to Settings → Notifications → Email
  2. Fill in:
    • SMTP server: e.g. smtp.gmail.com
    • Port: 587
    • Username: your email address
    • Password: app password or regular password
    • From address: the email the notification is sent from
    • To address: the email you want to receive notifications at
  3. Click Test email
  4. Click Save

Browser push notifications

Push notifications appear as system notifications on the desktop — even when the browser tab is in the background.

Enable:

  1. Go to Settings → Notifications → Push notifications
  2. Click Enable push notifications
  3. The browser asks for permission — click Allow
  4. Click Test notification
Only in the browser where you enabled it

Push notifications are tied to the specific browser and device. Enable it on each device you want notifications on.


Choosing which events to be notified about

After you have set up a notification channel, you can choose exactly which events trigger a notification:

Under Settings → Notifications → Events:

EventRecommended
Print completedYes
Print failed / cancelledYes
Print Guard: spaghetti detectedYes
HMS error (critical)Yes
HMS warningOptional
Filament lowYes
AMS errorYes
Printer disconnectedOptional
Maintenance reminderOptional
Nightly backup completedNo (noisy)

Quiet hours (no notifications at night)

Avoid being woken up by a completed print at 03:00:

  1. Go to Settings → Notifications → Quiet hours
  2. Enable Quiet hours
  3. Set from-time and to-time (e.g. 22:00 to 07:00)
  4. Choose which events should still notify during the quiet period:
    • Critical HMS errors — recommended to keep on
    • Print Guard — recommended to keep on
    • Print completed — can be turned off at night
Night printing without disturbance

Run prints at night with quiet hours enabled. Print Guard keeps watch — and you get a summary in the morning.