๐ Overview
Transform your Telegram channel or group into a fully functional, automated e-commerce storefront. This n8n workflow template allows you to sell both physical and digital products directly within Telegram, utilizing Paystack for secure checkout and Google Sheets as a lightweight, free database for inventory and order management.
Say goodbye to complex website builders and monthly subscription fees. With this serverless setup, you can launch a store in minutes and manage everything from a simple spreadsheet.
โจ Key Features
- ๐ Interactive Shopping Cart: Users can browse products, select quantities, and manage their cart entirely through seamless Telegram inline buttons.
- ๐ณ Secure Payments: Direct integration with the Paystack API generates unique, secure checkout links for every order.
- ๐ฆ Smart Fulfillment: Automatically detects if an order is digital or physical. Digital goods (e.g., PDFs, E-books via Google Drive) are delivered instantly upon payment confirmation. Physical orders are marked as "Paid" and queued for shipping.
- ๐ Free Database (Google Sheets): No SQL required! Manage your product catalog, track active user sessions, and view order history entirely within Google Sheets.
- ๐ Order Tracking System: Customers can use the
/orders command or search by their unique ORD- ID to view their purchase history, resume pending payments, or track shipped items.
- โ๏ธ Built-in Validation: Includes robust data validation for email addresses (catching common typos like
.con) and physical delivery addresses.
๐ Prerequisites
To run this template, you will need the following accounts:
- Telegram: A free Telegram Bot Token (obtained via BotFather).
- Paystack: A Paystack account to receive payments (you will need your Secret Key).
- Google Workspace: A Google account to host the Google Sheets database and Google Drive (if selling digital files).
๐ Setup Instructions
1. Database Setup
- Create a new Google Sheet (Template; https://docs.google.com/spreadsheets/d/1x58FYmsdo2K2dKNm81LgCSrGvHwhenkJTtjDIxc8-2w/edit?gid=187299608#gid=187299608 with three tabs:
Products, Orders, and Session.
- Products Tab Headers:
id, name, price, type (physical/digital), stock, description, file_url (optional, for digital goods).
- Orders Tab Headers:
order_id, reference, user_id, email, address, items_json, total, status, payment_link, tracking, created_at.
- Session Tab Headers:
user_id, chat_id, state, cart_json, selected_product_id, selected_product_name, selected_product_price, selected_product_type, input_quantity, input_email, input_address.
2. n8n Node Configuration
- Import this template into your n8n workspace.
- Update the Google Sheets credentials and replace the
Document ID in all sheet nodes with your specific spreadsheet ID.
- Add your Telegram Bot Token via n8n's credential manager to activate the Telegram Trigger and messaging nodes.
- Locate the nodes containing the
YOUR_PAYSTACK_SECRET_KEY placeholder (e.g., Paystack Init Transaction) and insert your actual Paystack Secret Key.
3. Webhook Activation
- Double-click the Paystack Webhook node.
- Copy the "Production URL" provided by n8n.
- Log into your Paystack Dashboard, navigate to Settings > Webhooks, and paste the URL. This ensures your bot receives real-time payment confirmations.
๐ก Use Cases
- Digital Creators: Sell e-books, courses, templates, or software directly to your Telegram audience with instant file delivery.
- Local Businesses: Automate orders for physical goods, food delivery, or merchandise without needing a dedicated website.
- Dropshipping: Seamlessly collect orders and addresses before forwarding them to suppliers.
๐ Apps Integrated
- Telegram
- Paystack
- Google Sheets
- Google Drive (Optional)
You can also test the workflow live on Telegram: @sellvia_paystack_bot or https://t.me/sellvia_paystack_bot)
๐ Need help or want to customize this workflow?
๐บ Contact: Fiverr
๐ฉ Consultation: Book Appointment