Amirhossein Hosseinpour

BlackSwanDev

Pigment Development

<p><strong>Ultimate Integration for Telegram</strong> is 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.</p>
<p>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.</p>
<h3>Features</h3>
<ul>
<li><strong>Comprehensive Notifications Panel</strong>: Manage notifications for WordPress, WooCommerce, and supported add-ons with ease.</li>
<li><strong>Send Notifications Anywhere</strong>: Send alerts to Telegram channels, groups, bots, or private chats.</li>
<li><strong>WooCommerce & Add-on Support</strong>: Fully supports WooCommerce and popular extensions, including:
<ul>
<li>WooCommerce Subscriptions</li>
<li>WooCommerce Memberships</li>
<li>WooCommerce Bookings</li>
<li>WooCommerce Points and Rewards</li>
<li>WooCommerce Multi-Currency</li>
</ul>
</li>
<li><strong>Built-in Jalali (Shamsi) Date Support</strong>: Automatically convert Gregorian dates to Jalali for Persian-speaking audiences.</li>
<li><strong>Import/Export Notifications</strong>: Easily migrate or duplicate notification settings across websites with JSON import/export.</li>
<li><strong>Macros for Dynamic Content</strong>: Customize notifications and buttons with an extensive list of predefined macros.</li>
<li><strong>Built-in Translation Manager</strong>: Dynamically translate and replace strings using the built-in gettext manager.</li>
<li><strong>String Replacement Tool</strong>: Replace placeholders or dynamic text in notifications effortlessly.</li>
<li><strong>HTML and Markdown Support</strong>: Create visually appealing messages with flexible formatting options.</li>
<li><strong>Markdown Validator</strong>: Validate messages for correct Markdown formatting to prevent rendering issues in Telegram.</li>
<li><strong>Custom Buttons</strong>: Add interactive buttons to your Telegram messages for better user engagement.</li>
<li><strong>Developer-Friendly</strong>: Extend functionality using extensive hooks and filters for full customization.</li>
</ul>
<h3>Available Macros</h3>
<p>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.</p>
<p>You can find the complete list of macros in the plugin under the Notifications > Available Macros section.</p>
<h3>General Macros</h3>
<ul>
<li><code>{current_date}</code>: Current date.</li>
<li><code>{current_time}</code>: Current time.</li>
<li><code>{current_date_time}</code>: Current date and time.</li>
<li><code>{current_user_id}</code>: Current user ID.</li>
<li><code>{current_user_name}</code>: Current user name.</li>
<li><code>{site_name}</code>: Website name.</li>
<li><code>{site_url}</code>: Website URL.</li>
</ul>
<h3>WooCommerce Order Details</h3>
<ul>
<li><code>{order_id}</code>: Order ID.</li>
<li><code>{order_number}</code>: Order number.</li>
<li><code>{order_status}</code>: Order status.</li>
<li><code>{order_total}</code>: Total order amount.</li>
<li><code>{order_subtotal}</code>: Order subtotal amount.</li>
<li><code>{order_tax_total}</code>: Total tax amount.</li>
<li><code>{order_discount_total}</code>: Total discount amount.</li>
<li><code>{customer_name}</code>: Customer name.</li>
<li><code>{customer_email}</code>: Customer email.</li>
<li><code>{customer_phone}</code>: Customer phone number.</li>
</ul>
<h3>WooCommerce Order URLs</h3>
<ul>
<li><code>{edit_url}</code>: Order edit URL (Admin).</li>
<li><code>{view_url}</code>: Order view URL (Customer).</li>
<li><code>{pay_url}</code>: Order payment URL.</li>
<li><code>{cancel_url}</code>: Order cancel URL.</li>
<li><code>{thank_you_url}</code>: Order thank-you page URL.</li>
<li><code>{tracking_url}</code>: Order tracking URL.</li>
</ul>
<h3>WooCommerce Add-ons</h3>
<ul>
<li><strong>WooCommerce Subscription</strong>:
<ul>
<li><code>{subscription_id}</code>: Subscription ID.</li>
<li><code>{subscription_status}</code>: Subscription status.</li>
<li><code>{subscription_total}</code>: Subscription total amount.</li>
<li><code>{subscription_start_date}</code>: Subscription start date.</li>
<li><code>{subscription_end_date}</code>: Subscription end date.</li>
</ul>
</li>
<li><strong>WooCommerce Membership</strong>:
<ul>
<li><code>{membership_plan}</code>: Membership plan name.</li>
<li><code>{membership_status}</code>: Membership status.</li>
<li><code>{membership_start_date}</code>: Membership start date.</li>
<li><code>{membership_end_date}</code>: Membership expiration date.</li>
</ul>
</li>
<li><strong>WooCommerce Booking</strong>:
<ul>
<li><code>{booking_id}</code>: Booking ID.</li>
<li><code>{booking_status}</code>: Booking status.</li>
<li><code>{booking_date}</code>: Booking date.</li>
<li><code>{booking_start_time}</code>: Booking start time.</li>
<li><code>{booking_end_time}</code>: Booking end time.</li>
</ul>
</li>
</ul>
<h3>Sample Messages</h3>
<p>Here are some examples of how you can use macros in your notifications:</p>
<h3>Example 1: New Order Notification</h3>
<p><strong>Message:</strong></p>
<pre><code>🎉 New Order Received! 🎉

Order ID: {order_id}
Customer: {customer_name}
Total: {order_total}

View Order: {edit_url}
</code></pre>
<h3>Example 2: Subscription Renewal Reminder</h3>
<p><strong>Message:</strong></p>
<pre><code>🔔 Subscription Renewal Alert 🔔

Subscription ID: {subscription_id}
Plan: {membership_plan}
Next Payment Date: {subscription_end_date}
</code></pre>
<h3>Example 3: Booking Confirmation</h3>
<p><strong>Message:</strong></p>
<pre><code>✅ Booking Confirmed ✅

Booking ID: {booking_id}
Date: {booking_date}
Start Time: {booking_start_time}
End Time: {booking_end_time}
</code></pre>
<h3>Supported Add-ons and Plugins</h3>
<p>In addition to WordPress Core and WooCommerce, the plugin also supports:<br />
– Gravity Forms<br />
– Contact Form 7<br />
– WooCommerce Subscription<br />
– WooCommerce Membership<br />
– WooCommerce Booking<br />
– WooCommerce Points and Reward<br />
– WooCommerce Multi-Currency</p>
<p>The plugin is also open to integration with other plugins via hooks and filters.</p>
<h3>How to Setup the Plugin</h3>
<ol>
<li><strong>Install the Plugin</strong>: Upload and activate it via the WordPress admin dashboard.</li>
<li><strong>Configure General Settings</strong>:
<ul>
<li>Go to <strong>Settings > Telegram</strong>.</li>
<li>Enter your Telegram Bot Token and username.</li>
<li>Enable or disable options like Jalali date conversion and admin bar link.</li>
</ul>
</li>
<li><strong>Connect the Telegram Bot</strong>:
<ul>
<li>Click “Connect Webhook” to enable Telegram integration.</li>
<li>Use “Send Test Message” to verify the setup.</li>
</ul>
</li>
<li><strong>Create Notifications</strong>:
<ul>
<li>Navigate to the <strong>Notifications</strong> tab to manage or add new notifications.</li>
<li>Customize the message, macros, and formatting for each notification type.</li>
</ul>
</li>
</ol>
<h3>How to Setup a Telegram Bot</h3>
<ol>
<li>Open Telegram and search for <strong>@BotFather</strong>.</li>
<li>Start a chat and use the <code>/newbot</code> command to create a bot.</li>
<li>Follow the instructions to name your bot and get the <strong>Bot Token</strong>.</li>
<li>Paste the token into the plugin’s settings under <strong>Your Bot Token</strong>.</li>
<li>Use <code>/setprivacy</code> in BotFather to allow the bot to receive messages.</li>
</ol>
<h3>How to Add Custom Notifications</h3>
<ol>
<li>Go to the <strong>Notifications</strong> tab in the plugin settings.</li>
<li>Select an existing notification or create a new one.</li>
<li>Customize the message and macros for each event (e.g., WooCommerce order created, status changed, email sent).</li>
<li>Save the notification to enable it.</li>
</ol>
<h3>Import/Export Notifications</h3>
<ul>
<li>Use the <strong>Import/Export</strong> button in the Notifications tab to transfer settings.</li>
<li>Export configurations as JSON to duplicate them on another website.</li>
<li>Import JSON files to quickly set up predefined notifications.</li>
</ul>
<h3>Disclaimer and Warranty</h3>
<p>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.</p>
<h3>Contribution and Support</h3>
<p>We welcome contributions to improve the plugin! If you have feature requests, bug reports, or suggestions, please create a GitHub issue or pull request.</p>
<p>Github Repository: <a href="https://github.com/pigment-dev/ultimate-integration-for-telegram" rel="nofollow ugc">https://github.com/pigment-dev/ultimate-integration-for-telegram</a></p>
<p>For support, contact us at <strong><a href="mailto:support@pigment.dev" rel="nofollow ugc">support (at) pigment (dot) dev</a></strong>.</p>
<h3>Third-Party & External Resources Used</h3>
<p>This plugin utilizes the following third-party libraries to enhance functionality:</p>
<ol>
<li>
<p>Tippy.js v6.3.7</p>
<ul>
<li><strong>Description</strong>: Tippy.js is a lightweight, customizable tooltip library. It is used in this plugin to provide user-friendly tooltips for better UI/UX.</li>
<li><strong>License</strong>: MIT License</li>
<li><strong>Source</strong>: <a href="https://atomiks.github.io/tippyjs/" rel="nofollow ugc">https://atomiks.github.io/tippyjs/</a></li>
</ul>
</li>
<li>
<p>jQuery Repeater v1.2.2</p>
<ul>
<li><strong>Description</strong>: jQuery Repeater is a library that allows dynamic addition and removal of form fields. It is used in this plugin to manage repeatable input fields.</li>
<li><strong>License</strong>: MIT License</li>
<li><strong>Source</strong>: <a href="https://github.com/DubFriend/jquery.repeater" rel="nofollow ugc">https://github.com/DubFriend/jquery.repeater</a></li>
</ul>
</li>
<li>
<p>Font Awesome (Free Version)</p>
<ul>
<li><strong>Description</strong>: Font Awesome is used to provide icons ONLY on the plugin’s settings page for a better user experience.</li>
<li><strong>Source</strong>: <a href="https://github.com/FortAwesome/Font-Awesome" rel="nofollow ugc">https://github.com/FortAwesome/Font-Awesome</a></li>
<li><strong>License</strong>: <a href="https://fontawesome.com/license/free" rel="nofollow ugc">Font Awesome Free License</a>.</li>
<li><strong>No Account Required</strong>: No additional setup or account is needed.</li>
</ul>
</li>
<li>
<p>Chosen.js v1.8.7</p>
<ul>
<li><strong>Description</strong>: Chosen is a library for making long, unwieldy select boxes more user-friendly. It is used in this plugin to enhance the user experience when selecting options.</li>
<li><strong>Source</strong>: <a href="https://harvesthq.github.io/chosen/" rel="nofollow ugc">https://harvesthq.github.io/chosen/</a></li>
<li><strong>License</strong>: <a href="https://opensource.org/licenses/MIT" rel="nofollow ugc">MIT License</a>.</li>
<li><strong>No Account Required</strong>: No additional setup or account is needed.</li>
</ul>
</li>
</ol>


Ultimate Integration for Telegram

The most versatile plugin for connecting WordPress to Telegram. Easily send personalized notifications to Telegram channels, groups, or private chats.

yasinansarizadeh

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


wegram – Store Alerts with Telegram for WooCommerce

Automatically send WooCommerce order notifications to Telegram via Cloudflare Worker. Fully compatible with Iran's network restrictions.

Ultimate Integration for Telegram vs wegram – Store Alerts with Telegram for WooCommerce