Mini Woo-это проект, который позволяет создавать мини-приложение для Telegram, приложения для обмена сообщениями с более чем 500 миллионами активных пользователей, которое подключается к вашему веб-сайту WooCommerce, самой популярной платформе электронной коммерции в Интернете.

Он использует Next.js, рамки React для построения быстрых и масштабируемых веб -приложений, а также API Telegram Bot и API Woocommerce REST для предоставления бесплатных покупок для ваших клиентов на Telegram.
Вы можете использовать этот проект в качестве шаблона для настройки вашего Mini App с помощью вашего собственного брендинга, продуктов и функций, или изменить API для подключения любого другого интернет -магазина, который поддерживает Restful Web Services. Этот проект с открытым исходным кодом и бесплатно в использовании. Вы можете найти исходный код, документацию и инструкции по установке здесь, на GitHub.
Чтобы использовать этот проект, вам необходимо установить следующие переменные среды:
NEXT_PUBLIC_BASE_PATH Это базовый URL вашего развертывания. Например, если вы развертываете на Vercel, это может быть что-то вроде https://mini-woo-<your-username>.vercel.app .
TELEGRAM_BOT_TOKEN Это токен доступа, который вы получаете от @botfather, когда создаете свой бот Telegram.
TELEGRAM_BOT_SECRET Это пароль, который вы установили для обеспечения ваших API. Это может быть любая строка, такая как my-pass или случайно сгенерированный хэш. Пожалуйста, не забудьте держать это в секрете.
TELEGRAM_PAYMENT_PROVIDER_TOKEN Это токен поставщика платежей Telegram. Вы можете подключить методы оплаты от Botfather. Поставщики платежей, поддерживаемые валюты
WOOCOMMERCE_URL Это URL вашего веб -сайта Woocommerce. Например, https://<your-super-cool-store>.com .
WOOCOMMERCE_CONSUMER_KEY WOOCOMMERCE_CONSUMER_SECRET Это ключ аутентификации и секрет, которые вы получаете из настройки Woocommerce. Вы можете следовать этой инструкции, чтобы их генерировать.
Вам нужно развернуть свое приложение на платформе или на вашем выборе.
Самый простой способ развернуть ваше приложение. Вам нужно сначала расколоть этот репозиторий.
Проверьте документацию по развертыванию Next.js для получения более подробной информации.
Если вы предпочитаете развернуть свое приложение на своем собственном сервере, вам необходимо скопировать example.env в .env в корне проекта и заполнить переменные. Затем вам нужно запустить следующие команды:
npm run build
npm run start Это создаст и запустит ваше приложение на порту, указанную переменной PORT в .env .
Установите переменные среды, затем запустите:
npm run devВы можете использовать https://ngrok.com/
Это последний шаг! Вам нужно настроить веб -крюк для вашего бота Telegram для получения обновлений от Telegram. Чтобы сделать это, вам просто нужно сделать запрос сообщения на следующий URL:
curl -X POST https:// < your-deployment-url > /api/telegram-hook/init ? secret_hash= < the-secret-password-from-env-var > Замените <your-deployment-url> на базовый URL вашего развертывания и <the-secret-password-from-env-var> со значением TELEGRAM_BOT_SECRET в переменных вашей среды или .env .
Теперь ваше мини -приложение готово! Вы можете проверить его, отправив команды или сообщения своему боту Telegram. Наслаждаться! ?
Чтобы узнать больше, взгляните на следующие ресурсы:
Ваши отзывы и вклад приветствуются!