RefatBd notifications with Telegram for Woocommerce

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.
It integrates seamlessly with a secure, private API, ensuring your store’s communication is both instant and safe.
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.
Now with Advanced Conditional Logic: Gain granular control over your notifications.
Define precise rules based on product details, categories, order totals, customer attributes, payment and shipping methods, coupon usage, and even specific times of day to ensure you only receive the alerts that matter most.

Key Features:

• WooCommerce HPOS Compatible: Fully supports WooCommerce High-Performance Order Storage (HPOS).
• Secure API Integration: Connects to a private Telegram API Backend (https://tgapi.refat.ovh/api.php), keeping your sensitive Bot Token secure and off your server.
  See “External Services” section below for details.
• Comprehensive Notifications: 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.
• Advanced Conditional Logic: Create rules based on product IDs, categories, tags, order total, quantity, customer details (ID, role, guest status), payment methods, shipping zones, coupon codes, custom fields, time of day, and stock levels.
• Single Chat ID Support: Send notifications reliably to one configured Telegram chat. (Upgrade to Pro for multiple chat support).
• Customizable Message Templates: Use a wide array of placeholders to craft detailed and informative messages for every event.
• PPOM Integration: Automatically includes data from PPOM fields in your order notifications if the PPOM plugin is active.
• User-Friendly Admin Panel: A clean, modern, tabbed interface to manage all settings with ease.
• History & Logging: Keep a complete record of all sent messages and utilize detailed logs for troubleshooting.
• Scheduled Messages: Schedule custom messages to be sent to your Telegram chat at a future date and time.
• Telegram Commands: Interact with your store directly from Telegram (e.g., /sales, /order <id>, /stock <id|sku|low|out>).

How to Use

1. Connect Your Website:
   • In your WordPress admin, go to Telegram Sync -> API Connection.
   • The default API URL (https://tgapi.refat.ovh/api.php) is provided. Ensure this is correct.
     If you self-host the backend, enter your URL and click “Save API URL”.
   • Click the “Fetch API Key” button.
     This securely connects your site to the backend and saves your API key automatically.
   • Verify that the API Status and Site Connection show as “Connected”. Click “Refresh” if needed.
2. Configure Chat ID:
   • Go to Telegram Sync -> Settings -> Chat Management.
   • Find the active bot’s username on the API Connection page. Send the command /myid to that bot in Telegram.
     It will reply with your unique Chat ID (a number, possibly starting with a hyphen for groups).
   • Enter a name for your reference (e.g., “Admin Chat”) and the Chat ID you received into the fields on the Chat Management tab.
   • Click “Save Changes”.
   • You can use the “Test” button to verify the Chat ID is correct.
3. Configure Notifications:
   • Go through the tabs under Telegram Sync -> Settings (General, Order Status, User & Stock, etc.).
   • Use the toggle switches to enable the notifications you want to receive.
   • Customize the message templates using the available placeholders listed below each template field.
4. Set Up Notification Rules (Optional):
   • Navigate to the Notification Rules tab to create advanced conditions for any enabled notification event, giving you precise control over when alerts are sent.
5. Enable the Plugin:
   • Ensure the “Enable Plugin” toggle is switched on in the General tab.
   • Notifications will now be sent automatically to your configured Chat ID based on your settings and rules.

Available Placeholders:

• For Order Status Notifications: {site_title}, {customer_name}, {order_id}, {order_status}, {product_list}, {total_price}, {total_price_formatted}, {billing_address}, {shipping_address}, {ppom_data}, {payment_method}, {shipping_method}, {customer_note}, {date_created}, {date_paid}, {date_completed}, {billing_email}, {billing_phone}.
• For New User Notifications: {site_title}, {user_login}, {user_email}.
• For New Admin User Notifications: {site_title}, {user_login}, {user_email}, {user_roles}.
• For Stock Notifications: {site_title}, {product_name}, {product_sku}, {stock_status}.
• For Low/Out of Stock Alerts: {site_title}, {product_name}, {product_sku}, {stock_status}, {stock_quantity}, {alert_type}.
• For Abandoned Cart: {customer_name}, {customer_email}, {customer_phone}, {date_created}, {product_list}, {variation_data}, {ppom_data}.
• For New Product Reviews: {site_title}, {product_name}, {product_link}, {reviewer_name}, {reviewer_email}, {review_content}, {review_rating}, {review_link}.
• For Coupon Usage: {site_title}, {order_id}, {customer_name}, {total_price_formatted}, {coupon_codes}, {coupon_count}.
• For Failed Login Attempts: {site_title}, {username}, {ip_address}, {failed_attempts}, {threshold}.
• For Product Price Changes: {site_title}, {product_name}, {product_sku}, {old_price}, {new_price}, {price_change_text}, {percentage_change}, {product_link}.

External Services

This plugin relies on a mandatory third-party API service hosted at https://tgapi.refat.ovh/api.php to function.
* What the service is and what it is used for: The service acts as a secure intermediary between your WooCommerce store and the Telegram messaging service.
It receives notification requests (containing message content and recipient ID) from your website via a secure API key, processes them, and delivers them to the specified Telegram chat using a bot managed by the service provider.
This is necessary to avoid exposing your sensitive Telegram Bot Token directly on your website and allows the service to manage bot operations and message delivery.
The service also enforces message usage limits for users of this free plugin.
* What data is sent and when:
* Connection: When you click “Fetch API Key” on the API Connection page, your website’s domain (e.g., yourstore.com) and a unique, auto-generated secret key are sent to the service to register your site and issue your API Key.
* Notifications: Whenever a configured WooCommerce event occurs (e.g., new order, stock change), the plugin constructs a message based on your template and sends the final message content along with your configured Telegram Chat ID and your API Key to the service.
The message content may include order details, product names, customer information (name, email, phone – depending on your template configuration), etc., as needed to fulfill the notification’s purpose.
* Chat Commands: When you send a command (like /sales) from Telegram to the service’s bot, the service sends the command details (command name, arguments, your chat ID) along with your API Key to your website’s REST API endpoint (/wp-json/rntfw/v1/command).
Your website processes the command and sends the result back to the service, which then relays it to you in Telegram.
* Status Checks: Periodically, and when you click “Refresh” or “Test Connection”, the plugin sends your domain, secret key, and API key to the service to verify the connection status and retrieve the current bot username.
* Service’s Terms of Use and Privacy Policy: Connection to and use of this external service are subject to its terms and policies.
Please review them carefully:
* Terms of Use
* Privacy Policy