mini woo
1.0.0
Mini Woo est un projet qui vous permet de créer une mini application pour Telegram, l'application de messagerie avec plus de 500 millions d'utilisateurs actifs, qui se connecte à votre site Web WooCommerce, la plate-forme de commerce électronique la plus populaire sur le Web.
Il utilise Next.js, un cadre React pour créer des applications Web rapides et évolutives, et l'API de Bot Telegram et l'API WooCommerce REST pour offrir une expérience d'achat transparente à vos clients sur Telegram.
Vous pouvez utiliser ce projet comme modèle pour personnaliser votre mini application avec votre propre marque, produits et fonctionnalités, ou modifier l'API pour connecter toute autre boutique en ligne qui prend en charge les services Web RESTful. Ce projet est open source et gratuit. Vous pouvez trouver le code source, la documentation et les instructions d'installation ici sur GitHub.
Pour utiliser ce projet, vous devez définir les variables d'environnement suivantes:
NEXT_PUBLIC_BASE_PATH Ceci est l'URL de base de votre déploiement. Par exemple, si vous déployez sur Vercel, cela peut être quelque chose comme https://mini-woo-<your-username>.vercel.app .
TELEGRAM_BOT_TOKEN C'est le jeton d'accès que vous obtenez de @botfather lorsque vous créez votre bot télégramme.
TELEGRAM_BOT_SECRET Il s'agit d'un mot de passe que vous définissez pour sécuriser vos API. Il peut s'agir de n'importe quelle chaîne, comme my-pass ou un hachage généré de manière aléatoire. Veuillez vous assurer de le garder secret.
TELEGRAM_PAYMENT_PROVIDER_TOKEN Il s'agit d'un jeton de fournisseur de paiement télégramme. Vous pouvez connecter les méthodes de paiement de Botfather. Fournisseurs de paiement, devises soutenues
WOOCOMMERCE_URL Ceci est l'URL de votre site Web WooCommerce. Par exemple, https://<your-super-cool-store>.com .
WOOCOMMERCE_CONSUMER_KEY WOOCOMMERCE_CONSUMER_SECRET Il s'agit de la clé d'authentification et du secret que vous obtenez à partir des paramètres WooCommerce. Vous pouvez suivre cette instruction pour les générer.
Vous devez déployer votre application sur une plate-forme ou un serveur de votre choix.
La façon la plus simple de déployer votre application Next.js est d'utiliser la plate-forme Vercel à partir des créateurs de next.js. Vous devez d'abord débarrasser de ce référentiel.
Consultez la documentation de déploiement Next.js pour plus de détails.
Si vous préférez déployer votre application sur votre propre serveur, vous devez copier example.env à .env dans la racine du projet et remplir les variables. Ensuite, vous devez exécuter les commandes suivantes:
npm run build
npm run start Cela créera et démarrera votre application sur le port spécifié par la variable PORT dans .env .
Définir les variables d'environnement puis exécuter:
npm run devVous pouvez utiliser https://ngrok.com/
C'est la dernière étape! Vous devez configurer un webhook pour votre bot télégramme pour recevoir des mises à jour de Telegram. Pour ce faire, il vous suffit de faire une demande de poste à l'URL suivante:
curl -X POST https:// < your-deployment-url > /api/telegram-hook/init ? secret_hash= < the-secret-password-from-env-var > Remplacez <your-deployment-url> par l'URL de base de votre déploiement et <the-secret-password-from-env-var> par la valeur de TELEGRAM_BOT_SECRET dans vos variables d'environnement ou .env .
Maintenant, votre mini application est prête! Vous pouvez le tester en envoyant des commandes ou des messages à votre bot télégramme. Apprécier! ?
Pour en savoir plus, jetez un œil aux ressources suivantes:
Vos commentaires et contributions sont les bienvenus!
