About this plugin
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/