內容簡介
**總結:**
RefatBd 通知與 Telegram 外掛為 WooCommerce 商店擁有者提供了一個強大而靈活的工具，可以通過Telegram獲取即時更新。 這個外掛集成了一個安全、私人的API，確保您商店的溝通既迅速又安全。可以自動發送基於模板的通知，涵蓋許多事件，包括訂單狀態變更、新用戶註冊、庫存更新、廢棄結賬、新產品評論等。
**問題與答案:**
1. 如何連接您的網站？
- 在 WordPress 管理員中，前往「Telegram Sync -> API Connection」。
- 提供了預設的 API URL (https://tgapi.refat.ovh/api.php)，請確保這是正確的。如果您自主託管後端，輸入您的URL並點擊「保存API URL」。
- 點擊「Fetch API Key」按鈕。這將安全連接您的站點到後端並自動保存您的 API 金鑰。
- 確認 API 狀態和站點連線顯示為「Connected」。如有需要，點擊「刷新」。
2. 如何配置聊天ID？
- 前往「Telegram Sync -> Settings -> Chat Management」。
- 在 API Connection 頁面找到活動機器人的用戶名。發送 /myid 指令給該機器人在 Telegram 上。它將回覆您的唯一聊天ID（可能是以連字符開頭的數字，適用於群組）。
- 在 Chat Management 頁面中輸入一個名稱供參考（例如：「Admin Chat」），並將您收到的聊天ID輸入字段中。
- 點擊「Save Changes」。
- 您可以使用「Test」按鈕來驗證聊天ID是否正確。
3. 如何配置通知？
- 進入 Telegram Sync -> Settings 下的各個分頁（General、Order Status、User & Stock 等）。
- 使用切換按鈕啟用您想要接收的通知。
- 使用下面模板字段中列出的可用占位符來自定義消息模板。
4. 如何設定通知規則（可選）？
- 轉到 Notification Rules 標籤頁以創建進階條件。
外掛標籤
開發者團隊
② 後台搜尋「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
How to Use
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.
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.
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.
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.
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
