WooCommerce Telegram Order Notifier

Sends instant WooCommerce order notifications to a Telegram chat or channel via Telegram Bot API.

Description

WooCommerce Telegram Order Notifier sends detailed order notifications to your Telegram chat or channel every time an order status changes in WooCommerce.

Features

• Instant Telegram notifications when an order status changes
• Fully customizable message template with placeholders
• Choose which order statuses trigger a notification
• Test button to verify your bot token and chat ID are correct
• Lightweight — uses WordPress native wp_remote_post(), no extra libraries
• Non-blocking: if Telegram is unreachable, the order is still placed successfully
• Compatible with WooCommerce HPOS (High-Performance Order Storage)

Available Placeholders

Use these placeholders in your message template:

• {order_id} — Order number
• {order_date} — Order date and time
• {order_url} — Link to the order in the WordPress admin
• {status} — Human-readable order status
• {total} — Order total amount
• {customer_name} — Customer first and last name
• {customer_phone} — Customer phone number
• {customer_email} — Customer email address
• {payment_method} — Payment method title
• {shipping_method} — Shipping method name
• {shipping_address} — Formatted shipping address
• {items} — List of ordered products (name × qty = price)

Installation

1. Upload the wc-telegram-notifier folder to the /wp-content/plugins/ directory, or install the plugin directly through the WordPress admin panel.
2. Activate the plugin through the Plugins menu in WordPress.
3. Go to WooCommerce → Telegram Notifications to configure the plugin.

Quick Setup

1. Create a Telegram bot via @BotFather (send /newbot and follow the instructions).
2. Copy the Bot Token provided by BotFather and paste it into the plugin settings.
3. Get your Chat ID: add the bot to your chat or send it /start, then open https://api.telegram.org/bot<TOKEN>/getUpdates in your browser and find the "id" field inside "chat".
4. Select the order statuses that should trigger a notification.
5. Customize the message template if needed.
6. Click Send Test Message to verify everything works.

Frequently Asked Questions

Does the plugin slow down the checkout process?

No. The notification is sent via a non-blocking HTTP request with a 5-second timeout. If Telegram's API is temporarily unavailable, the order is still created normally and the error is written to the server log.

Can I send notifications to a Telegram channel?

Yes. Add your bot as an administrator of the channel, then enter the channel username in the format @channel_name or use the numeric channel ID (starting with -100).

Which order statuses can trigger notifications?

All WooCommerce order statuses are available: pending, processing, on-hold, completed, cancelled, refunded, failed, and any custom statuses added by other plugins.

How do I find my Chat ID?

For a private chat or group: add your bot, send any message, then open: https://api.telegram.org/bot<YOUR_TOKEN>/getUpdates Look for "chat" → "id" in the JSON response.

For a public channel, simply use @channel_username.

Is the Bot Token stored securely?

The token is stored in the WordPress options table (same as other plugin settings). The field uses type="password" in the admin UI and the value is sanitized before saving. We recommend keeping your WordPress installation up to date and using a dedicated bot for notifications only.

Does it support WooCommerce HPOS?

Yes. The plugin declares full compatibility with WooCommerce High-Performance Order Storage (custom order tables).

Screenshots

1. Plugin settings page — Bot Token, Chat ID, trigger statuses and message template.
2. Example of a Telegram notification message.

Changelog

1.0.0

• Initial release.

Upgrade Notice

1.0.0

Initial release of WooCommerce Telegram Order Notifier.