mini woo
1.0.0
O Mini Woo é um projeto que permite criar um Mini App para o Telegram, o aplicativo de mensagens com mais de 500 milhões de usuários ativos, que se conecta ao seu site WooCommerce, a plataforma de comércio eletrônico mais popular da Web.
Ele usa o Next.js, uma estrutura do React para criar aplicativos da Web rápidos e escaláveis, e a API do Telegram Bot e a API REST WOoCommerce para fornecer uma experiência de compra perfeita para seus clientes no Telegram.
Você pode usar este projeto como um modelo para personalizar seu mini aplicativo com sua própria marca, produtos e recursos ou modificar a API para conectar qualquer outra loja on -line que suporta serviços da Web RESTful. Este projeto é de código aberto e é gratuito. Você pode encontrar as instruções de código -fonte, documentação e instalação aqui no GitHub.
Para usar este projeto, você precisa definir as seguintes variáveis de ambiente:
NEXT_PUBLIC_BASE_PATH Este é o URL base da sua implantação. Por exemplo, se você estiver implantando no Vercel, pode ser algo como https://mini-woo-<your-username>.vercel.app .
TELEGRAM_BOT_TOKEN Este é o token de acesso que você recebe do @botfather ao criar seu bot de telegrama.
TELEGRAM_BOT_SECRET Esta é uma senha que você define para proteger suas APIs. Pode ser qualquer string, como my-pass ou um hash gerado aleatoriamente. Por favor, certifique -se de mantê -lo em segredo.
TELEGRAM_PAYMENT_PROVIDER_TOKEN Este é o token do provedor de pagamentos do telegrama. Você pode conectar métodos de pagamento do Botfather. Provedores de pagamento, moedas suportadas
WOOCOMMERCE_URL Este é o URL do seu site de WooCommerce. Por exemplo, https://<your-super-cool-store>.com .
WOOCOMMERCE_CONSUMER_KEY WOOCOMMERCE_CONSUMER_SECRET Estas são a chave de autenticação e segredo que você obtém nas configurações de WooCommerce. Você pode seguir esta instrução para gerá -los.
Você precisa implantar seu aplicativo em uma plataforma ou em um servidor de sua escolha.
A maneira mais fácil de implantar seu aplicativo Next.js é usar a plataforma Vercel dos criadores do Next.JS. Você precisa gastar este repositório primeiro.
Confira a documentação do Next.JS de implantação para obter mais detalhes.
Se você preferir implantar seu aplicativo em seu próprio servidor, precisará copiar example.env para .env na raiz do projeto e preencher as variáveis. Então, você precisa executar os seguintes comandos:
npm run build
npm run start Isso criará e iniciará seu aplicativo na porta especificada pela variável PORT em .env .
Definir variáveis de ambiente e executar:
npm run devVocê pode usar https://ngrok.com/
Este é o último passo! Você precisa configurar um webhook para o seu bot de telegrama para receber atualizações do Telegram. Para fazer isso, você só precisa fazer uma solicitação de postagem para o seguinte URL:
curl -X POST https:// < your-deployment-url > /api/telegram-hook/init ? secret_hash= < the-secret-password-from-env-var > Substitua <your-deployment-url> pelo URL base da sua implantação e <the-secret-password-from-env-var> pelo valor de TELEGRAM_BOT_SECRET em suas variáveis de ambiente ou .env .
Agora seu mini aplicativo está pronto! Você pode testá -lo enviando comandos ou mensagens para o seu bot de telegrama. Aproveitar! ?
Para saber mais, dê uma olhada nos seguintes recursos:
Seus comentários e contribuições são bem -vindos!
