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.

rainafarai

<p>The “Notification for Telegram” plugin for WordPress is a tool that allows you to send notifications and messages to a Telegram channel, group or user/s when specific events occur on your WordPress site.<br />
This plugin is useful for monitoring critical events on your site, such as new comments, new user registrations, publishing activities, New forms sent,Woocommerce and Surecart orders, cart and lowstock, Mailchimp and more, by sending notifications directly to a Telegram channel or group or user/s of your choice. It also offers a shortcode to send Telegram notifications on every page of your website or in your code.</p>
<p>Receive Telegram messages notification when:</p>
<ul>
<li>When receive a new order in Woocommerce.</li>
<li>When a Woocommerce order change status.</li>
<li>When receive a new order in Surecart. </li>
<li>Every event captured by WP Activity Log plugin</li>
<li>New field in Woocommerce checkout page let customers add the own telegram nickname</li>
<li>Low Stock Product notifications when a product is low stock conditions.</li>
<li>Shows Telegram Nick link in admin order details page when present</li>
<li>When receive new forms (supports Elementor Pro Form, WPForm , CF7 and Ninjaform)</li>
<li>When new user subscribes  or unsubscribes to mailchimp. MC4WP integration</li>
<li>When new user registers. Helps identify unauthorized or suspicious registrations.</li>
<li>When users login or fail login.</li>
<li>When new comment is posted.</li>
<li>When someone adds or remove a product in the Woocommerce cart.</li>
<li>When a new Pending posts is received. (works with any post type)</li>
<li>Say function to speak to make the bot say Something to the people</li>
<li>Cron job detect and notify when Plugins & Core need to update. </li>
<li>Send custom message with Shortcode anywhere in your WP.</li>
<li>Should Work on Multisite</li>
</ul>
<p>You can enable/disable every notification in the Plugin settings page.</p>
<p>To configure the plugin, you need a valid Telegram API token. Its easy to get starting a Telegram Bot.<br />
You can learn about obtaining  tokens and generating new ones in</p>
<h4>Setup Guide</h4>
<p>A complete step-by-step guide is available here:<br />
<a href="https://docs.google.com/document/d/1HCa54OhOm9Vm0Jz2AUjQUHK71djzOUQBDZF-9NH7irU/edit?tab=t.0" rel="nofollow ugc">View the full documentation</a></p>
<p>To get your Bot Token, you can refer to one of these resources:</p>
<ul>
<li><a href="https://core.telegram.org/bots#6-botfather" title="Obtaining tokens and generating new ones" rel="nofollow ugc">Official Telegram documentation</a></li>
<li><a href="https://medium.com/shibinco/create-a-telegram-bot-using-botfather-and-get-the-api-token-900ba00e0f39" title="Create a Telegram bot using BotFather and Get the API Token" rel="nofollow ugc">Step-by-step guide on Medium</a></li>
</ul>
<p>To get your Chat ID, you need at least one recipient ID. You can retrieve it using one of these bots directly in Telegram:</p>
<ul>
<li><a href="https://telegram.me/chatIDrobot" title="@chatIDrobot" rel="nofollow ugc">@get_id_bot</a> — send /start and it will reply with your personal Chat ID</li>
<li><a href="https://t.me/RawDataBot" rel="nofollow ugc">@RawDataBot</a> — send any message and it will return your full account info including your ID</li>
</ul>
<p>For Channel and Group Chatid settings see the <a href="#faq" rel="nofollow ugc">FAQ section</a>.</p>
<p>Once You got the 2 fields save the configuration and try the “TEST” button .. you should receive a message in you telegram : “WOW IT WORKS” !! If not, check token and chatid fields again for the correct values.</p>
<p>this plugin is relying on a 3rd party service to geolocate the Ip address https://ip-api.com/<br />
https://ip-api.com/docs/legal  to see the services’ a terms of use and/or privacy policies</p>
<h3>AI & MCP Compatible</h3>
<p>This plugin supports the <strong>WordPress Abilities API</strong> and is compatible with<br />
<strong>MCP (Model Context Protocol)</strong> — the standard that allows AI agents like<br />
Claude, ChatGPT, and others to interact with WordPress autonomously.</p>
<p>If the <strong>Abilities API</strong> and <strong>MCP Adapter</strong> plugins are installed, any<br />
authorized AI agent can automatically discover and use the<br />
<strong>Send Telegram Message</strong> ability — no extra configuration needed.</p>
<p><strong>What an AI can do with this plugin:</strong><br />
* Send a Telegram message with custom text<br />
* Add an inline button with label and URL<br />
* Override the default chat ID</p>
<h4>Requirements for MCP</h4>
<ul>
<li>WordPress 6.9+</li>
<li>Plugin: Abilities API (WordPress/abilities-api)</li>
<li>Plugin: MCP Adapter (WordPress/mcp-adapter)</li>
</ul>
<h3>MESSAGES TRANSLATION</h3>
<p>To translate Telegram messages, use WPML or Loco Translate. All notification strings are now translatable.<br />
Go to Loco Translate <span aria-hidden="true" class="wp-exclude-emoji">→</span> Plugins <span aria-hidden="true" class="wp-exclude-emoji">→</span> Notification for Telegram to add your translations.<br />
For WPML, ensure String Translation is enabled to modify notification texts.</p>
<h3>ACTION HOOK for third-party Plugin</h3>
<p>Notification for Telegram (version > 3.5.1) exposes a dedicated action hook so any third-party plugin can send messages without calling internal functions directly.<br />
Basic usage:<br />
    do_action( ‘nftb_send_message’, ‘Your message here’ );</p>
<p>Look FAQ Section for more esamples.</p>
<h3>SHORTCODE EXAMPLE</h3>
<pre><code>[telegram_mess  message="Im so happy" chatids="0000000," token="000000000:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" showsitename="1" showip="1" showcity="1" ]
</code></pre>
<p>SHORTCODE OPTIONS:</p>
<ul>
<li>
<p>message : Your message to be sent. Example (message=”hello world”)</p>
</li>
<li>
<p>chatids : Recipient(s) who will receive your message separated by comma (example chatids=”0000000,11111111″) , If not present this field  the shortcode will use default value in Plugin option page.</p>
</li>
<li>
<p>token:  The token looks something like 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11<br />
If not present this field, the shortcode will use default value in Plugin option page.</p>
</li>
<li>
<p>showsitename: if set to “1” appends sitename after the message. Defaultvalue is “0” Example (showsitename=”1″)</p>
</li>
<li>
<p>showip: if set to “1” appends user ip address after the message. Default value is “0” Example (showip=”1″)</p>
</li>
<li>
<p>showcity: if set to “1” appends user city name after the message. Default value is “0” Example (showcity=”1″)</p>
</li>
</ul>
<p>USE SHORTCODE IN YOU PHP CODE</p>
<pre><code><?php

$date = date("d-m-Y");

do_shortcode('[telegram_mess  message="'.$date .'" chatids="0000000," token="000000000:AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA" showsitename="1" showip="1" showcity="1" ]'); 

?><h3>WOOCOMMERCE FILTER HOOKS</h3>
</code></pre>
<p>We have created 4 filter hooks for WooCommerce order notification message. 4 new positions: Message Header, Message Footer, before Items, and after Items. And we have created a filter through which you can add custom code to product rows, and if you want, you can replace and customize the entire row. :</p>
<p>4 new Positions and code axample ( echo payment_status in the 4 positions)</p>
<pre><code><?php
add_filter('nftb_order_header_message_hook', 'my_filter_function', 10, 1); 
add_filter('nftb_order_before_items_hook', 'my_filter_function', 10, 1);
add_filter('nftb_order_after_items_hook', 'my_filter_function', 10, 1);
add_filter('nftb_order_footer_message_hook', 'my_filter_function', 10, 1);

function my_filter_function($order_id) {
  $order = wc_get_order($order_id);
  if ($order) {
      // Get order details
      $order_data = $order->get_data();

      // Extract specific order information

      $payment_status = $order->get_status();
      $payment_method = $order->get_payment_method();  
  }
  return  "\r\n\r\n".$payment_method."(".$payment_status.")\r\n" ;
}
?>
</code></pre>
<p>Product rows Filter with 2 different behaviors ADD or REPLACE LINE</p>
<pre><code><?php
add_filter('nftb_order_product_line_hook', 'my_item_line_function', 10, 3);

function my_item_line_function($message ,$product_id, $item) {

    // ADD SOME CODE $product_id TO ORIGINAL row $message.
    $modified_data = $message. "->".$product_id. "\r\n";

    // REPLACE Product ITEM LINE CODE WITH YOUR CODE  without concatenate $message.
    $modified_data = $product_id. "\r\n";

    return $modified_data;
} 
?><h3>USER LOGIN FILTER HOOKS</h3>
<?php
// Triggered on successful user login
add_filter( 'nftb_login_notification', 'custom_message_modifier', 10, 1 );

// Triggered on new user registration
add_filter( 'nftb_user_registered_notification', 'custom_message_modifier', 10, 1 );

// Triggered when an existing user fails to login
add_filter( 'nftb_existing_user_fails_login_notification', 'custom_message_modifier', 10, 1 );

// Triggered when an unknown user fails to login
add_filter( 'nftb_unknown_user_fails_login_notification', 'custom_message_modifier', 10, 1 );

// Example: append the user registration date to the notification
function custom_message_modifier( $user_id ) {
    $user_info = get_userdata( $user_id );

    if ( $user_info ) {
        $registration_date = $user_info->user_registered;
        $timestamp         = strtotime( $registration_date );

        $formatter = new IntlDateFormatter( 'en_US', IntlDateFormatter::LONG, IntlDateFormatter::LONG, 'UTC' );
        $formatter->setPattern( 'd MMMM y HH:mm:ss' );

        $formatted_date = $formatter->format( $timestamp );
        $message = "\r\n\r\nUser Registration Date: " . $formatted_date . "\r\n\r\n";
    } else {
        $message = "\r\nNo info available for this user.\r\n";
    }

    return $message;
}
?><h3>LEGACY FUNCTIONS (kept for backward compatibility)</h3>
</code></pre>
<p>Before hooks were introduced, 3 overridable functions allowed message customization without editing plugin code. These are still supported but we encourage migrating to hooks.</p>
<p>1) Before the product list — example: prepend the Order ID</p>
<pre><code><?php
function nftb_order_before_items( $order_id ) {
    return "ORDER ID: " . $order_id;
}
?>
</code></pre>
<p>2) After the product list — example: append the order currency</p>
<pre><code><?php
function nftb_order_after_items( $order_id ) {
    $order = wc_get_order( $order_id );
    $data  = $order->get_data();
    return "Currency: " . $data['currency'];
}
?>
</code></pre>
<p>3) At the end of each product line — example: append the product slug</p>
<pre><code><?php
function nftb_order_product_line( $product_id, $item ) {
    $product = wc_get_product( $product_id );
    return " | " . $product->get_slug() . " ";
}
?>
</code></pre>
<p>Suggestions for new notifications, hooks, and plugin integrations are always welcome!</p>


Notification for Telegram

that are what i need


Your plugin send so many notification spam with content "please rate..."


Send many notification spam

Sends notifications to Telegram users or groups, when some events occur in WordPress.

Ultimate Integration for Telegram vs Notification for Telegram