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.

🚀 NEW: Customer Notifications System! Expand your store’s capability by allowing your customers to receive real-time updates about their orders. * Seamless Connection: Customers can connect their Telegram account via a secure « Connect » button on the « Thank You » page or « My Account » dashboard. * Guest Support: Unique logic identifies guest users by their Email or Phone number, ensuring they receive updates for future orders even without a WordPress account. * Secure Handshake: Uses a deep-link token system to securely link Telegram users to your store without manual ID entry.

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.
• Admin 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.
• Customer Notifications: Send automated order status updates directly to your customers’ Telegram accounts. Supports both registered users and guests.
• Connection Management: View connected users and guests in the admin panel. Easily disconnect or block abusive users.
• Advanced Conditional Logic: 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.
• Single Chat ID Support (Admin): Send admin 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.
   • Click the « Fetch API Key » button. This securely connects your site to the backend and saves your API key.
   • Verify that the API Status and Site Connection show as « Connected ».
2. Configure Admin 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.
   • Enter the numeric Chat ID you received into the fields on the Chat Management tab and click « Save Changes ».
3. Configure Notifications:
   • Go through the tabs under Telegram Sync -> Settings (General, Order Status, Customer Notifications, etc.).
   • Admin: Use the toggle switches to enable the notifications you want to receive yourself.
   • Customer: Go to the « Customer Notifications » tab and enable « Enable Customer Notifications ». Customize the templates customers will receive.
4. Set Up Notification Rules (Optional):
   • Navigate to the Notification Rules tab to create advanced conditions for any enabled notification event.
5. Enable the Plugin:
   • Ensure the « Enable Plugin » toggle is switched on in the General tab.

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 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. * What data is sent: * Connection: Your domain and a site secret are sent to register the site. * Notifications: Message content (which may include order/customer details based on your templates) and the recipient’s Chat ID. * Customer Linking: When a customer connects, a temporary token is generated and validated against the API to securely exchange their Chat ID. * Service’s Terms of Use and Privacy Policy: * Terms of Use * Privacy Policy