Pengaturan Telegram Bot

Panduan untuk mengatur channel Telegram Bot di Malketing.

Akses Telegram Settings

1. Login ke dashboard

2. Klik menu Channels > Telegram di sidebar

3. Atau akses https://app.malketing.id/channels/telegram

Persiapan

Persyaratan

Persyaratan	Detail
Akun Telegram	Dibutuhkan untuk membuat bot
Bot Token	Dari @BotFather
Webhook URL	HTTPS URL untuk receive updates

Membuat Bot Baru

1. Buka Telegram

2. Cari @BotFather

3. Kirim /newbot

4. Ikuti instruksi:

   • Nama bot

   • Username bot (harus berakhir dengan "bot")

5. BotFather akan memberikan token

6. SIMPAN TOKEN - diperlukan untuk setup

Proses Setup

Step 1: Input Bot Token

1. Di halaman Telegram settings

2. Masukkan Bot Token dari @BotFather

3. Klik "Verify"

Step 2: Configure Webhook

1. Sistem akan auto-setup webhook

2. Atau manual setup:

curl -F "url=https://your-webhook-url/botTOKEN" \
https://api.telegram.org/botTOKEN/setWebhook

Step 3: Channel Configuration

Setting	Description	Default
Bot Name	Nama bot	From token
Webhook URL	URL untuk updates	Auto-set
Parse Mode	Format pesan	Markdown

Step 4: Complete Setup

1. Review konfigurasi

2. Klik "Finish Setup"

3. Test dengan mengirim pesan ke bot

Interface Telegram Settings

Overview

Section	Description
Connection	Status koneksi
Bot Info	Informasi bot
Settings	Konfigurasi
Statistics	Usage stats

Connection Status

Status	Ikon	Description
Connected	🟢	Bot aktif, webhook aktif
Disconnected	🔴	Bot terputus
Webhook Error	🟠	Webhook error

Fitur yang Didukung

Pesan yang Didukung

Tipe	Support	Catatan
Text	✅
Image	✅
Video	✅
Audio	✅
Document	✅	PDF, DOC, dll
Sticker	✅
Emoji	✅
Link	✅

Bot Features

Feature	Support
Inline Keyboard	✅
Reply Keyboard	✅
Callback Query	✅
Inline Query	❌
Payments	❌

Interactive Messages

Inline Keyboard

{
  "inline_keyboard": [
    [
      {"text": "Option 1", "callback_data": "opt1"},
      {"text": "Option 2", "callback_data": "opt2"}
    ]
  ]
}

Reply Keyboard

{
  "keyboard": [
    [{"text": "/start"}, {"text": "/help"}],
    [{"text": "Menu"}, {"text": "Contact"}]
  ],
  "resize_keyboard": true
}

Konfigurasi Channel

Bot Settings

Setting	Description
Bot Name	Nama tampilan bot
Description	Deskripsi bot
About	Informasi tentang bot
Profile Photo	Foto profil bot

Webhook Settings

Setting	Description
Webhook URL	URL untuk menerima updates
Secret Token	Token untuk verifikasi
Max Connections	Maks koneksi
Allowed Updates	Tipe updates yang diizinkan

Message Settings

Setting	Description	Default
Parse Mode	HTML/Markdown/None	Markdown
Disable Preview	Disable link preview	Off
Disable Notification	Silent send	Off

Mengelola Channel

Test Bot

1. Di Telegram, cari bot username

2. Kirim /start

3. Verify pesan masuk di dashboard

Update Bot Info

1. Klik "Edit Bot"

2. Update informasi

3. Simpan perubahan

Reset Webhook

1. Klik "Reset Webhook"

2. Konfirmasi

3. Webhook akan di-reset

Disconnect Bot

1. Klik "Disconnect"

2. Konfirmasi

3. Bot terputus dari sistem

Statistics

Metric	Description
Messages Received	Pesan masuk
Messages Sent	Pesan terkirim
Updates Received	Total updates
Webhook Errors	Error count
Avg Response Time	Rata-rata respons

Best Practices

1. Bot Setup

• Gunakan username yang professional

• Set profile photo

• Tulis description yang jelas

• Enable privacy mode jika perlu

2. Keyboard Design

• Gunakan reply keyboard untuk commands

• Gunakan inline keyboard untuk choices

• Batasi jumlah buttons

• Clear keyboard setelah selesai

3. Message Formatting

• Gunakan Markdown untuk formatting

• Avoid overly complex HTML

• Test formatting sebelum send

4. Error Handling

• Monitor webhook errors

• Setup fallback mechanism

• Log semua errors

Troubleshooting

Webhook Error

Error	Solution
SSL Required	Gunakan HTTPS URL
Connection Timeout	Check server accessibility
404 Not Found	Verify URL

Messages Not Received

Cause	Solution
Bot not started	User harus /start
Privacy mode	Disable privacy mode
Webhook down	Reset webhook

Send Failed

Cause	Solution
Bot blocked	User memblokir bot
Invalid chat ID	Verify chat ID
Message too old	Telegram limits