Send Telegram Alerts for New WooCommerce Orders with n8n

1. Opening Problem Statement

Meet Sarah, an online store manager who runs a busy WooCommerce shop. Every day, Sarah receives dozens of orders that need to be fulfilled quickly. But with no instant alert system, she often finds herself manually checking the WooCommerce dashboard multiple times an hour. This not only wastes hours each week but also causes delays in processing orders, frustrating customers and risking negative reviews.

Sarah needed a better way to get notified immediately when an order is ready for fulfillment — specifically, when the order status updates to “Processing,” signaling payment completion and readiness to ship. Manually refreshing or relying on email notifications didn’t cut it; she wanted real-time mobile alerts without distraction from her current tasks.

2. What This Automation Does

This n8n workflow automates notifications by sending detailed Telegram alerts whenever a WooCommerce order status changes to “Processing.” Here’s what happens when this workflow runs:

• The workflow listens for WooCommerce order updates via a secure webhook.
• It checks if the incoming order status is “Processing” to filter irrelevant updates.
• Extracts key details from the order: customer info, order ID, order date, products ordered, total amount, and any customer notes.
• Formats a rich-text message with all this information, using HTML formatting and emojis for easy reading.
• Sends the message instantly to a specified Telegram chat (such as Sarah’s phone or team channel).

By implementing this automation, Sarah saves hours each week previously spent on manual checks and can promptly act on ready-to-ship orders, improving customer satisfaction and operational efficiency.

3. Prerequisites ⚙️

• WooCommerce account with admin access to configure webhooks.
• Telegram account and bot created via @BotFather to send messages.
• n8n account to build and run the workflow.
• Telegram Bot credentials set up inside n8n.
• Basic understanding of how to generate and copy webhook URLs.

Optional: You may self-host n8n for better control and security; services like Hostinger make this easy. Visit https://buldrr.com/hostinger for more info.

4. Step-by-Step Guide

Step 1: Create Webhook in n8n to Receive WooCommerce Order Updates

Navigate to your n8n editor and start adding a Webhook node named Receive WooCommerce Order.

Set the HTTP Method to POST. This webhook URL will listen for order update notifications from WooCommerce.

Copy the generated webhook URL; you will paste this into WooCommerce next.

Expected outcome: Your n8n instance waits for POST data whenever WooCommerce sends an order update.

Common mistake: Forgetting to set the HTTP method to POST will cause WooCommerce data to not be accepted.

Step 2: Configure WooCommerce Webhook to Send Order Updates

In your WordPress dashboard, go to WooCommerce ➡ Settings ➡ Advanced ➡ Webhooks.

Click Add webhook and set:

• Status to Active
• Topic to Order updated
• Delivery URL to the webhook URL copied from n8n.

Save the webhook.

Expected outcome: WooCommerce will now send order update data to your n8n workflow whenever an order is updated.

Step 3: Add an If Node to Check Order Status

In n8n, add an If node named Check if Order Status is Processing.

Configure the node’s condition to check if {{$json.body.status}} equals processing.

This ensures the workflow only continues for orders with the “Processing” status.

Expected outcome: The workflow filters out all order updates except those with status processing.

Common mistake: Skipping this check can cause irrelevant notifications for all order changes.

Step 4: Design the Message Template Using a Code Node

Add a Code node named Design Message Template to format the message for Telegram.

Use this JavaScript code (from the workflow) that extracts the line items, formats the total amount, compiles the customer’s order details, and creates a neat, readable message with HTML tags and emojis.

// Data extraction and processing for order details
const lineItems = $json.body.line_items;

// Getting the total amount directly from WooCommerce
const totalAmount = parseInt($json.body.total).toLocaleString();

// Constructing the product message in the desired format
const filteredItems = lineItems.map(item => {
  const name = item.name;
  const quantity = item.quantity;
  return `539 ${name} (${quantity} items)`;
}).join('\n');  // Separating each product with a new line

// Getting the order creation date and time
let dateCreated = new Date($json.body.date_created_gmt || new Date());

// Directly using the server's local time (no timezone conversion)
let formattedDate = dateCreated.toLocaleString('en-US', {
  year: 'numeric',
  month: 'long',
  day: 'numeric',
  hour: '2-digit',
  minute: '2-digit',
  hour12: false
});

// Constructing other parts of the message in an organized manner
const orderInfo = `

195 Order ID: ${$json.body.id}

4663FB Customer Name: ${$json.body.billing.first_name} ${$json.body.billing.last_name}

4B5 Amount: ${totalAmount}

4C5 Order Date:
4AB ${formattedDate}

3D9 City: ${$json.body.billing.city}

4DE Phone: ${$json.body.billing.phone}

4DD Order Note:
${$json.body.customer_note || 'No notes'}

4E6 Ordered Products:

${filteredItems}
`;

// Returning the final message
return {
  orderMessage: orderInfo.trim()  // Remove extra spaces from the beginning and end of the message
};

Expected outcome: The message is crafted and ready to be sent to Telegram.

Step 5: Add the Telegram Node to Send Notifications

Add the Telegram node and connect it from the Code node.

Paste your Chat ID (use @userinfobot on Telegram to discover yours) and select configured Telegram Bot credentials.

Configure the text parameter with {{ $json.orderMessage }} to pull in the formatted message.

Set parse mode to HTML for formatting support.

Expected outcome: When triggered, you receive a detailed Telegram alert with your order info.

Step 6: Activate and Test Your Workflow

Make sure the entire workflow is active in n8n (green dot on top).

Place a test order on your WooCommerce store and update it to “Processing.” You should see the notification in your Telegram chat instantly.

Common mistake: Not activating the workflow or forgetting to update the order status to “Processing” will result in no alerts.

5. Customizations ✏️

• Add More Order Details: In the Design Message Template node, you can add fields like shipping address, payment method, or customer email by modifying the JavaScript code.
  Instructions: Edit the JS code to include new data points similar to how customer name and phone are added.
• Change Telegram Chat ID: You might want alerts sent to a different chat or Telegram group. Change the chatId field in the Telegram node accordingly.
• Filter for Different Order Status: Modify the If node to check for other statuses such as “completed” or “on-hold” instead of “processing”.
  This broadens your alert scope.

6. Troubleshooting 🔧

• Problem: “No data received by the webhook node.”
  
  Cause: WooCommerce webhook is not correctly set or URL mismatched.
  
  Solution: Verify the webhook URL pasted in WooCommerce matches your n8n webhook URL exactly, and the webhook is active.
• Problem: “Telegram message not sent or error in Telegram node.”
  
  Cause: Invalid Telegram API token or incorrect chat ID.
  
  Solution: Double-check your Telegram Bot API token credentials in n8n and ensure the chat ID is correct by using @userinfobot.
• Problem: “Workflow triggers on every order update, not just processing.”
  
  Cause: Missing or incorrect condition in the If node.
  
  Solution: Confirm the If node condition exactly matches processing (case-sensitive).

7. Pre-Production Checklist ✅

• Confirm your WooCommerce webhook is active and set to “Order updated” events.
• Test webhook reception by checking n8n execution logs when orders update.
• Verify the If node filters order status correctly for “processing.”
• Send test Telegram messages using the Telegram node’s test feature.
• Backup your n8n workflow export for rollback if needed.

8. Deployment Guide

Activate your workflow in n8n with the toggle switch. Once active, it listens continuously for WooCommerce updates and sends Telegram alerts automatically.

Monitor execution via n8n’s dashboard to confirm successful runs or catch occasional errors.

You can add additional logging nodes for persistence or debugging if desired.

9. FAQs

• Q: Can I use Slack instead of Telegram for notifications?
  
  A: Yes, by replacing the Telegram node with a Slack node and adjusting the message formatting.
• Q: Does this workflow consume many API credits?
  
  A: Telegram’s API uses minimal credits for each message; WooCommerce webhooks are free.
• Q: Is the data secure?
  
  A: Yes, data flows via secure webhook URLs and Telegram connections with bot tokens; ensure your n8n instance is secured.

10. Conclusion

You’ve now built and deployed an efficient system to get instant Telegram notifications for new WooCommerce orders marked as processing. This saves precious time Sarah would have spent manually monitoring orders and enables faster fulfillment.

By automating order alerts, you improve customer satisfaction, reduce errors, and can scale your store’s operations confidently.

Next, you might explore automating inventory updates or integrating customer feedback responses in n8n for a fully connected e-commerce backend.

Keep experimenting and happy automating!