# Notifikasi Telegram bot vs push API untuk alert developer

> Telegram bot adalah cara gratis dan familiar untuk mengirim alert ke diri sendiri. Ini panduan setup lengkapnya, kapan cara ini tetap andal, kapan terasa merepotkan – satu suara untuk semua, aturan escaping, token di setiap URL – dan kapan push API adalah alat yang lebih baik.

*08.10.2026*

<!-- source: https://pocketalert.app/id/blog/telegram-bot-vs-push-notifications -->

Tanyakan kepada sekelompok developer bagaimana mereka menerima alert dari script mereka, dan separuhnya akan menjawab "sebuah Telegram bot". Cara ini gratis, Telegram sudah ada di ponsel, dan pesan pertama bisa disiapkan dalam sepuluh menit.

Namun, ini juga aplikasi chat yang sedang menjalankan tugas pager. Cara ini berjalan baik sampai alert yang penting masuk ke aliran yang sama dengan group chat, atau sampai nama file dengan garis bawah merusak pesan. Post ini membahas setup Telegram secara jujur: di mana cara ini tetap andal, di mana tidak, dan bagaimana alert yang sama terlihat jika dikirim lewat push notification API.

## Setup Telegram dari awal sampai akhir

1. **Buat bot.** Kirim pesan ke `@BotFather`, kirim `/newbot`, lalu pilih nama dan username yang diakhiri `bot`. Anda akan mendapatkan token seperti `110201543:AAH...`.
2. **Sapa bot terlebih dahulu.** Bot tidak bisa memulai percakapan, jadi buka bot dan kirim pesan apa pun. Untuk grup, tambahkan bot ke grup.
3. **Cari chat id Anda.** Panggil `getUpdates` dan baca `message.chat.id` dari hasilnya:

```bash
curl -s "https://api.telegram.org/bot$TG_TOKEN/getUpdates" | jq '.result[].message.chat.id'
```

Update disimpan selama 24 jam, dan `getUpdates` berhenti berfungsi begitu webhook diatur pada bot. ID grup bernilai negatif, dan ID supergroup diawali `-100`.

4. **Kirim alert:**

```bash
curl -s "https://api.telegram.org/bot$TG_TOKEN/sendMessage" \
  -d chat_id="$TG_CHAT_ID" \
  -d text="Backup failed on db-01"
```

Itulah keseluruhan integrasinya: dua secret di file environment dan satu panggilan HTTP.

## Di mana Telegram bekerja dengan baik

- **Gratis.** FAQ Telegram sendiri menyebutkan bahwa bot dapat mengirim pesan kepada penggunanya tanpa biaya.
- **Ada di mana pun Anda berada.** Klien ponsel, desktop, dan web, semuanya tersinkron.
- **Grup tidak dikenai biaya.** Tambahkan bot ke chat tim dan semua orang melihat alert tersebut serta bisa membahasnya di thread yang sama.
- **Anda sudah membukanya.** Tidak perlu aplikasi baru, tidak perlu akun baru.

Untuk notifikasi berisiko rendah, seperti "laporan harian sudah siap", cara ini sulit ditandingi.

## Di mana cara ini mulai merepotkan

### Setiap alert terdengar sama

Bot API hanya punya satu kontrol pengiriman: `disable_notification`, yang mengirim pesan tanpa suara. Tidak ada prioritas, tidak ada level time-sensitive, dan tidak ada yang bisa menembus Jangan Ganggu. Backup yang gagal pukul 3 pagi datang dengan cara yang sama seperti stiker di group chat, dan jika Anda membisukan chat untuk menghindari kebisingan, alert-nya ikut dibisukan.

### Formatting akan merepotkan Anda

Dengan `parse_mode=MarkdownV2`, karakter `_ * [ ] ( ) ~ > # + - = | { } . !` dan backtick harus di-escape dengan backslash di luar formatting. Alert penuh dengan karakter-karakter tersebut: nama file, nomor versi, URL, stack trace. Satu titik yang tidak di-escape pada `db-01.internal` akan membuat Telegram menolak pesan dengan error 400, sehingga alert tentang kegagalan itu pun ikut gagal. Mode HTML lebih aman, tetapi Anda tetap harus meng-escape `<`, `>` dan `&` pada semua yang Anda kirim.

### Token adalah bot-nya

Token ditaruh di path URL setiap request, dan dokumentasi Telegram menegaskan bahwa siapa pun yang memilikinya bisa mengendalikan bot Anda. Dalam praktiknya, URL tersebut berakhir di riwayat shell, log CI, dan tempat lain tempat URL request dicatat. Jika bocor, `/token` di BotFather akan menerbitkan token baru, dan setiap script harus diperbarui.

### Tombol membutuhkan bot yang berjalan

Inline button bisa membuka URL, dan itu tidak masalah. Tombol yang melakukan sesuatu, seperti "restart service", menggunakan `callback_data`, dan ketika tombol ditekan, muncul spinner sampai bot Anda membalasnya. Artinya, dibutuhkan proses yang terus mendengarkan update sepanjang waktu, dan itu lebih dari yang diinginkan sebuah cron job.

### Lonjakan kena rate limit

Telegram meminta bot untuk tetap di bawah satu pesan per detik per chat, dan 20 pesan per menit dalam grup. Jika webhook yang cerewet diarahkan ke sebuah grup, Anda akan mendapatkan `429 Too Many Requests` dengan nilai `retry_after`, tepat saat keadaan sedang memburuk dan alert datang paling cepat.

### Layanan tidak bisa langsung mengirim ke sana

GitHub, Stripe, Grafana dan Sentry mengirim webhook dengan JSON mereka sendiri. Bot API membutuhkan `chat_id` dan `text`. Harus ada perantara yang menerjemahkan: server kecil, serverless function, atau alur n8n atau Zapier. Relay itu menjadi satu hal lagi yang harus terus dijalankan.

### Alert tersimpan di dalam messenger

Pesan bot adalah pesan chat Telegram biasa, disimpan oleh Telegram dan bercampur dengan chat pribadi Anda. Mencari insiden bulan lalu berarti menggulir chat, bukan memfilter riwayat berdasarkan sumber.

## Alert yang sama lewat push API

Berikut alert backup yang dikirim ke [Pocket Alert](/), dengan prioritas dan tombol yang membuka log job:

```bash
curl -X POST https://api.pocketalert.app/v1/messages \
  -H "Token: $PA_KEY" \
  -H 'Content-Type: application/json' \
  -d '{
    "title": "Backup failed",
    "message": "db-01.internal: pg_dump exited with code 1",
    "level": "high",
    "actions": [{ "type": "view", "label": "Open log", "value": "https://ci.example.com/jobs/4821" }]
  }'
```

Yang berubah:

- **Satu secret, di dalam header.** Kunci API ada di header `Token`, bukan token di URL ditambah chat id.
- **Teks biasa masuk, teks biasa keluar.** Tidak ada aturan escaping. Titik, garis bawah, dan tanda kurung sampai apa adanya.
- **Prioritas per pesan.** `silent`, `low`, `default`, `high` atau `critical`. Di iPhone, high dan critical lolos dari Fokus sebagai notifikasi time-sensitive, dan di Android alert critical menimpa Jangan Ganggu. Lihat [critical alerts](/use-cases/critical-alerts).
- **Tombol tanpa bot.** Hingga tiga [tombol aksi](/features/action-buttons): membuka URL, memanggil endpoint HTTP, atau menyalin sebuah nilai. Tidak ada yang harus mendengarkan ketukan tombol.
- **Layanan langsung mengirim.** Setiap [webhook](/use-cases/webhook-notifications) memiliki URL sendiri. GitHub atau Grafana mengirim JSON-nya sendiri, dan placeholder seperti `%alerts.0.labels.alertname%` menarik field ke dalam notifikasi. Setiap panggilan tercatat di [riwayat webhook](/features/webhook-history).
- **Riwayat tersendiri.** Alert disimpan di aplikasi dan dasbor terpisah, dikelompokkan per aplikasi, bukan tercampur di antara chat Anda.

## Kapan Telegram tetap pilihan yang lebih baik

Agar adil:

- **Volume dengan anggaran terbatas.** Telegram gratis tanpa kuota harian selain rate limit-nya. Paket gratis Pocket Alert berisi 50 pesan per hari; untuk lebih dari itu diperlukan paket berbayar mulai dari $6 per bulan.
- **Alert yang memulai percakapan.** Jika tujuannya agar tim mendiskusikan alert di tempat alert itu muncul, group chat melakukannya dengan baik dan push notification tidak.
- **Desktop dan web lebih utama.** Jika Anda bekerja dari laptop, klien desktop Telegram menampilkan alert di tempat yang memang sering Anda lihat. Aplikasi Pocket Alert tersedia untuk iPhone dan Android, dengan dasbor web untuk riwayat.

Pembagian yang bekerja untuk banyak tim: simpan grup Telegram untuk obrolan dan ringkasan harian, dan kirim apa pun yang harus membangunkan seseorang sebagai push dengan level.

## FAQ

### Bisakah pesan dari Telegram bot menembus Jangan Ganggu?

Tidak dari sisi bot. Bot API tidak memiliki pengaturan prioritas, hanya `disable_notification` untuk membuat pesan senyap. Satu-satunya cara agar lolos dari Fokus di iPhone adalah penerima mengizinkan Telegram sebagai pengecualian aplikasi, yang meloloskan semua notifikasi Telegram, bukan hanya alert.

### Bagaimana cara menemukan chat id Telegram saya?

Kirim pesan apa pun ke bot Anda, lalu panggil `https://api.telegram.org/bot<token>/getUpdates` dan baca `message.chat.id`. Jika hasilnya kosong, update tersebut mungkin sudah lebih dari 24 jam, atau bot memiliki webhook yang diatur, dan `getUpdates` tidak berfungsi selama webhook aktif.

### Mengapa alert Telegram saya gagal dengan error 400?

Biasanya karena ada karakter yang tidak di-escape dalam mode `MarkdownV2` atau `HTML`. Hapus `parse_mode` untuk mengirim teks biasa, atau escape setiap karakter yang dicadangkan sebelum mengirim.

### Apakah push notification API lebih sulit disiapkan daripada Telegram bot?

Kurang lebih sama. Dengan Pocket Alert, Anda memasang aplikasi, menyalin kunci API dari dasbor, dan mengirim satu POST. Tidak ada chat id yang perlu dicari dan tidak ada bot yang perlu dibuat.

### Bisakah saya mengirim ke keduanya?

Bisa. Banyak tim menyimpan Telegram untuk diskusi dan mengirim alert yang membutuhkan respons sebagai push. Sebuah script bisa memanggil kedua API, dan sebagian besar layanan yang mengirim webhook menerima lebih dari satu URL.

[Buat akun Pocket Alert gratis](/signup) dan jalankan curl di atas, atau baca dulu [apa itu push notification API](/blog/what-is-a-push-notification-api). Jika Anda sedang menimbang opsi lain, [halaman perbandingan](/alternatives) mencakup Pushover, ntfy, Bark, Gotify dan lainnya.
