# Hubungkan Telegram

Hubungkan satu atau beberapa bot Telegram. Chat pribadi pelanggan dengan bot Anda masuk ke OneInbox.

## Sebelum mulai

- Anda sudah membuat bot di [@BotFather](https://t.me/BotFather) dan memegang token bot.
- Anda masuk sebagai Owner atau Admin.
- Token bot berbentuk seperti `123456:ABC-DEF...`. Jaga kerahasiaannya.

## Langkah

1. Di Telegram, buka @BotFather lalu buat bot baru. Salin token yang diberikan.
2. Di tumbuh.ai, buka menu **Platform > Telegram**.
3. Tempel token di kolom **Connect BotFather Token**.
4. Klik **Connect**.

![Halaman Telegram Bot dengan kolom token BotFather dan daftar Connected Bots](/images/telegram-bot.png)

Setelah Anda klik **Connect**, tumbuh.ai memeriksa token ke Telegram, lalu mendaftarkan webhook secara otomatis. Anda tidak perlu mengatur webhook sendiri. Token disimpan terenkripsi.

## Hasil yang diharapkan

- Toast "Telegram bot connected" muncul.
- Bot tampil di daftar **Connected Bots** dengan nama, `@username`, jumlah percakapan, dan status koneksi.
- Pesan pribadi ke bot muncul di [OneInbox](/fitur-utama/oneinbox).

## Kelola bot

- Ikon segarkan (reset webhook) mendaftarkan ulang webhook bila pesan berhenti masuk.
- Ikon tempat sampah (Disconnect) memutus bot. Tidak ada dialog konfirmasi, jadi pemutusan langsung berjalan.
- Anda bisa menghubungkan lebih dari satu bot. Jumlah bot tidak dibatasi paket.

## Batasan

- Hanya chat pribadi (DM). Pesan dari grup dan kanal diabaikan.
- Pesan masuk yang didukung: teks, foto, dan dokumen.

## Masalah umum

- **Token ditolak (toast "Connect failed")**: pastikan token disalin utuh dari @BotFather, tanpa spasi.
- **Pesan tidak masuk**: klik ikon reset webhook pada bot.
- **Bot dari grup tidak terbaca**: ini memang diabaikan.

Masalah lain ada di [Masalah koneksi](/troubleshooting/masalah-koneksi).