{"id":251897,"date":"2025-11-05T16:21:19","date_gmt":"2025-11-05T16:21:19","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/telegram-sync-for-woocommerce\/"},"modified":"2026-04-15T07:14:15","modified_gmt":"2026-04-15T07:14:15","slug":"refatbd-notifications-with-telegram-for-woocommerce","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/refatbd-notifications-with-telegram-for-woocommerce\/","author":23317536,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.1.0","stable_tag":"2.1.0","tested":"6.9.4","requires":"5.0","requires_php":"7.4","requires_plugins":null,"header_name":"RefatBd notifications with Telegram for Woocommerce","header_author":"Refat","header_description":"Sends instant, secure, and custom-templated notifications to Telegram for WooCommerce events with advanced conditional logic to a single chat ID.","assets_banners_color":"4c89a4","last_updated":"2026-04-15 07:14:15","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/refat.ovh\/donate","header_plugin_uri":"https:\/\/refat.ovh\/refatbd-notifications-with-telegram-for-woocommerce","header_author_uri":"https:\/\/refat.ovh","rating":0,"author_block_rating":0,"active_installs":0,"downloads":282,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"2.0.0":{"tag":"2.0.0","author":"refatbd","date":"2025-11-05 16:21:08"},"2.0.1":{"tag":"2.0.1","author":"refatbd","date":"2025-12-09 10:02:08"},"2.0.2":{"tag":"2.0.2","author":"refatbd","date":"2025-12-12 14:27:37"},"2.1.0":{"tag":"2.1.0","author":"refatbd","date":"2026-04-15 07:14:15"}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-256x256.png":{"filename":"icon-256x256.png","revision":3390586,"resolution":"256x256","location":"assets","locale":""}},"assets_banners":{"banner-1544x500.jpg":{"filename":"banner-1544x500.jpg","revision":3390586,"resolution":"1544x500","location":"assets","locale":""},"banner-772x250.jpg":{"filename":"banner-772x250.jpg","revision":3390586,"resolution":"772x250","location":"assets","locale":""}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["2.0.0","2.0.1","2.0.2","2.1.0"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3390586,"resolution":"1","location":"assets","locale":""},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3390586,"resolution":"2","location":"assets","locale":""},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3390586,"resolution":"3","location":"assets","locale":""},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3390586,"resolution":"4","location":"assets","locale":""}},"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[15962,130308,4906,9171,286],"plugin_category":[45],"plugin_contributors":[244516],"plugin_business_model":[],"class_list":["post-251897","plugin","type-plugin","status-publish","hentry","plugin_tags-abandoned-cart","plugin_tags-conditional-logic","plugin_tags-notifications","plugin_tags-telegram","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-refatbd","plugin_committers-refatbd"],"banners":{"banner":"https:\/\/ps.w.org\/refatbd-notifications-with-telegram-for-woocommerce\/assets\/banner-772x250.jpg?rev=3390586","banner_2x":"https:\/\/ps.w.org\/refatbd-notifications-with-telegram-for-woocommerce\/assets\/banner-1544x500.jpg?rev=3390586","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/refatbd-notifications-with-telegram-for-woocommerce\/assets\/icon-256x256.png?rev=3390586","icon_2x":"https:\/\/ps.w.org\/refatbd-notifications-with-telegram-for-woocommerce\/assets\/icon-256x256.png?rev=3390586","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/refatbd-notifications-with-telegram-for-woocommerce\/assets\/screenshot-1.png?rev=3390586","caption":""},{"src":"https:\/\/ps.w.org\/refatbd-notifications-with-telegram-for-woocommerce\/assets\/screenshot-2.png?rev=3390586","caption":""},{"src":"https:\/\/ps.w.org\/refatbd-notifications-with-telegram-for-woocommerce\/assets\/screenshot-3.png?rev=3390586","caption":""},{"src":"https:\/\/ps.w.org\/refatbd-notifications-with-telegram-for-woocommerce\/assets\/screenshot-4.png?rev=3390586","caption":""}],"raw_content":"<!--section=description-->\n<p>RefatBd notifications with Telegram for Woocommerce is a powerful and flexible tool for WooCommerce store owners who want to receive real-time updates via Telegram.\nIt integrates seamlessly with a secure, private API, ensuring your store's communication is both instant and safe.<\/p>\n\n<p>This plugin allows you to send automated, template-based notifications for a wide range of events, including order status changes, new user registrations, product stock updates, abandoned checkouts, new product reviews, and more, directly to your chosen Telegram chat.<\/p>\n\n<p><strong>\ud83d\ude80 NEW: Customer Notifications System!<\/strong>\nExpand your store's capability by allowing your customers to receive real-time updates about their orders.\n* <strong>Seamless Connection:<\/strong> Customers can connect their Telegram account via a secure \"Connect\" button on the \"Thank You\" page or \"My Account\" dashboard.\n* <strong>Guest Support:<\/strong> Unique logic identifies guest users by their Email or Phone number, ensuring they receive updates for future orders even without a WordPress account.\n* <strong>Secure Handshake:<\/strong> Uses a deep-link token system to securely link Telegram users to your store without manual ID entry.<\/p>\n\n<p><strong>Key Features:<\/strong><\/p>\n\n<ul>\n<li><strong>WooCommerce HPOS Compatible:<\/strong> Fully supports WooCommerce High-Performance Order Storage (HPOS).<\/li>\n<li><strong>Secure API Integration:<\/strong> Connects to a private Telegram API Backend (<code>https:\/\/tgapi.refat.ovh\/api.php<\/code>), keeping your sensitive Bot Token secure and off your server.<\/li>\n<li><strong>Admin Notifications:<\/strong> Get alerts for order status changes, new user registrations (including admins), stock changes, low\/out of stock alerts, abandoned checkouts, new product reviews, coupon usage, failed login attempts, and product price changes.<\/li>\n<li><strong>Customer Notifications:<\/strong> Send automated order status updates directly to your customers' Telegram accounts. Supports both registered users and guests.<\/li>\n<li><strong>Connection Management:<\/strong> View connected users and guests in the admin panel. Easily disconnect or block abusive users.<\/li>\n<li><strong>Advanced Conditional Logic:<\/strong> Create rules based on product IDs, categories, tags, order total, quantity, customer details, payment methods, shipping zones, coupon codes, custom fields, time of day, and stock levels.<\/li>\n<li><strong>Single Chat ID Support (Admin):<\/strong> Send admin notifications reliably to one configured Telegram chat. (Upgrade to Pro for multiple chat support).<\/li>\n<li><strong>Customizable Message Templates:<\/strong> Use a wide array of placeholders to craft detailed and informative messages for every event.<\/li>\n<li><strong>PPOM Integration:<\/strong> Automatically includes data from PPOM fields in your order notifications if the PPOM plugin is active.<\/li>\n<li><strong>User-Friendly Admin Panel:<\/strong> A clean, modern, tabbed interface to manage all settings with ease.<\/li>\n<li><strong>History &amp; Logging:<\/strong> Keep a complete record of all sent messages and utilize detailed logs for troubleshooting.<\/li>\n<li><strong>Scheduled Messages:<\/strong> Schedule custom messages to be sent to your Telegram chat at a future date and time.<\/li>\n<li><strong>Telegram Commands:<\/strong> Interact with your store directly from Telegram (e.g., <code>\/sales<\/code>, <code>\/order &lt;id&gt;<\/code>, <code>\/stock &lt;id|sku|low|out&gt;<\/code>).<\/li>\n<\/ul>\n\n<h3>How to Use<\/h3>\n\n<ol>\n<li><strong>Connect Your Website:<\/strong>\n\n<ul>\n<li>In your WordPress admin, go to <strong>Telegram Sync -&gt; API Connection<\/strong>.<\/li>\n<li>The default API URL (<code>https:\/\/tgapi.refat.ovh\/api.php<\/code>) is provided. Ensure this is correct.<\/li>\n<li>Click the <strong>\"Fetch API Key\"<\/strong> button. This securely connects your site to the backend and saves your API key.<\/li>\n<li>Verify that the API Status and Site Connection show as \"Connected\".<\/li>\n<\/ul><\/li>\n<li><strong>Configure Admin Chat ID:<\/strong>\n\n<ul>\n<li>Go to <strong>Telegram Sync -&gt; Settings -&gt; Chat Management<\/strong>.<\/li>\n<li>Find the active bot's username on the <strong>API Connection<\/strong> page. Send the command <code>\/myid<\/code> to that bot in Telegram.<\/li>\n<li>Enter the numeric Chat ID you received into the fields on the Chat Management tab and click \"Save Changes\".<\/li>\n<\/ul><\/li>\n<li><strong>Configure Notifications:<\/strong>\n\n<ul>\n<li>Go through the tabs under <strong>Telegram Sync -&gt; Settings<\/strong> (General, Order Status, Customer Notifications, etc.).<\/li>\n<li><strong>Admin:<\/strong> Use the toggle switches to enable the notifications you want to receive yourself.<\/li>\n<li><strong>Customer:<\/strong> Go to the \"Customer Notifications\" tab and enable \"Enable Customer Notifications\". Customize the templates customers will receive.<\/li>\n<\/ul><\/li>\n<li><strong>Set Up Notification Rules (Optional):<\/strong>\n\n<ul>\n<li>Navigate to the <strong>Notification Rules<\/strong> tab to create advanced conditions for any enabled notification event.<\/li>\n<\/ul><\/li>\n<li><strong>Enable the Plugin:<\/strong>\n\n<ul>\n<li>Ensure the \"Enable Plugin\" toggle is switched on in the <strong>General<\/strong> tab.<\/li>\n<\/ul><\/li>\n<\/ol>\n\n<p><strong>Available Placeholders:<\/strong><\/p>\n\n<ul>\n<li><strong>For Order Status Notifications:<\/strong> <code>{site_title}<\/code>, <code>{customer_name}<\/code>, <code>{order_id}<\/code>, <code>{order_status}<\/code>, <code>{product_list}<\/code>, <code>{total_price}<\/code>, <code>{total_price_formatted}<\/code>, <code>{billing_address}<\/code>, <code>{shipping_address}<\/code>, <code>{ppom_data}<\/code>, <code>{payment_method}<\/code>, <code>{shipping_method}<\/code>, <code>{customer_note}<\/code>, <code>{date_created}<\/code>, <code>{date_paid}<\/code>, <code>{date_completed}<\/code>, <code>{billing_email}<\/code>, <code>{billing_phone}<\/code>.<\/li>\n<li><strong>For New User Notifications:<\/strong> <code>{site_title}<\/code>, <code>{user_login}<\/code>, <code>{user_email}<\/code>.<\/li>\n<li><strong>For New Admin User Notifications:<\/strong> <code>{site_title}<\/code>, <code>{user_login}<\/code>, <code>{user_email}<\/code>, <code>{user_roles}<\/code>.<\/li>\n<li><strong>For Stock Notifications:<\/strong> <code>{site_title}<\/code>, <code>{product_name}<\/code>, <code>{product_sku}<\/code>, <code>{stock_status}<\/code>.<\/li>\n<li><strong>For Low\/Out of Stock Alerts:<\/strong> <code>{site_title}<\/code>, <code>{product_name}<\/code>, <code>{product_sku}<\/code>, <code>{stock_status}<\/code>, <code>{stock_quantity}<\/code>, <code>{alert_type}<\/code>.<\/li>\n<li><strong>For Abandoned Cart:<\/strong> <code>{customer_name}<\/code>, <code>{customer_email}<\/code>, <code>{customer_phone}<\/code>, <code>{date_created}<\/code>, <code>{product_list}<\/code>, <code>{variation_data}<\/code>, <code>{ppom_data}<\/code>.<\/li>\n<li><strong>For New Product Reviews:<\/strong> <code>{site_title}<\/code>, <code>{product_name}<\/code>, <code>{product_link}<\/code>, <code>{reviewer_name}<\/code>, <code>{reviewer_email}<\/code>, <code>{review_content}<\/code>, <code>{review_rating}<\/code>, <code>{review_link}<\/code>.<\/li>\n<li><strong>For Coupon Usage:<\/strong> <code>{site_title}<\/code>, <code>{order_id}<\/code>, <code>{customer_name}<\/code>, <code>{total_price_formatted}<\/code>, <code>{coupon_codes}<\/code>, <code>{coupon_count}<\/code>.<\/li>\n<li><strong>For Failed Login Attempts:<\/strong> <code>{site_title}<\/code>, <code>{username}<\/code>, <code>{ip_address}<\/code>, <code>{failed_attempts}<\/code>, <code>{threshold}<\/code>.<\/li>\n<li><strong>For Product Price Changes:<\/strong> <code>{site_title}<\/code>, <code>{product_name}<\/code>, <code>{product_sku}<\/code>, <code>{old_price}<\/code>, <code>{new_price}<\/code>, <code>{price_change_text}<\/code>, <code>{percentage_change}<\/code>, <code>{product_link}<\/code>.<\/li>\n<\/ul>\n\n<h3>External Services<\/h3>\n\n<p>This plugin relies on a mandatory third-party API service hosted at <code>https:\/\/tgapi.refat.ovh\/api.php<\/code> to function.\n* <strong>What the service is and what it is used for:<\/strong> The service acts as a secure intermediary between your WooCommerce store and the Telegram messaging service. It allows your site to send notifications without exposing your sensitive Telegram Bot Token. It also handles the secure \"handshake\" for connecting customers to your store via Telegram.\n* <strong>What data is sent:<\/strong>\n    * <strong>Connection:<\/strong> Your domain and a site secret are sent to register the site.\n    * <strong>Notifications:<\/strong> Message content (which may include order\/customer details based on your templates) and the recipient's Chat ID.\n    * <strong>Customer Linking:<\/strong> When a customer connects, a temporary token is generated and validated against the API to securely exchange their Chat ID.\n* <strong>Service's Terms of Use and Privacy Policy:<\/strong>\n    * <a href=\"https:\/\/refat.ovh\/tgapi-terms-of-service\">Terms of Use<\/a>\n    * <a href=\"https:\/\/refat.ovh\/tgapi-privacy-policy\">Privacy Policy<\/a><\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the <code>refatbd-notifications-with-telegram-for-woocommerce<\/code> folder to your <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in your WordPress dashboard.<\/li>\n<li>Navigate to the <strong>Telegram Sync<\/strong> menu in your WordPress dashboard to begin configuration.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20work%20for%20guest%20users%3F\"><h3>Does this work for Guest users?<\/h3><\/dt>\n<dd><p>Yes! Version 2.1.0 introduces Guest support. If a guest clicks \"Connect Telegram\" on the Thank You page, we link their Chat ID to their billing email and phone number. Future orders with those details will automatically trigger notifications.<\/p><\/dd>\n<dt id=\"can%20customers%20disconnect%3F\"><h3>Can customers disconnect?<\/h3><\/dt>\n<dd><p>Yes. If a customer is connected, the button on their \"My Account\" or \"Thank You\" page changes to \"Disconnect\". They can click this to stop receiving notifications. Admins can also disconnect users from the backend.<\/p><\/dd>\n<dt id=\"why%20am%20i%20not%20receiving%20notifications%3F\"><h3>Why am I not receiving notifications?<\/h3><\/dt>\n<dd><ol>\n<li><strong>Check API Connection:<\/strong> Ensure \"API Status\" is Connected.<\/li>\n<li><strong>Check Chat ID:<\/strong> Send <code>\/myid<\/code> to the bot and verify the ID in settings.<\/li>\n<li><strong>Bot Started:<\/strong> Ensure you (or the customer) have pressed \"Start\" on the bot.<\/li>\n<li><strong>Logs:<\/strong> Check the <strong>Telegram Sync -&gt; Logs<\/strong> tab for \"Limit Reached\" or other errors.<\/li>\n<\/ol><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>FEATURE: Added Customer Notifications system for real-time order updates.<\/li>\n<li>FEATURE: Added support for Guest users (tracking via Email\/Phone).<\/li>\n<li>FEATURE: Added \"Connect Telegram\" button to Thank You and My Account pages.<\/li>\n<li>FEATURE: Added Connection Management page (View, Disconnect, Block users).<\/li>\n<li>FEATURE: Added secure \"Deep Link\" handshake for connecting Telegram users.<\/li>\n<li>UPDATE: Database schema updates for guest and blocked user management.<\/li>\n<li>FIX: Improved API Handler structure and reliability.<\/li>\n<li>FIX: Partial batch send now correctly fires rntfw_telegram_message_sent with only successfully queued IDs.<\/li>\n<\/ul>\n\n<h4>2.0.2<\/h4>\n\n<ul>\n<li>SECURITY: Hardened database queries in <code>RNTFW_DB<\/code> class.<\/li>\n<li>FIX: Resolved \"Unescaped parameter\" warnings.<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>COMPATIBILITY: Tested up to WordPress 6.9.<\/li>\n<li>FIX: Resolved fatal error \"Class RNTFW_Admin not found\" on frontend.<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>MAJOR: Restructured plugin to comply with WordPress.org guidelines.<\/li>\n<li>UPDATED: Readme \"External Services\" section.<\/li>\n<\/ul>","raw_excerpt":"Send instant, secure, and custom-templated Telegram notifications for WooCommerce events (Admin &amp; Customer) with advanced conditional logic.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/251897","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=251897"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/refatbd"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=251897"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=251897"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=251897"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=251897"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=251897"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=251897"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}