Description
Get an instant Telegram message the moment something happens in your WooCommerce store. Connect a bot, pick the events you care about, and receive clean, formatted notifications in any chat, group or forum topic.
Events you can enable
- New order — announced once, the first time an order reaches one of the statuses you select (no duplicate messages).
- Status change — notify on your own list of order statuses.
- Failed payment — a separate alert for orders that land in the “Failed” status.
- Low stock — fires when a product reaches the low-stock threshold from WooCommerce Settings Products Inventory.
Flexible delivery
- Send to multiple chats at once — a private chat, a group, or a channel (
@username). - Deliver into a forum topic by appending the topic id, e.g.
-1001234567890:42. - Silent mode — deliver messages without a notification sound.
Custom message templates
Build your own message with tags: order number, total, items list, item count, customer name, phone, email and note, billing and shipping address, payment and shipping method, order date and status, and an admin link to the order. A line whose tags all resolve to empty is removed automatically, so messages stay tidy even when a field is missing. Telegram markup (<b>, <i>, <u>, <s>, <code>, <a href>) is supported.
Reliable and secure
- Delivery log — every send is recorded with the chat, HTTP status and result.
- Automatic retry — a failed send is retried once after a short delay.
- The bot token is stored encrypted.
Telegram and WooCommerce are third-party products. This plugin is an independent integration and is not affiliated with, endorsed by, or sponsored by Telegram or WooCommerce.
External services
This plugin connects to the Telegram Bot API (https://api.telegram.org) to deliver your notifications. This is required for the plugin to work — without it, no messages can be sent.
What data is sent and when: a request is made only when an enabled event occurs (a new order, an order status change, a failed payment, or a low-stock product), and only to the chats you configure. Each request includes your bot token, the target chat id (and optional topic id), and the message text built from your template. Depending on the template you choose, that text may include the order number and total, the list of purchased items, and the customer’s name, phone, email and address.
Telegram is a third-party service. By using this plugin you agree to Telegram’s terms.
- Terms of Service: https://telegram.org/tos
- Privacy Policy: https://telegram.org/privacy
Screenshots
Installation
- Upload the plugin to
/wp-content/plugins/or install it from your WordPress admin under Plugins Add New. - Activate the plugin. WooCommerce must be installed and active.
- In Telegram, create a bot via @BotFather with
/newbotand copy the token it gives you. - Go to WooCommerce Telegram Notifications and paste the bot token.
- Add one or more chat ids (one per line). Use the “Find chat_id” button after writing any message to your bot, or after adding it to a group.
- Choose the events to notify about, adjust the templates if needed, and save.
- Click “Send a test message” to confirm everything works.
FAQ
-
How do I get a bot token?
-
Open @BotFather in Telegram, send
/newbot, follow the prompts, and copy the token. Paste it on the plugin settings page — it is stored encrypted. -
How do I find my chat id?
-
Write any message to your bot (or add the bot to your group), then open the plugin settings and click “Find chat_id”. The plugin reads pending updates and shows the chat ids it sees. Note: if your bot uses a webhook, getUpdates will not return anything.
-
Can I send notifications to a group topic (forum)?
-
Yes. Add the chat id followed by the topic id, separated by a colon — for example
-1001234567890:42. -
Which order fields can I use in a message?
-
Order number and id, total, current and previous status, order date, items list and item count, customer name, phone, email and note, billing and shipping address, payment and shipping method, shipping total, an admin link to the order, and the store name. Low-stock messages also expose the product name, SKU and remaining quantity.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“CatCode Order Notifications with Telegram for WooCommerce” is open source software. The following people have contributed to this plugin.
Contributors
“CatCode Order Notifications with Telegram for WooCommerce” has been translated into 1 locale. Thank you to the translators for their contributions.
Translate “CatCode Order Notifications with Telegram for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.2
- Unified all global identifiers under a single distinct prefix to avoid conflicts.
- Removed bundled translation files; translations are handled via WordPress.org.
1.0.0
- First public release.