mini woo

Mini Woo: Aplikasi Mini Telegram untuk WooCommerce

Mini Woo adalah proyek yang memungkinkan Anda membuat aplikasi mini untuk Telegram, aplikasi pesan dengan lebih dari 500 juta pengguna aktif, yang terhubung ke situs web WooCommerce Anda, platform e-commerce paling populer di web.

Ini menggunakan Next.js, kerangka kerja bereaksi untuk membangun aplikasi web yang cepat dan dapat diskalakan, dan API Bot Telegram dan WooCommerce REST API untuk memberikan pengalaman berbelanja yang mulus bagi pelanggan Anda di Telegram.

Anda dapat menggunakan proyek ini sebagai templat untuk menyesuaikan aplikasi mini Anda dengan branding, produk, dan fitur Anda sendiri, atau memodifikasi API untuk menghubungkan toko online lain yang mendukung layanan web REST. Proyek ini adalah open source dan gratis untuk digunakan. Anda dapat menemukan kode sumber, dokumentasi, dan instruksi instalasi di sini di GitHub.

Persyaratan

• Bot telegram
• Situs web WooCommerce
• NodeJS (versi LTS terbaru direkomendasikan)

Memulai

1. Siapkan variabel lingkungan
2. Menyebarkan
3. Init Telegram Bot API Webhook

Variabel Lingkungan

Untuk menggunakan proyek ini, Anda perlu mengatur variabel lingkungan berikut:

• NEXT_PUBLIC_BASE_PATH Ini adalah URL dasar dari penyebaran Anda. Misalnya, jika Anda menggunakan Vercel, itu bisa menjadi sesuatu seperti https://mini-woo-<your-username>.vercel.app .

• TELEGRAM_BOT_TOKEN Ini adalah token akses yang Anda dapatkan dari @BotFather saat Anda membuat bot telegram.

• TELEGRAM_BOT_SECRET Ini adalah kata sandi yang Anda tetapkan untuk mengamankan API Anda. Ini bisa berupa string apa pun, seperti my-pass atau hash yang dihasilkan secara acak. Pastikan untuk merahasiakannya.

• TELEGRAM_PAYMENT_PROVIDER_TOKEN Ini adalah token penyedia pembayaran telegram. Anda dapat menghubungkan metode pembayaran dari Botfather. Penyedia pembayaran, mata uang yang didukung

• WOOCOMMERCE_URL Ini adalah URL situs web WooCommerce Anda. Misalnya, https://<your-super-cool-store>.com .

• WOOCOMMERCE_CONSUMER_KEY WOOCOMMERCE_CONSUMER_SECRET Ini adalah kunci dan rahasia otentikasi yang Anda peroleh dari pengaturan wooCommerce. Anda dapat mengikuti instruksi ini untuk menghasilkannya.

Menyebarkan

Anda perlu menggunakan aplikasi Anda di platform atau server pilihan Anda.

Menyebarkan di Vercel

Cara termudah untuk menggunakan aplikasi selanjutnya.js Anda adalah dengan menggunakan platform Vercel dari pencipta Next.js. Anda perlu membayar repositori ini terlebih dahulu.

Lihat Dokumentasi Penerapan Next.js untuk lebih jelasnya.

Menyebarkan di server

Jika Anda lebih suka menggunakan aplikasi Anda di server Anda sendiri, Anda perlu menyalin example.env ke .env di akar proyek dan mengisi variabel. Kemudian, Anda perlu menjalankan perintah berikut:

npm run build

npm run start

Ini akan membangun dan memulai aplikasi Anda di port yang ditentukan oleh variabel PORT di .env .

Jalankan secara lokal untuk pengembangan

Atur variabel lingkungan kemudian jalankan:

npm run dev

Anda dapat menggunakan https://ngrok.com/

Init Telegram Bot API Webhook

Ini adalah langkah terakhir! Anda perlu menyiapkan webhook untuk bot telegram Anda untuk menerima pembaruan dari telegram. Untuk melakukan ini, Anda hanya perlu membuat permintaan posting ke URL berikut:

curl -X POST https:// < your-deployment-url > /api/telegram-hook/init ? secret_hash= < the-secret-password-from-env-var >

Ganti <your-deployment-url> dengan url dasar penyebaran Anda dan <the-secret-password-from-env-var> dengan nilai TELEGRAM_BOT_SECRET di variabel lingkungan Anda atau .env .

Sekarang aplikasi mini Anda sudah siap! Anda dapat mengujinya dengan mengirim perintah atau pesan ke bot telegram Anda. Menikmati! ?

Fitur

• Tampilkan daftar produk
• Filter berdasarkan kategori
• Daftar pesanan
• Bayar dengan pembayaran telegram
• Mendukung item variabel
• Mendukung item pencarian
• Metode Pengiriman Dukungan
• Mendukung metode pembayaran lainnya
• lagi...

Pelajari lebih lanjut

Untuk mempelajari lebih lanjut, lihat sumber daya berikut:

• Aplikasi Mini Telegram - Titik awal untuk mempelajari tentang aplikasi web telegram.
• Telegram Bot API - Dokumentasi Lengkap Telegram Bot API.
• Telegraf.js - Kerangka API Bot Telegram Modern untuk Node.js (Dokumen).
• WOOCOMMERCE API - Dokumentasi API REST WOOCOMERCE.
• Dokumentasi Next.js - Pelajari Tentang Fitur dan API Next.js.
• Pelajari Next.js - Tutorial interaktif Next.js.

Umpan balik dan kontribusi Anda dipersilakan!