AsphaltDreams Order Alerts with Telegram for WooCommerce

Description

AsphaltDreams Order Alerts sends useful WooCommerce new-order alerts through the Telegram Bot API.

The plugin includes a guided three-step setup wizard. It validates your Telegram bot token, discovers recent Telegram chats, sends a test message, and lets you choose which basic order details appear in notifications.

No separate notification platform is required. Your website communicates directly with the Telegram Bot API.

Free features

  • Guided three-step setup wizard.
  • Telegram bot-token validation.
  • Automatic recent-chat discovery.
  • Manual Chat ID fallback.
  • Test message during setup and from the dashboard.
  • New-order notifications.
  • Product names and quantities.
  • Customer name.
  • Order total and current status.
  • WordPress admin order link.
  • Pause and resume notifications without disconnecting the bot.
  • Classic WooCommerce checkout support.
  • Cart and Checkout Blocks / Store API support.
  • WooCommerce HPOS compatibility.
  • Duplicate new-order notification protection.
  • WooCommerce error logging.

Product information and documentation are available at https://asphaltdreams.dev/telegram-alerts/

External services

This plugin connects to the Telegram Bot API, an external service operated by Telegram.

The connection is used to:

  • Validate a Telegram bot token through the getMe method.
  • Retrieve recent Telegram chats through the getUpdates method.
  • Send test and WooCommerce order messages through the sendMessage method.

When a notification is sent, the plugin transmits the configured message and destination Chat ID to Telegram. In the free version, a message can contain the order number, order status, order total, product names and quantities, customer name, and a WordPress admin order URL, depending on the options selected by the site administrator.

The Telegram Bot Token and Chat ID are stored in the site’s WordPress database. Store owners should use a private Telegram chat or restricted group when order information is sensitive.

Telegram Terms of Service: https://telegram.org/tos
Telegram Privacy Policy: https://telegram.org/privacy
Telegram Bot API documentation: https://core.telegram.org/bots/api

Setup

1. Connect the bot

Open the official @BotFather account in Telegram, send /newbot, follow the instructions, and copy the HTTP API token. Paste the token into the plugin setup screen. The plugin validates the token before saving it.

2. Choose a chat

For a private chat, open your bot and press Start or send /start.

For a group, add the bot and send a new message in the group.

For a channel, add the bot as an administrator with permission to post messages and publish a new message.

Return to WordPress and refresh the chat list. You can also enter a numeric Chat ID or a public channel username manually.

3. Configure notifications

Enable new-order notifications and choose whether to include products, the customer name, and the WordPress admin order link. Finish setup and send another test message from the dashboard if needed.

Installation

  1. Install and activate WooCommerce.
  2. Upload this plugin from Plugins > Add New Plugin > Upload Plugin, or install it from the WordPress plugin directory.
  3. Activate AsphaltDreams Order Alerts with Telegram for WooCommerce.
  4. Open WooCommerce > Telegram Notifications.
  5. Follow the three setup steps.

FAQ

Does this plugin require a separate notification service?

No. The WordPress website communicates directly with the Telegram Bot API.

Does it support HPOS?

Yes. Order data is read and written using WooCommerce order CRUD methods, and the plugin declares HPOS compatibility.

Does it support Checkout Blocks?

Yes. It supports classic checkout and the Store API action used by WooCommerce Checkout Blocks.

Why are no chats detected?

Send a new message to the bot or to the group where the bot is a member, then refresh the chat list. If another service configured a webhook for the same bot, Telegram may not return updates through getUpdates. Use another bot or enter the Chat ID manually.

Can I send messages to a channel?

Yes. Add the bot as a channel administrator with permission to post messages. You can select a detected channel or enter its public @username manually.

Where can I find errors?

Open WooCommerce > Status > Logs and select a log whose source is asphaltdreams-telegram-order-alerts.

What happens when the plugin is deleted?

The plugin removes its saved settings and activation transient during uninstall. Existing order metadata used to prevent duplicate notifications is preserved.

Reviews

There are no reviews for this plugin.

Contributors & Developers

“AsphaltDreams Order Alerts with Telegram for WooCommerce” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

1.0.0

  • First stable free release for WordPress.org.
  • Added guided bot and chat setup.
  • Added configurable new-order Telegram notifications.
  • Added product, customer-name, total, status, and admin-link message details.
  • Added HPOS and Checkout Blocks compatibility.
  • Added duplicate-notification protection and WooCommerce logging.
  • Added privacy-policy guidance and uninstall cleanup.