Skip to content

Telegram notifications

Pro+ feature

Telegram notifications are available on Pro and Enterprise plans.

Receive instant notifications about job assignments, SLA warnings, completions, and team activity directly in Telegram. FSM Navigator supports 18 notification types covering jobs, business, scheduling, and asset alerts. Set up a bot once and your team stays informed without checking the dashboard.

What you'll receive

Jobs

Event Notification
Job assigned 🔧 New job assigned
SLA warning ⚠️ SLA deadline approaching
Job completed ✅ Job completed
Technician declined ❌ Technician declined
Running late 🕐 Running past schedule

Business

Event Notification
Customer added 🆕 New customer
Low stock alert 📦 Low stock alert
Daily summary 📊 Daily digest
Weekly report 📈 Weekly performance

Scheduling

Event Notification
Booking reminder 📅 Upcoming appointment
Booking late ⚠️ Late for appointment

Asset alerts (Enterprise)

Event Notification
Warranty expiring Warranty expiring soon
Warranty expired Warranty expired
Maintenance overdue Maintenance overdue
Meter threshold Meter threshold reached
Compliance alert Compliance action needed
Lease expiring Lease expiring soon
Lease expired Lease expired

Prerequisites

  • A Telegram account (mobile or desktop)
  • Ability to create bots via @BotFather in Telegram
  • Active Pro or Enterprise plan

Setting up your bot

  1. Open Telegram and search for @BotFather.
  2. Send /newbot and follow the prompts to name your bot.
  3. Copy the API Token that @BotFather provides.
  4. Start a chat with the bot — Search for your bot in Telegram by its username, click it, and tap START to initialize the chat. The bot cannot send messages until you've started this conversation. (Telegram API requirement.)
  5. Add the bot to your team group chat, or start a direct conversation with it.
  6. Get your Chat ID using @userinfobot or @getidsbot in Telegram.
  7. In FSM Navigator, go to Settings → Telegram tab.
  8. Paste your Bot Token and Chat ID into the fields.
  9. Click Save Configuration.
  10. Click Send Test Message to verify everything works.

You're all set

If you receive the test message in Telegram, notifications are configured and active.

Group vs. direct messages

How to tell which ID type you have

  • Group chat IDs start with -100 (e.g., -1001234567890)
  • Personal chat IDs are positive numbers (e.g., 123456789)

Use a group chat to notify your whole team, or a direct chat for personal alerts. You can configure one destination per company account.

Testing your setup

After saving your configuration, use the Send Test Message button on the Telegram settings page. A sample notification is sent immediately to your configured chat. If it doesn't arrive:

  • Verify the bot was added to the group or that you started a chat with it
  • Double-check your Bot Token and Chat ID
  • Make sure the bot has permission to send messages in the group

Disabling notifications

To stop receiving Telegram notifications without deleting your bot:

  1. Go to Settings → Telegram tab.
  2. Toggle Notifications to Off.
  3. Click Save.

Your bot token and chat ID are preserved, so you can re-enable notifications at any time without reconfiguring.

FAQ

Why isn't my bot sending messages?

Verify three things: (1) the Bot Token is correct and matches what @BotFather provided, (2) the Chat ID is correct for your group or direct chat, and (3) the bot has been added to the group and has permission to post messages. Use the Send Test Message button to diagnose the issue.

Can I have separate bots for different notification types?

The current setup supports one bot configuration per account. All enabled notification types are sent to the same chat. You can control which categories are active from the notification preferences in Settings.

Is my bot token secure?

Your bot token is stored encrypted and is never exposed in the browser or to other users. Only Owners and Admins can view or modify the Telegram configuration.

Related pages: