{"id":342118,"date":"2026-07-25T18:27:47","date_gmt":"2026-07-25T18:27:47","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/telegram-notifications-for-woocommerce\/"},"modified":"2026-07-25T18:27:25","modified_gmt":"2026-07-25T18:27:25","slug":"asphaltdreams-telegram-order-alerts","status":"publish","type":"plugin","link":"https:\/\/vec.wordpress.org\/plugins\/asphaltdreams-telegram-order-alerts\/","author":23303047,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.0.0","stable_tag":"1.0.0","tested":"7.0.4","requires":"6.5","requires_php":"7.4","requires_plugins":null,"header_name":"AsphaltDreams Order Alerts with Telegram for WooCommerce","header_author":"AsphaltDreams","header_description":"Send WooCommerce new-order alerts through the Telegram Bot API with a guided setup wizard.","assets_banners_color":"5f94b6","last_updated":"2026-07-25 18:27:25","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/asphaltdreams.dev\/telegram-alerts\/","header_author_uri":"https:\/\/asphaltdreams.dev\/","rating":0,"author_block_rating":0,"active_installs":0,"downloads":79,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"sahsahakyan","date":"2026-07-25 18:27:25"}},"upgrade_notice":{"1.0.0":"<p>Initial stable release.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3622764,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3622764,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3622776,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3622776,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0"],"block_files":[],"assets_screenshots":[],"screenshots":{"1":"Connect and validate a Telegram bot.","2":"Detect and choose a Telegram chat.","3":"Configure free new-order notification settings.","4":"Review the connected dashboard and send a test message."}},"plugin_section":[],"plugin_tags":[282,212469,38803,9171,286],"plugin_category":[45],"plugin_contributors":[273300],"plugin_business_model":[],"class_list":["post-342118","plugin","type-plugin","status-publish","hentry","plugin_tags-ecommerce","plugin_tags-order-alerts","plugin_tags-order-notifications","plugin_tags-telegram","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-sahsahakyan","plugin_committers-sahsahakyan"],"banners":{"banner":"https:\/\/ps.w.org\/asphaltdreams-telegram-order-alerts\/assets\/banner-772x250.png?rev=3622776","banner_2x":"https:\/\/ps.w.org\/asphaltdreams-telegram-order-alerts\/assets\/banner-1544x500.png?rev=3622776","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/asphaltdreams-telegram-order-alerts\/assets\/icon-128x128.png?rev=3622764","icon_2x":"https:\/\/ps.w.org\/asphaltdreams-telegram-order-alerts\/assets\/icon-256x256.png?rev=3622764","generated":false},"screenshots":[],"raw_content":"<!--section=description-->\n<p>AsphaltDreams Order Alerts sends useful WooCommerce new-order alerts through the Telegram Bot API.<\/p>\n\n<p>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.<\/p>\n\n<p>No separate notification platform is required. Your website communicates directly with the Telegram Bot API.<\/p>\n\n<h4>Free features<\/h4>\n\n<ul>\n<li>Guided three-step setup wizard.<\/li>\n<li>Telegram bot-token validation.<\/li>\n<li>Automatic recent-chat discovery.<\/li>\n<li>Manual Chat ID fallback.<\/li>\n<li>Test message during setup and from the dashboard.<\/li>\n<li>New-order notifications.<\/li>\n<li>Product names and quantities.<\/li>\n<li>Customer name.<\/li>\n<li>Order total and current status.<\/li>\n<li>WordPress admin order link.<\/li>\n<li>Pause and resume notifications without disconnecting the bot.<\/li>\n<li>Classic WooCommerce checkout support.<\/li>\n<li>Cart and Checkout Blocks \/ Store API support.<\/li>\n<li>WooCommerce HPOS compatibility.<\/li>\n<li>Duplicate new-order notification protection.<\/li>\n<li>WooCommerce error logging.<\/li>\n<\/ul>\n\n<p>Product information and documentation are available at https:\/\/asphaltdreams.dev\/telegram-alerts\/<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to the Telegram Bot API, an external service operated by Telegram.<\/p>\n\n<p>The connection is used to:<\/p>\n\n<ul>\n<li>Validate a Telegram bot token through the <code>getMe<\/code> method.<\/li>\n<li>Retrieve recent Telegram chats through the <code>getUpdates<\/code> method.<\/li>\n<li>Send test and WooCommerce order messages through the <code>sendMessage<\/code> method.<\/li>\n<\/ul>\n\n<p>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.<\/p>\n\n<p>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.<\/p>\n\n<p>Telegram Terms of Service: https:\/\/telegram.org\/tos\nTelegram Privacy Policy: https:\/\/telegram.org\/privacy\nTelegram Bot API documentation: https:\/\/core.telegram.org\/bots\/api<\/p>\n\n<h3>Setup<\/h3>\n\n<h4>1. Connect the bot<\/h4>\n\n<p>Open the official @BotFather account in Telegram, send <code>\/newbot<\/code>, 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.<\/p>\n\n<h4>2. Choose a chat<\/h4>\n\n<p>For a private chat, open your bot and press Start or send <code>\/start<\/code>.<\/p>\n\n<p>For a group, add the bot and send a new message in the group.<\/p>\n\n<p>For a channel, add the bot as an administrator with permission to post messages and publish a new message.<\/p>\n\n<p>Return to WordPress and refresh the chat list. You can also enter a numeric Chat ID or a public channel username manually.<\/p>\n\n<h4>3. Configure notifications<\/h4>\n\n<p>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.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install and activate WooCommerce.<\/li>\n<li>Upload this plugin from Plugins &gt; Add New Plugin &gt; Upload Plugin, or install it from the WordPress plugin directory.<\/li>\n<li>Activate AsphaltDreams Order Alerts with Telegram for WooCommerce.<\/li>\n<li>Open WooCommerce &gt; Telegram Notifications.<\/li>\n<li>Follow the three setup steps.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20this%20plugin%20require%20a%20separate%20notification%20service%3F\"><h3>Does this plugin require a separate notification service?<\/h3><\/dt>\n<dd><p>No. The WordPress website communicates directly with the Telegram Bot API.<\/p><\/dd>\n<dt id=\"does%20it%20support%20hpos%3F\"><h3>Does it support HPOS?<\/h3><\/dt>\n<dd><p>Yes. Order data is read and written using WooCommerce order CRUD methods, and the plugin declares HPOS compatibility.<\/p><\/dd>\n<dt id=\"does%20it%20support%20checkout%20blocks%3F\"><h3>Does it support Checkout Blocks?<\/h3><\/dt>\n<dd><p>Yes. It supports classic checkout and the Store API action used by WooCommerce Checkout Blocks.<\/p><\/dd>\n<dt id=\"why%20are%20no%20chats%20detected%3F\"><h3>Why are no chats detected?<\/h3><\/dt>\n<dd><p>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 <code>getUpdates<\/code>. Use another bot or enter the Chat ID manually.<\/p><\/dd>\n<dt id=\"can%20i%20send%20messages%20to%20a%20channel%3F\"><h3>Can I send messages to a channel?<\/h3><\/dt>\n<dd><p>Yes. Add the bot as a channel administrator with permission to post messages. You can select a detected channel or enter its public <code>@username<\/code> manually.<\/p><\/dd>\n<dt id=\"where%20can%20i%20find%20errors%3F\"><h3>Where can I find errors?<\/h3><\/dt>\n<dd><p>Open WooCommerce &gt; Status &gt; Logs and select a log whose source is <code>asphaltdreams-telegram-order-alerts<\/code>.<\/p><\/dd>\n<dt id=\"what%20happens%20when%20the%20plugin%20is%20deleted%3F\"><h3>What happens when the plugin is deleted?<\/h3><\/dt>\n<dd><p>The plugin removes its saved settings and activation transient during uninstall. Existing order metadata used to prevent duplicate notifications is preserved.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>First stable free release for WordPress.org.<\/li>\n<li>Added guided bot and chat setup.<\/li>\n<li>Added configurable new-order Telegram notifications.<\/li>\n<li>Added product, customer-name, total, status, and admin-link message details.<\/li>\n<li>Added HPOS and Checkout Blocks compatibility.<\/li>\n<li>Added duplicate-notification protection and WooCommerce logging.<\/li>\n<li>Added privacy-policy guidance and uninstall cleanup.<\/li>\n<\/ul>","raw_excerpt":"Send WooCommerce new-order alerts through the Telegram Bot API with an easy guided setup wizard.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/342118","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=342118"}],"author":[{"embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/sahsahakyan"}],"wp:attachment":[{"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=342118"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=342118"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=342118"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=342118"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=342118"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/vec.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=342118"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}