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教程。

欢迎您的反馈和贡献！