The ultimate solution for connecting WordPress and WooCommerce to Telegram. With this plugin, you can send customized notifications to Telegram channels, groups, bots, or private chats. Packed with features like a Markdown Validator, extensive macros, and a notifications manager, this plugin ensures your Telegram automation is seamless and efficient.
Ultimate Integration for Telegram is the most versatile plugin for connecting WordPress and WooCommerce to Telegram. Easily send personalized notifications to Telegram channels, groups, bots, or private chats. The plugin offers powerful features like dynamic translation management, gettext replacement, and string customization to tailor messages for your audience. Designed for flexibility, it fully supports WooCommerce core and popular add-ons such as WooCommerce Subscription, WooCommerce Membership, WooCommerce Booking, WooCommerce Points and Reward, and WooCommerce Multi-Currency. With extensive developer hooks and filters, it’s open for seamless customization and new integrations. Whether for business, e-commerce, or automation, this plugin is the ultimate solution for managing Telegram notifications directly from your WordPress site.
- Comprehensive Notifications Panel: Manage notifications for WordPress, WooCommerce, and supported add-ons with ease.
- Send Notifications Anywhere: Send alerts to Telegram channels, groups, bots, or private chats.
- WooCommerce & Add-on Support: Fully supports WooCommerce and popular extensions, including:
- WooCommerce Subscriptions
- WooCommerce Memberships
- WooCommerce Bookings
- WooCommerce Points and Rewards
- WooCommerce Multi-Currency
- Built-in Jalali (Shamsi) Date Support: Automatically convert Gregorian dates to Jalali for Persian-speaking audiences.
- Import/Export Notifications: Easily migrate or duplicate notification settings across websites with JSON import/export.
- Macros for Dynamic Content: Customize notifications and buttons with an extensive list of predefined macros.
- Built-in Translation Manager: Dynamically translate and replace strings using the built-in gettext manager.
- String Replacement Tool: Replace placeholders or dynamic text in notifications effortlessly.
- HTML and Markdown Support: Create visually appealing messages with flexible formatting options.
- Markdown Validator: Validate messages for correct Markdown formatting to prevent rendering issues in Telegram.
- Custom Buttons: Add interactive buttons to your Telegram messages for better user engagement.
- Developer-Friendly: Extend functionality using extensive hooks and filters for full customization.
Macros are placeholders that get dynamically replaced with actual values in your Telegram messages and buttons. Below is a sample list of macros available in the plugin.
You can find the complete list of macros in the plugin under the Notifications > Available Macros section.
{current_date}: Current date.{current_time}: Current time.{current_date_time}: Current date and time.{current_user_id}: Current user ID.{current_user_name}: Current user name.{site_name}: Website name.{site_url}: Website URL.
{order_id}: Order ID.{order_number}: Order number.{order_status}: Order status.{order_total}: Total order amount.{order_subtotal}: Order subtotal amount.{order_tax_total}: Total tax amount.{order_discount_total}: Total discount amount.{customer_name}: Customer name.{customer_email}: Customer email.{customer_phone}: Customer phone number.
{edit_url}: Order edit URL (Admin).{view_url}: Order view URL (Customer).{pay_url}: Order payment URL.{cancel_url}: Order cancel URL.{thank_you_url}: Order thank-you page URL.{tracking_url}: Order tracking URL.
- WooCommerce Subscription:
{subscription_id}: Subscription ID.{subscription_status}: Subscription status.{subscription_total}: Subscription total amount.{subscription_start_date}: Subscription start date.{subscription_end_date}: Subscription end date.
- WooCommerce Membership:
{membership_plan}: Membership plan name.{membership_status}: Membership status.{membership_start_date}: Membership start date.{membership_end_date}: Membership expiration date.
- WooCommerce Booking:
{booking_id}: Booking ID.{booking_status}: Booking status.{booking_date}: Booking date.{booking_start_time}: Booking start time.{booking_end_time}: Booking end time.
Here are some examples of how you can use macros in your notifications:
Message:
🎉 New Order Received! 🎉
Order ID: {order_id}
Customer: {customer_name}
Total: {order_total}
View Order: {edit_url}
Message:
🔔 Subscription Renewal Alert 🔔
Subscription ID: {subscription_id}
Plan: {membership_plan}
Next Payment Date: {subscription_end_date}
Message:
✅ Booking Confirmed ✅
Booking ID: {booking_id}
Date: {booking_date}
Start Time: {booking_start_time}
End Time: {booking_end_time}
In addition to WordPress and WooCommerce core, the plugin supports:
- WooCommerce Subscription
- WooCommerce Membership
- WooCommerce Booking
- WooCommerce Points and Reward
- WooCommerce Multi-Currency
- Contact Form 7 (coming soon)
- Gravity Form (coming soon)
The plugin is also open to integration with other plugins via hooks and filters.
- Install the Plugin: Upload and activate it via the WordPress admin dashboard.
- Configure General Settings:
- Go to Settings > Telegram.
- Enter your Telegram Bot Token and username.
- Enable or disable options like Jalali date conversion and admin bar link.
- Connect the Telegram Bot:
- Click "Connect Webhook" to enable Telegram integration.
- Use "Send Test Message" to verify the setup.
- Create Notifications:
- Navigate to the Notifications tab to manage or add new notifications.
- Customize the message, macros, and formatting for each notification type.
- Open Telegram and search for @BotFather.
- Start a chat and use the
/newbotcommand to create a bot. - Follow the instructions to name your bot and get the Bot Token.
- Paste the token into the plugin’s settings under Your Bot Token.
- Use
/setprivacyin BotFather to allow the bot to receive messages.
- Go to the Notifications tab in the plugin settings.
- Select an existing notification or create a new one.
- Customize the message and macros for each event (e.g., WooCommerce order created, status changed, email sent).
- Save the notification to enable it.
- Use the Import/Export button in the Notifications tab to transfer settings.
- Export configurations as JSON to duplicate them on another website.
- Import JSON files to quickly set up predefined notifications.
This plugin is provided "as is" without any warranties, express or implied. While every effort has been made to ensure reliability and security, the developers are not responsible for any issues arising from its use. Always test in a staging environment before deploying to production.
We welcome contributions to improve the plugin! If you have feature requests, bug reports, or suggestions, please create a GitHub issue or pull request.
For support, contact us at support (@) pigment (.) dev.
This plugin is licensed under the GPL v2.0 or later. You are free to use, modify, and distribute the plugin under these terms.
Please report security bugs found in the source code of the Ultimate Integration for Telegram plugin through the Patchstack Vulnerability Disclosure Program. The Patchstack team will assist you with verification, CVE assignment, and notify the developers of this plugin.
- Two New Integration Added; Gravity Forms and Contact Form 7 🔥🎉
- Improved stability and minor bug fixes.
- Added Gravity Forms support for notifications.
- Added Gravity Form selection in Notification settings via Chosen.js dropdown.
- Added Contact form 7 support for notifications.
- Added Contact form 7 selection in Notification settings via Chosen.js dropdown.
- Added Description on Translation panel for better user understanding.
- Added Patchstack Vulnerability Disclosure Program link for reporting security issues.
- Fixed Sending test message sometimes fails due to parse entities issue.
- Fixed Forwarding message to bot from public group/channel now shows original sender's Chat ID.
- Fixed Comments Notifications and Hooks and Also added new macros for comments.
- Enhanced Notification panel UX by collapsing advanced options.
- Fixed Order Refund notification not sending proper messages.
- Fixed formatting order totals and prices according to woocommerce settings.
- Fixed not sending notifications when product stock is restored by order cancellation.
- Fixed:
{order_items_quantity_list}macro now correctly prints product names.
- New UI and improved user experience throughout the plugin.
- Added import/export feature for notifications and settings.
- Added default message content and a list of default messages.
- Changed the method for saving settings in the database for better reliability.
- Added support for custom Telegram bot servers.
- Added channel agent feature for advanced channel management.
- Introduced a step-by-step setup wizard on the plugin settings page.
- Added support for notification and notification categories to have descriptions.
- Added ability to customize recipients per message.
- Enhanced Markdown validator for more robust message formatting.
- Merged translations and string replacement panels into a single translation tool.
- Switched to offloaded Font Awesome v7 for improved performance and up-to-date icon support.
- Improved stability and minor bug fixes.
- Enhanced security checks for safer operation.
- Added New Integration: WordPress Comments
- Added New Integration: WooCommerce Comments
- Added Pre-defined Notification Text
- Added Pre-defined Notifications List on first setup
- Added Setup Wizard & Enhanced Setup UIX
- Set minimum PHP required to 7.4
- Fixed Markdown Validator
- Initial release of Ultimate Integration for Telegram.
- Telegram bot integration with webhook support.
- Notification macros and string replacement features.
- Full WooCommerce integration.