mini woo
1.0.0
Mini Wooは、5億人以上のアクティブユーザーを抱えるメッセージングアプリであるTelegram用のMiniアプリを作成できるプロジェクトです。これは、Woocommerce WebサイトであるWebで最も人気のあるeコマースプラットフォームに接続しています。
Fast and Scalable Webアプリケーションを構築するためのReactフレームワーク、Telegram Bot APIとWooCommerce Rest APIを使用して、Telegramでシームレスなショッピングエクスペリエンスを提供するnext.jsを使用します。
このプロジェクトをテンプレートとして使用して、独自のブランディング、製品、機能でミニアプリをカスタマイズしたり、APIを変更して、Restful Webサービスをサポートする他のオンラインストアを接続したりできます。このプロジェクトはオープンソースであり、無料で使用できます。ソースコード、ドキュメント、およびインストール手順はGitHubでここにあります。
このプロジェクトを使用するには、次の環境変数を設定する必要があります。
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の設定から取得する認証キーと秘密です。この指示に従ってそれらを生成することができます。
アプリは、選択したプラットフォームまたはサーバーにアプリを展開する必要があります。
next.jsアプリを展開する最も簡単な方法は、next.jsの作成者からvercelプラットフォームを使用することです。最初にこのリポジトリをフォークする必要があります。
詳細については、next.js deploymentドキュメントをご覧ください。
自分のサーバーにアプリを展開する場合は、 example.envプロジェクトのルートで.envにコピーして変数を入力する必要があります。次に、次のコマンドを実行する必要があります。
npm run build
npm run startこれにより、 PORT変数が.envで指定されたポートでアプリを構築および起動します。
環境変数を設定し、実行します。
npm run devhttps://ngrok.com/を使用できます
これが最後のステップです！ Telegram BotのWebhookをセットアップして、Telegramから更新を受信する必要があります。これを行うには、次のURLに投稿リクエストを行う必要があります。
curl -X POST https:// < your-deployment-url > /api/telegram-hook/init ? secret_hash= < the-secret-password-from-env-var > <your-deployment-url> .env展開のベースURLと、 <the-secret-password-from-env-var> TELEGRAM_BOT_SECRET置き換えます。
これで、ミニアプリの準備が整いました！ Telegramボットにコマンドまたはメッセージを送信してテストできます。楽しむ！ ？
詳細については、次のリソースをご覧ください。
あなたのフィードバックと貢献は大歓迎です！
