Telegram Bot

Notifikasi real-time dari OtoSwitch ke Telegram. Berguna agar tidak perlu pantau dashboard terus-menerus.

Fitur ini hanya tersedia di plan Basic dan Pro. Plan Trial tidak mendukung.

Prasyarat

  • Plan Basic atau Pro aktif.
  • Server OtoSwitch sudah dikonfigurasi dengan TELEGRAM_BOT_TOKEN (operator/admin yang setup).
  • Akun Telegram pribadi (HP atau desktop).

Cara link akun

  1. Login dashboard → klik menu Pengaturan atau buka section Telegram di sidebar.
  2. Klik Hubungkan Telegram.
  3. Modal muncul dengan tombol Buka Telegram. Klik tombol.
  4. Telegram terbuka ke chat dengan bot OtoSwitch (mis. @otoswitch_bot).
  5. Tap Start atau ketik /start di chat.
  6. Bot mengirim konfirmasi: "Akun Telegram berhasil dihubungkan dengan OtoSwitch (email kamu)."
  7. Kembali ke dashboard — status berubah jadi 🟢 Terhubung.

Link berlaku 15 menit. Kalau lewat, klik Hubungkan lagi untuk dapat link baru.

Jenis notifikasi

Order paid

✅ Pembayaran sukses
Plan: Basic (1 bulan)
Order: #ORD-20260509-001
Berlaku sampai: 9 Juni 2026

Dikirim segera setelah webhook gateway konfirmasi pembayaran.

Subscription expiry reminder

OtoSwitch kirim peringatan beberapa kali sebelum & saat expired:

Kapan Pesan
7 hari sebelum ⚠️ Langganan akan expired dalam 7 hari. Perpanjang sekarang biar tidak terputus.
3 hari sebelum ⚠️ 3 hari lagi langganan expired.
1 hari sebelum ⚠️ Besok langganan expired. Perpanjang sekarang.
Saat expired 🔴 Langganan sudah expired. Monitor dimatikan.

Scan event (opsional)

Kalau ada event signifikan saat scan:

  • Supplier mati pada produk pulsa critical (severity tinggi).
  • Auto-switch berhasil pada produk gangguan.
  • Produk gangguan tanpa alternatif.

Notifikasi scan tidak nge-flood — di-throttle agar tidak lebih dari 1-2 per 10 menit.

Cek status

Endpoint API atau di dashboard:

GET /api/s/telegram/status

Response:

{
  "bound": true,
  "bound_at": "2026-04-15T10:23:00Z",
  "feature_allowed": true
}

feature_allowed: false artinya plan tidak support — upgrade ke Basic/Pro.

Unbind (lepas akun)

Dua cara:

Dari dashboard

Pengaturan → section Telegram → tombol Lepas Akun.

Dari Telegram

Ketik /unlink di chat dengan bot. Bot konfirmasi dan unbind.

Setelah unbind, notifikasi otomatis berhenti. Bisa link ulang kapan saja dengan token baru.

Multiple device

Satu akun OtoSwitch hanya bisa link ke satu Telegram chat. Kalau ingin notifikasi ke grup atau channel:

  • Buat grup Telegram, tambahkan bot OtoSwitch.
  • Promote bot jadi admin.
  • (Saat ini belum didukung — link per-grup. Workaround: forward dari personal chat.)

FAQ

Notifikasi tidak masuk walaupun status Terhubung. Cek:

  1. Plan masih aktif? (Trial = no notification.)
  2. Bot tidak di-block di Telegram (cek setting Telegram → bot info).
  3. Tunggu 1-5 menit — webhook delay normal.
  4. Coba kirim /test ke bot (kalau didukung).

Bot tidak respons saat klik Start. Token expired (>15 menit) atau salah link. Klik Hubungkan Telegram lagi di dashboard.

Bisa custom format notifikasi? Belum di UI. Format saat ini fix.

Bagaimana cara operator setup TELEGRAM_BOT_TOKEN? Tugas admin/devops:

  1. Buat bot via @BotFather → ketik /newbot.
  2. Copy token, set di env TELEGRAM_BOT_TOKEN=... server.
  3. Set TELEGRAM_BOT_USERNAME=otoswitch_bot (atau nama bot).
  4. Set TELEGRAM_WEBHOOK_SECRET=<random> untuk verifikasi callback.
  5. Restart server.