# 💸 Saweria Notifier
**Notifikasi donasi Saweria langsung ke Telegram — real-time, gratis, tanpa hosting sendiri.**
## 📖 Tentang **Saweria Notifier** adalah bot Telegram yang menjembatani *webhook* Saweria dengan chat Telegram-mu. Begitu ada donasi masuk, bot langsung mengirim pesan notifikasi ke Telegram kamu — lengkap dengan nama donatur, nominal, dan pesan dukungan. Tidak perlu buka dashboard Saweria berulang kali, tidak perlu deploy server sendiri. Cukup satu perintah `/start`, dan kamu langsung dapat **Webhook URL** pribadi yang siap ditempel ke pengaturan Saweria. > [!NOTE] > Domain resmi layanan ini adalah **sawerianotifier.web.id**. Bot Telegram-nya bisa diakses di **[@sawerianotifier_bot](https://t.me/sawerianotifier_bot)**.
## ✨ Fitur | Fitur | Deskripsi | |---|---| | 🔔 **Notifikasi Instan** | Setiap donasi masuk langsung dikirim ke Telegram dalam hitungan detik. | | 🗂 **JSON API** | Ambil data donasi terakhir kapan saja lewat endpoint `GET`, cocok untuk overlay stream / widget. | | ⚙ **Kanal Bisa Diatur** | Aktifkan atau nonaktifkan Telegram dan JSON API secara terpisah lewat menu bot. | | 🔑 **Webhook Privat** | Setiap pengguna mendapat *key* unik acak — tidak bisa ditebak, tidak bisa dilihat pengguna lain. | | 🔄 **Reset Sekali Klik** | Curiga URL bocor? Reset langsung dari menu, URL lama otomatis mati. | | 🏆 **Papan Donatur** | Daftar publik pendukung pengembangan bot ini, lengkap dengan total dukungan. |
## 🚀 Panduan Pemasangan
| 1 | Buka **[@sawerianotifier_bot](https://t.me/sawerianotifier_bot)** di Telegram, lalu kirim perintah: ``` /start ``` Bot akan membalas dengan menu utama dan **Webhook URL** pribadimu. |
| 2 | Salin Webhook URL tersebut. Bentuknya seperti ini: ``` https://sawerianotifier.web.id/?key=xxxxxxxxxxxx ``` |
| 3 | Masuk ke **Saweria → Settings → Integration → Webhook**, tempel URL di kolom yang tersedia, lalu simpan. |
| 4 | Klik tombol **"Munculkan Notifikasi"** di Saweria untuk mengirim donasi percobaan. Jika Telegram-mu menerima pesan test, pemasangan berhasil 🎉 |
## 🖥️ Menu Bot Semua pengaturan dikendalikan lewat tombol inline di Telegram, tidak ada perintah yang perlu dihafal. **🏠 Menu Utama** — menampilkan Webhook URL, status koneksi tiap kanal, dan akses ke pengaturan. **⚙️ Pengaturan** - 📨 Aktifkan / nonaktifkan notifikasi **Telegram** - 🗂 Aktifkan / nonaktifkan **JSON API** - 🔄 Reset Webhook URL (dengan konfirmasi) - Minimal satu kanal wajib tetap aktif, agar donasi tidak pernah hilang begitu saja **🏆 Donatur Bot** — daftar pendukung pengembangan bot dengan paginasi, beserta total dukungan dan tombol untuk ikut berdonasi.
## ⚙️ Cara Kerja Satu endpoint, tiga jalur berbeda — dibedakan dari metode HTTP dan keberadaan parameter `key`.
| Rute | Metode | Trigger | Fungsi |
|---|---|---|---|
Telegram Webhook | POST | tanpa ?key= | Menerima pesan & klik tombol dari Telegram, merender menu. |
Saweria Webhook | POST | dengan ?key= | Menerima event donasi dari Saweria, meneruskan ke Telegram. |
JSON API | GET | dengan ?key= | Mengembalikan data donasi terakhir dalam format JSON. |
## 🔌 JSON API Cocok dipakai untuk overlay stream, widget donasi, atau integrasi kustom lainnya. **Ambil donasi terakhir** ``` GET https://sawerianotifier.web.id/?key=xxxxxxxxxxxx ``` Contoh respons ketika data tersedia: ```json { "status": "success", "data": { "id": "d290f1ee-6c54-4b01-90e6-d701748f0851", "donator_name": "Budi Santoso", "amount_raw": 20000, "amount_net": 18000, "amount_text": "Rp20.000", "message": "Semangat terus kontennya!", "created_at": "2026-07-18T10:22:00Z", "received_at": "2026-07-18 17:22:00" } } ``` Jika JSON API sedang dinonaktifkan atau belum ada donasi masuk, `status` akan bernilai `"disabled"` atau `"empty"` beserta pesan penjelasnya — bukan error, jadi aman dipoll secara berkala.
## 🔐 Keamanan - Setiap pengguna punya **key acak 12 karakter** yang tidak bisa ditebak. - Donasi dengan ID yang sama tidak akan dikirim dua kali (anti-duplikat), kecuali donasi percobaan bawaan Saweria. - Reset webhook langsung mematikan URL lama secara permanen — tidak ada cara memulihkannya. - Tidak ada data kartu, rekening, atau kredensial Saweria yang disimpan oleh bot ini. Bot hanya menerima apa yang dikirim Saweria lewat webhook.
## 💝 Dukung Pengembangan Bot ini gratis dan tidak berbayar. Jika terbantu, kamu bisa ikut mendukung lewat menu **🏆 Donatur Bot** di dalam bot, atau langsung lewat halaman Saweria pengembang. Semua pendukung akan tercantum di papan donatur publik.
## ❓ FAQ
Apakah saya perlu server atau hosting sendiri?
Tidak. Cukup daftar lewat bot Telegram, semua infrastruktur sudah disediakan di
sawerianotifier.web.id.
Bisakah satu Webhook URL dipakai untuk beberapa akun Saweria?
Satu Webhook URL terikat ke satu chat Telegram. Untuk akun Saweria berbeda, gunakan
/start dari akun Telegram yang berbeda pula untuk mendapat key terpisah.
Notifikasi tidak masuk ke Telegram, apa yang harus dicek?
Pastikan kanal Telegram berstatus aktif di menu Pengaturan, Webhook URL di Saweria sudah tersimpan dengan benar, dan kamu sudah pernah mengirim
/start ke bot sebelumnya.
Apakah data donasi disimpan selamanya?
Bot hanya menyimpan data donasi terakhir untuk keperluan JSON API, bukan riwayat penuh.
---
Dibuat untuk komunitas kreator Indonesia · **[sawerianotifier.web.id](https://sawerianotifier.web.id)** · Bot: **[@sawerianotifier_bot](https://t.me/sawerianotifier_bot)**