Description
wegram is a free and powerful WordPress plugin that connects your WooCommerce store to Telegram. Every time an order is placed or its status changes, wegram instantly sends a formatted notification to your Telegram bot — even if you’re in Iran.
Why wegram?
Most Telegram plugins fail in Iran because the Telegram API is blocked. wegram solves this by routing messages through a Cloudflare Worker as a proxy — so your notifications always get through, no matter where your server is hosted.
Key Features
- 🤖 Easy Telegram bot integration — connect in minutes using your bot token
- ☁️ Cloudflare Worker proxy — bypass network restrictions (Iran-compatible)
- 📨 8 order status triggers — pending, processing, on-hold, completed, cancelled, refunded, failed, checkout-draft
- 🎨 Fully customizable message templates — per-status templates with dynamic variables
- 👥 Multiple recipients — send to multiple Telegram chats, groups, or channels
- 🚀 Step-by-step setup wizard — get started in under 5 minutes
- 📊 Clean admin dashboard — see your connection status at a glance
- 🔄 Rate limiting — prevents duplicate messages for the same order event
- 🌐 RTL support — full right-to-left layout for Persian/Arabic admin panels
- ✅ WooCommerce HPOS compatible — supports High-Performance Order Storage
Available Message Variables
Use these placeholders in your message templates:
{id}— Order number{date}— Order date and time{name}— Customer full name{phone}— Customer phone number{email}— Customer email address{total}— Order total amount{items}— List of ordered products{items_count}— Number of items{shipping}— Shipping method{payment}— Payment method{reason}— Cancellation note / customer note{status}— Current order status{address}— Billing address
How It Works
- You create a Telegram bot via @BotFather and get a token
- You deploy a free Cloudflare Worker using the code provided in the plugin
- You enter your bot token, Worker URL, and target chat IDs in the plugin settings
- wegram listens to WooCommerce order events and forwards notifications through the Worker to Telegram
Privacy Notice
wegram sends order data (order ID, customer name, phone, total, items) to your own Cloudflare Worker and then to your own Telegram bot. No data is sent to third-party servers controlled by the plugin author. You are responsible for your own data handling.
External Services
This plugin connects to the following external services:
Telegram Bot API
- What it is: The official Telegram Bot API used to deliver order notifications to your Telegram bot.
- When data is sent: Data is sent every time a WooCommerce order is created or its status changes (based on your settings).
- What data is sent: Order details including order ID, customer name, phone number, email, order total, items list, shipping method, and payment method.
- How it is sent: Data is routed through your own Cloudflare Worker (a proxy you deploy), and then forwarded to the Telegram API. Data is never sent to servers controlled by the plugin author.
- Telegram Terms of Service: https://telegram.org/tos
- Telegram Privacy Policy: https://telegram.org/privacy
- Telegram Bot API Terms: https://core.telegram.org/bots/faq#what-is-the-bot-api
Cloudflare Workers
- What it is: A serverless proxy platform used to relay messages from your WordPress server to Telegram (required for Iran-hosted servers where Telegram API is blocked).
- When data is sent: Every time an order notification is triggered.
- What data is sent: The same order data listed above, passed through the Worker URL that you configure.
- Note: The Worker runs on YOUR Cloudflare account. You control it. No data is stored by Cloudflare Workers beyond the request itself.
- Cloudflare Privacy Policy: https://www.cloudflare.com/privacypolicy/
- Cloudflare Terms of Service: https://www.cloudflare.com/terms/
Screenshots



Installation
Automatic Installation
- Go to Plugins > Add New in your WordPress dashboard
- Search for wegram
- Click Install Now, then Activate
- You will be redirected to the setup wizard automatically
Manual Installation
- Download the plugin zip file
- Go to Plugins > Add New > Upload Plugin
- Upload the zip file and click Install Now
- Activate the plugin
- Follow the setup wizard
Requirements
- WordPress 5.0 or higher
- WooCommerce 4.0 or higher
- PHP 7.4 or higher
- A free Cloudflare account
- A Telegram bot (free, created via @BotFather)
FAQ
-
Does this plugin work in Iran?
-
Yes. That is the main reason wegram was built. Instead of connecting directly to the Telegram API (which is blocked in Iran), wegram routes messages through a Cloudflare Worker that you deploy yourself. This makes it fully functional on Iranian-hosted servers.
-
Do I need a paid Cloudflare account?
-
No. The free Cloudflare plan includes Workers with more than enough requests for normal WooCommerce stores (100,000 requests/day free).
-
Can I send notifications to multiple people?
-
Yes. You can enter multiple Telegram chat IDs separated by commas. Each recipient (user, group, or channel) will receive every notification.
-
Can I customize what the messages look like?
-
Yes. wegram includes a full message template editor. You can write a different template for each order status and use dynamic variables like
{name},{total}, and{items}. -
What order statuses are supported?
-
wegram supports all 8 default WooCommerce statuses: pending, processing, on-hold, completed, cancelled, refunded, failed, and checkout-draft. You choose which ones trigger a notification.
-
Is wegram compatible with HPOS?
-
Yes. wegram explicitly declares compatibility with WooCommerce High-Performance Order Storage (custom order tables).
-
Where can I get support?
-
- Email: support@yasacode.ir
- Telegram: @yasacode
- Website: https://yasacode.ir
Reviews
There are no reviews for this plugin.
Contributors & Developers
“wegram – Store Alerts with Telegram for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “wegram – Store Alerts 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.0
- Initial release
- Telegram bot integration via Cloudflare Worker proxy
- Support for 8 WooCommerce order statuses
- Customizable per-status message templates with 13 dynamic variables
- Multiple recipient support (users, groups, channels)
- Step-by-step 7-stage setup wizard
- Admin dashboard with live connection status
- Rate limiting to prevent duplicate notifications
- RTL layout support
- WooCommerce HPOS compatibility
