How to send WooCommerce order notifications to Telegram

Telegram is a quick way to hear about a new order the moment it comes in, and a place where customers actually read their order updates. This guide shows how to connect a WooCommerce shop to Telegram with your own bot and the free Orderchirp plugin: new-order and stock alerts for you, and status updates for customers who ask for them.

How it works

Telegram lets anyone create a bot, an account run by software, through Telegram's own @BotFather. Your shop uses the bot's token to send messages through the Telegram Bot API. The messages come from your bot, under your shop's name.

Telegram's own documentation says bots can't start conversations with users: a person has to send the bot a message first, which in practice means pressing Start. That is why customers opt in with one tap, and why nobody gets a message they did not ask for.

Step 1: create your bot

  1. In Telegram, open @BotFather and send /newbot.
  2. Give the bot a display name, such as your shop's name, and a username that ends in "bot". The username cannot be changed later, so choose it with care.
  3. BotFather replies with a token. Keep it private: anyone who has it can control the bot. If it is ever exposed, send /token to BotFather to generate a new one.

Step 2: connect it to WooCommerce

  1. In WordPress, go to Plugins → Add New Plugin, search for "Orderchirp", install it and activate it. WooCommerce must already be active.
  2. Go to WooCommerce → Orderchirp, paste the token and press Connect.
  3. Press "Add a chat" and open the link on your phone. From then on your own Telegram gets an alert for every new order, with the items and the total, and low-stock and out-of-stock alerts.

On a site with HTTPS, Telegram tells the shop about new messages at once through a webhook. Telegram only calls HTTPS addresses, so on a site without HTTPS Orderchirp checks for new messages once a minute instead.

Step 3: choose the customer messages

On the Messages tab, switch on the order statuses that send a message, such as received, completed, cancelled and refunded, and write the text for each.

If a tracking plugin stores tracking in WooCommerce's standard shipment tracking field, as WooCommerce Shipment Tracking and Advanced Shipment Tracking do, you can add the tracking number, carrier and link to the completed message. A line whose tracking details are empty is left out.

What the customer sees

  1. A "Get updates on Telegram" button on the order received page, in the order e-mail and in My Account.
  2. One tap opens your bot; they press Start.
  3. They get a message each time their order changes to a status you switched on.
  4. If they reply, the reply is added to the order as a note and forwarded to you.
  5. They can send /stop at any time and the messages stop.

Privacy

Messages go through Telegram, so tell customers in your privacy policy. Once a customer has turned updates on, their Telegram chat ID and the text of each order message, which can include their first name, order number, items, total and tracking number, are sent to Telegram. Nothing is sent before you connect a bot. Orderchirp keeps a log of every message sent and received on its Activity page, and supports personal data export and erasure through the WordPress privacy tools.

If something does not arrive

Sources

  1. Telegram Bot Features: BotFather — Telegram
  2. Telegram Bot API — Telegram
  3. Bots: an introduction for developers — Telegram

Telegram is a trademark of its owner. Orderchirp is made by BEK Service and is not affiliated with or endorsed by Telegram.

Back to Orderchirp