mini woo

迷你Woo：用於WooCommerce的電報迷你應用

Mini Woo是一個項目，可讓您創建一個用於電報的迷你應用程序，該應用程序是具有超過5億活躍用戶的消息傳遞應用程序，該應用程序連接到您的WooCommerce網站，這是網絡上最受歡迎的電子商務平台。

它使用Next.JS，一個用於構建快速可擴展的Web應用程序的React框架，電報機器人API和WooCommerce REST API可以通過Telegram為客戶提供無縫的購物體驗。

您可以將此項目用作模板，以使用自己的品牌，產品和功能自定義您的迷你應用程序，或修改API，以連接支持Restful Web服務的任何其他在線商店。該項目是開源的，可以免費使用。您可以在GitHub上的此處找到源代碼，文檔和安裝說明。

要求

• 電報機器人
• WooCommerce網站
• Nodejs（推薦最新的LTS版本）

入門

1. 準備環境變量
2. 部署
3. init Telegram Bot API Webhook

環境變量

要使用此項目，您需要設置以下環境變量：

• NEXT_PUBLIC_BASE_PATH這是您部署的基本URL。例如，如果您在Vercel上部署，則可以像https://mini-woo-<your-username>.vercel.app 。

• TELEGRAM_BOT_TOKEN這是您創建電報機器人時從@botfather獲得的訪問令牌。

• TELEGRAM_BOT_SECRET這是您設置的密碼以保護API。它可以是任何字符串，例如my-pass或隨機生成的哈希。請確保將其保密。

• TELEGRAM_PAYMENT_PROVIDER_TOKEN這是電報付款提供商令牌。您可以連接Botfather的付款方式。付款提供商，支持的貨幣

• WOOCOMMERCE_URL這是您的WooCommerce網站的URL。例如， https://<your-super-cool-store>.com 。

• WOOCOMMERCE_CONSUMER_KEY WOOCOMMERCE_CONSUMER_SECRET這些是您從WooCommerce設置中獲得的身份驗證密鑰和秘密。您可以按照此說明生成它們。

部署

您需要將應用程序部署在平台或選擇的服務器上。

部署在Vercel上

部署您的next.js應用的最簡單方法是使用Next.js的創建者的Vercel平台。您需要首先提供此存儲庫。

請查看Next.js部署文檔以獲取更多詳細信息。

在服務器上部署

如果您希望將應用程序部署在自己的服務器上，則需要將example.env .env複製到項目的根源並填充變量。然後，您需要運行以下命令：

npm run build

npm run start

這將在.env中PORT變量指定的端口上構建並啟動您的應用程序。

在當地運行

設置環境變量然後運行：

npm run dev

您可以使用https://ngrok.com/

init Telegram Bot API Webhook

這是最後一步！您需要設置一個Webhook，供電報機器人從電報接收更新。為此，您只需要向以下URL提出發布請求：

curl -X POST https:// < your-deployment-url > /api/telegram-hook/init ? secret_hash= < the-secret-password-from-env-var >

用部署的基本URL替換<your-deployment-url>您的deployment-url>，並用telegram_bot_secret在環境變量或.env中的TELEGRAM_BOT_SECRET的值代替<the-secret-password-from-env-var> 。

現在您的迷你應用已經準備好了！您可以通過向電報機器人發送命令或消息來測試它。享受！ ？

特徵

• 顯示產品清單
• 按類別過濾
• 註冊訂單
• 用電報付款
• 支持變量項目
• 支持搜索項目
• 支持運輸方法
• 支持其他付款方式
• 更多的...

了解更多

要了解更多信息，請查看以下資源：

• Telegram Mini應用程序 - 開始了解電報網絡應用程序的起點。
• 電報機器人API-電報機器人API完整文檔。
• telegraf.js- node.js的現代電報機器人API框架（文檔）。
• WooCommerce API- WooCommerce REST API文檔。
• Next.js文檔 - 了解Next.js功能和API。
• 學習Next.js-互動Next.js教程。

歡迎您的反饋和貢獻！