Quick installation guide: launch your Telegram store in 5 steps!

Step 1: Create your bot and obtain the Telegram API đŸ€–

In order for your store to communicate on Telegram, we first need to create a “Bot.” This is a very simple process managed by Telegram itself via an official bot called “BotFather”.

  1. Open Telegram (on your computer or phone) and search for the contact @BotFather (the one with the blue check mark) or click on this link: https://t.me/BotFather.
  2. Start the conversation by sending the command: /newbot
  3. BotFather will ask you for two things:
    • A name for your bot (e.g., My Awesome Store). This is the name that will appear in conversations.
    • A username. It must be unique and end with bot (e.g., MyAwesomeStoreBot).
  4. Once completed, BotFather will send you a confirmation message containing your access token (API Token). This is a long string of characters. Copy this token and keep it safe, we will need it in step 4.

Step 2: Create your WooCommerce API keys 🔑

Next, we need to authorize your new bot to communicate securely with your WooCommerce store to read products and manage orders.
  1. In your WordPress dashboard, go to: WooCommerce → Settings → Advanced tab.
  2. Click on the “REST API” section.
  3. Click on the “Add Key” button.
  4. Fill out the form:
    • Description: Give it a name that is easy to remember (e.g., Telegram Store Bot).
    • Permissions: This is the most important step! Select “Read/Write”.
  5. Click on “Generate API Key”.
WooCommerce will now display a “Consumer Key” and a “Consumer Secret”. Copy them immediately to a safe place. Please note that the consumer secret will never be displayed again after you leave this page.

Step 3: Install the extension 🔌

This is the most common step.

  1. In your WordPress dashboard, go to Plugins → Add New.
  2. Click on the “Upload Plugin” button at the top of the page.
  3. Select the .zip file for the plugin you downloaded after your purchase.
  4. Click “Install Now,” then “Activate Plugin.”

Step 4: Connect the extension and activate the bot ⚙

Now let’s connect everything together! A new menu has appeared in your dashboard.

  1. Go to the Woo Telegram → General menu.
  2. Open the “API Keys” tab. Paste the keys we obtained:
    • Telegram bot token: The token from step 1 (BotFather).
    • WooCommerce Consumer Key: The key from step 2.
    • WooCommerce Consumer Secret: The secret from step 2.
  3. Open the “Settings” tab.
    • Check the “Enable bot” box.
    • (Optional) Enter your support chat ID (obtained via @userinfobot) to enable integrated customer support.
  4. Click the “Save Changes” button.

Your bot is now connected to your store! All that’s left to do is tell it how to accept payments.

Step 5: Set up your payment methods đŸ’”

This is the final step to enable your bot to take orders. By default, all payments are disabled.

Go to Telegram Shop → General and open the “Payment” tab. Choose your strategy:

  • Option 1: Payment on the Website
    • Check the box “Show ‘Pay on Website’ button”.
    • That’s it! The bot will create the order and redirect the customer to the secure payment page of your WooCommerce website, using your existing gateways (Stripe, PayPal, etc.).
  • Option 2: Pay with Telegram
    • If you have a Telegram “Payment Token” (via @BotFather), paste it into the “API Keys” tab.
    • Then check the box “Display the ‘Pay with Telegram’ button”. The customer will be able to pay directly in the chat.
  • Option 3: Payment link, bank transfer, etc.
    • Enable “Enable custom payment method” and fill in the instructions (e.g., for a bank transfer) that the customer will receive.

Click “Save changes”.

Step 6: Enjoy your new sales channel! 🚀

That’s it, you’re done!

Your store is now live on Telegram. To test it out, open Telegram, search for your bot using the username you created in step 1, and send it the command /start.

Your store menu should appear, ready to take its first order. Happy selling! ✹