Panduan Lengkap · v4.0

Semua yang perlu Anda ketahui

Dari mengunduh aplikasi hingga menjalankan rantai, kampanye DM, dan analitik. Ditulis untuk pemula total — dengan langkah konkret dan contoh nyata.

Mulai
Kerja
Iklan & kampanye
Analitik & sistem
Bantuan

Mulai cepat

Dari nol hingga surat pertama Anda dalam waktu kurang dari 10 menit.

Apa yang Anda butuhkan sebelum memulai

Akun Telegram (atau beberapa), komputer dengan Windows 10+ atau macOS 11+, dan sekitar 10 menit waktu luang.

1 Unduh aplikasinya

Dapatkan penginstal dari halaman unduhan:

  • Windows: portabel .exe — tidak perlu instalasi
  • macOS: .dmg — seret aplikasi ke Applications
2 Aktifkan lisensi Anda

Pada peluncuran pertama Anda akan melihat jendela aktivasi. Tempel kunci Anda dan klik Aktifkan. Jika Anda belum memiliki kunci — dapatkan uji coba gratis 3 hari.

3 Dapatkan kredensial API Telegram

Masuk ke my.telegram.org, buat aplikasi, dan salin api_id dan api_hash Anda. Panduan lengkap — ada di tab API Telegram.

4 Tambahkan akun pertama Anda

Buka Akun → Tambah akun, isi Nama, ID API, Hash API (telepon opsional untuk QR). Kemudian klik Otorisasi dan pindai kode QR dengan ponsel Anda.

5 Muat penerima

Buka Penerima → Segarkan daftar untuk menarik grup, saluran, dan kontak Telegram Anda. Atau impor dari file.

6 Buat iklan pertama Anda

Buka Iklan → Iklan baru, tulis pesan Anda, pilih penerima, atur jadwal — dan tekan Mulai.

Anda selesai!

Aplikasi menjalankan kampanye di latar belakang dan mengirim pesan sesuai jadwal. Pantau kemajuan di halaman Iklan dan dasbor Statistik.

Unduh & instal

Aplikasi ini portabel di Windows dan seret-lepas di macOS. Tanpa dependensi, tanpa hak admin.

Windows

1 Unduh EXE

Simpan TelegramAutoPoster.exe (~80 MB) ke folder khusus, misalnya C:\TelegramAutoPoster\. Pada peluncuran pertama aplikasi akan membuat subfolder data/ di sana dengan semua pengaturan, sesi, dan log.

2 Tangani SmartScreen

Windows mungkin menampilkan dialog biru: "Windows protected your PC". Ini normal untuk aplikasi yang tidak ditandatangani.

  1. Klik More info
  2. Klik Run anyway
Mengapa ini terjadi?

Windows menandai aplikasi apa pun tanpa sertifikat penandatanganan kode berbayar (biasanya $100+/tahun). Aplikasi ini sepenuhnya aman — Anda dapat memverifikasinya di VirusTotal.

macOS

1 Unduh DMG

Buka TelegramAutoPoster.dmg dan seret aplikasi ke folder Applications Anda.

2 Peluncuran pertama

Klik kanan ikon aplikasi → Buka → konfirmasi Buka di dialog keamanan. Atau buka System Settings → Privacy & Security → Open Anyway.

Di mana data berada

PlatformJalur
Windows<folder dengan EXE>/data/
macOS~/Library/Application Support/TG AutoPoster Pro/
Tips: buat pintasan desktop

Klik kanan EXE → Send to → Desktop (create shortcut). Di macOS seret aplikasi ke Dock.

Pengaturan API Telegram

Setiap klien Telegram membutuhkan api_id dan api_hash — kredensial resmi gratis dari Telegram. Mendapatkannya memakan waktu sekitar 3 menit.

Apa itu API ID dan API Hash?

Mereka pada dasarnya adalah "login pengembang" untuk Telegram. Setiap aplikasi pihak ketiga memiliki pasangannya sendiri. Milik Anda akan dilampirkan hanya ke akun Anda dan aman.

1 Buka my.telegram.org

Di browser Anda, buka https://my.telegram.org.

2 Masuk dengan nomor telepon Anda

Masukkan nomor dalam format internasional yang dimulai dengan + — misalnya +628123456789. Telegram akan mengirim kode konfirmasi ke aplikasi Anda atau melalui SMS.

3 Buka API Development Tools

Klik API development tools di dasbor.

4 Buat aplikasi

Isi formulir — nilainya tidak masalah sama sekali, Telegram menyimpannya hanya untuk catatan mereka. Pilih platform Desktop dan klik Create application.

5 Salin kredensial Anda

Anda akan melihat dua nilai:

  • App api_id — nomor seperti 1234567
  • App api_hash — string 32 karakter seperti abcdef1234567890abcdef1234567890
Jaga kerahasiaan ini

Siapa pun yang memiliki ID API, Hash API, dan nomor telepon Anda berpotensi mengakses akun Telegram Anda. Jangan pernah membagikannya di obrolan, tangkapan layar, atau forum publik.

Bisakah saya menggunakan kredensial yang sama untuk banyak akun?

Ya. Kredensial API milik aplikasi, bukan pengguna Telegram tertentu. Tambahkan akun sebanyak yang Anda inginkan dengan api_id/api_hash yang sama — masing-masing akan memiliki sesinya sendiri.

Bagaimana jika saya kehilangan api_id / api_hash saya?

Cukup masuk ke my.telegram.org lagi dan buka API development tools. Aplikasi Anda yang ada masih ada di sana — Anda dapat menyalin nilainya kapan saja.

Telegram mengatakan "terlalu banyak percobaan" — apa yang harus dilakukan?

Tunggu 24 jam. Ini terjadi jika Anda membuat beberapa aplikasi atau masuk/keluar terlalu sering. Batasnya akan diatur ulang secara otomatis.

Aktivasi & paket

Tiga paket, satu jendela aktivasi. Beralih kapan saja dengan memasukkan kunci baru.

Paket sekilas

PaketAkunEkstra utama
Standard — $5/bln1Kampanye DM, rantai, rotasi, analitik, pemeriksaan sesi
Enterprise — $10/blnTak terbatas+ Balasan otomatis, mulai/berhenti massal, story, monitor kesehatan, cadangan
Supporter — $19.99/blnTak terbatas+ Dukungan prioritas, kredit aplikasi, akses awal beta Cloud
Apa yang termasuk dalam uji coba gratis?

Semua fitur tingkat Standard selama 3 hari penuh. Multi-akun, balasan otomatis, kampanye story, dan operasi massal hanya untuk Enterprise dan tidak termasuk dalam uji coba.

Mengaktifkan kunci

1 Klik tombol aktivasi

Di sidebar, jika tidak ada lisensi yang aktif, Anda akan melihat kartu merah dengan tombol Aktifkan. Atau buka Pengaturan → Lisensi → Aktifkan.

2 Tempel kunci

Kunci terlihat seperti XXXX-XXXX-XXXX-XXXX. Tempel dan tekan Enter atau klik Aktifkan.

3 Aplikasi akan memulai ulang secara otomatis

Setelah aktivasi berhasil, status lisensi diperbarui secara instan dan aplikasi dimuat ulang.

Masa tenggang offline

Aplikasi memeriksa lisensi setiap 6 jam. Jika ada masalah jaringan, aplikasi terus berfungsi dari status cache hingga 30 hari (sampai tanggal berakhir terakhir yang diverifikasi). Anda akan melihat lencana abu-abu Offline pada kartu lisensi, tetapi tidak ada fungsionalitas yang hilang.

Di mana melihat status

  • Kartu sidebar — nama paket, hari tersisa, tanggal berakhir
  • Pengaturan → Lisensi — info yang sama di halaman pengaturan
  • Banner atas — terlihat jika lisensi hilang atau kedaluwarsa

Akun

Halaman Akun adalah basis Anda. Segala hal lainnya — penerima, iklan, kampanye — milik akun yang saat ini dipilih.

Kisi akun

Setiap akun adalah kartu yang menampilkan:

  • Nama dan lencana inisial
  • Status — Diotorisasi (hijau) atau Tidak diotorisasi (abu-abu)
  • Info pengguna — nama tampilan Telegram dan @username
  • Telepon, Proxy, dan status sesi saat ini

Akun yang sedang Anda kerjakan ditandai dengan batas ungu dan lencana CURRENT di sudut kanan atas.

Toolbar

TombolApa fungsinya
SegarkanMembaca ulang daftar akun dari database lokal.
Periksa sesiMenjalankan pemeriksaan kesehatan sesi di semua akun (lihat bagian khusus di bawah).
Tambah akunMembuka editor untuk akun baru. Dinonaktifkan jika Anda mencapai batas paket.
Penghitung (mis. 2 / 5)Jumlah akun pada paket saat ini. Berubah oranye mendekati batas.

Tindakan kartu

TindakanDeskripsi
Jadikan saat iniBeralih seluruh UI ke akun ini. Hanya terlihat pada kartu non-saat ini.
Kesehatan (ikon perisai)Membuka modal Kesehatan Akun — lihat bagian khusus di bawah.
Otorisasi / Otorisasi ulangMemulai alur login QR/SMS untuk akun ini.
EditUbah nama, kredensial API, telepon, atau proxy. Mengedit kredensial memerlukan otorisasi ulang.
Hapus (ikon tempat sampah)Menghapus akun secara permanen dan file sesinya. Iklan, penerima, dan kampanye akun ini juga dihapus dari database.
Deotorisasi ≠ Hapus

Menghapus akan menghilangkan akun dan semua iklan/kampanyenya dari database lokal. Deotorisasi menyimpan semuanya — hanya file sesi yang dibuang.

Menambahkan akun baru

1 Klik "Tambah akun"

Isi:

  • Nama — label apa pun seperti "Utama" atau "Kerja"
  • ID API, Hash API — dari my.telegram.org
  • Telepon — opsional jika Anda berencana masuk melalui QR
  • Proxy — proxy per akun opsional
2 Simpan & otorisasi

Klik Simpan. Dialog konfirmasi muncul menawarkan untuk mengotorisasi segera — klik Otorisasi.

Proxy per akun

Untuk beberapa akun, gunakan proxy yang berbeda untuk masing-masing. Ini adalah salah satu sinyal terkuat bagi Telegram bahwa akun Anda tidak terkait, sangat mengurangi risiko pemblokiran.

Otorisasi QR / SMS

Dua metode. QR lebih cepat dan tidak memerlukan kolom telepon — SMS adalah cadangan.

Memilih metode

Klik Otorisasi pada akun mana pun. Dialog terbuka dengan dua opsi:

  • Kode QR — direkomendasikan. Hanya memerlukan ID API + Hash API.
  • Kode SMS — memerlukan nomor telepon di pengaturan akun.

Jika telepon kosong, opsi SMS dinonaktifkan dengan petunjuk.

Login QR

1 Jendela QR terbuka

Di ponsel Anda, buka Telegram → Settings → Devices → Scan QR.

2 Pindai QR

Arahkan kamera ke kode di layar Anda. Jendela ditutup secara otomatis.

3 Prompt dua faktor (jika diaktifkan)

Jika Anda mengaktifkan 2FA, prompt kata sandi muncul berikutnya. Ketik kata sandi cloud Anda.

Batas waktu QR

QR berlaku selama 180 detik. Jika kedaluwarsa, batalkan dan coba lagi — yang baru akan dibuat.

Login SMS

1 Pilih "Kode SMS" dan klik Mulai

Telegram mengirim kode ke aplikasi Anda (atau melalui SMS). Dialog muncul meminta kode.

2 Masukkan kode

Ketik kode 5 digit dan tekan Enter. Jika 2FA diaktifkan, Anda akan mendapat prompt kata sandi tepat setelahnya.

QR tidak dapat dipindai — apa yang harus dilakukan?

Pastikan ponsel Anda memiliki akses internet dan Telegram mutakhir. Jika proxy diatur — verifikasi dengan Tes proxy di Pengaturan. Terkadang Telegram membatasi pembuatan QR untuk sementara; tunggu 5 menit dan coba lagi.

Di mana sesi disimpan?

Di data/sessions/session_<account_id>.session di samping EXE. File inilah yang membuat Anda tetap masuk — tidak perlu memindai ulang sampai Telegram mencabut sesi.

Sesi dicabut di ponsel saya — apa yang terjadi?

Pemeriksaan sesi berikutnya akan menandai akun ini sebagai mati (🔴). Cukup klik Otorisasi lagi — atau gunakan antrean otorisasi ulang otomatis yang dijelaskan di bagian Pemeriksaan Kesehatan Sesi.

Pemeriksaan kesehatan sesi v4.0

Aplikasi menjaga sesi Telegram Anda tetap hidup tanpa Anda harus mengawasinya.

Mengapa ini penting

Sesi Telegram dapat mati kapan saja — jika seseorang masuk dari perangkat lain, mengatur ulang sesi, atau akun diblokir. Sebelumnya Anda akan mengetahuinya di tengah kampanye. Sekarang aplikasi memeriksa semuanya terlebih dahulu — saat memulai dan pada jadwal yang dapat dikonfigurasi.

Cara kerjanya

Saat aplikasi dimulai dan pada interval yang dikonfigurasi, aplikasi menelusuri setiap akun dan memverifikasi bahwa sesi masih hidup. Ini operasi cepat — satu permintaan per akun. Tanpa QR atau SMS, sesi dimuat dari data/sessions/.

Pemeriksaan berjalan di kumpulan utas latar belakang (hingga 3 akun secara paralel), sehingga antarmuka tetap responsif.

Indikator status

Di halaman Akun, setiap kartu mendapat titik berwarna di sebelah namanya:

  • 🟢 Diotorisasi — sesi hidup, siap bekerja
  • 🔴 Tidak diotorisasi — sesi mati, perlu otorisasi ulang QR
  • 🟠 Tidak dapat dijangkau — masalah jaringan (tidak ada internet, proxy mati). Sesi mungkin masih hidup — kami hanya tidak dapat memverifikasi
  • ⚪ Tidak dikonfigurasi — akun tidak memiliki kredensial API
  • 🟣 Memeriksa — pemeriksaan sedang berlangsung

Mengaktifkan dan mengonfigurasi

Buka Pengaturan → Pemeriksaan kesehatan sesi:

OpsiDeskripsi
Periksa saat memulaiJalankan pemeriksaan setiap kali aplikasi diluncurkan. Diaktifkan secara default.
Interval pemeriksaan otomatisPemeriksaan berkala dalam hitungan menit. 0 = dinonaktifkan. Disarankan: 60 atau 120.
Otorisasi ulang otomatis sesi matiKetika sesi mati ditemukan, segera buka antrean otorisasi ulang QR tanpa bertanya.

Pemeriksaan manual

Klik Periksa sesi di toolbar pada halaman Akun. Kemajuan terlihat melalui indikator titik; tombol menunjukkan memeriksa… X/Y.

Antrean otorisasi ulang

Ketika sesi mati ditemukan, aplikasi menawarkan untuk mengotorisasi ulang satu per satu:

  1. Prompt muncul: "Ditemukan N sesi mati. Otorisasi ulang semua sekarang?"
  2. Klik Ya — jendela login QR terbuka untuk akun mati pertama
  3. Pindai QR dengan ponsel Anda. Ketika akun itu diotorisasi, QR berikutnya terbuka secara otomatis
  4. Proses berlanjut hingga antrean kosong
  5. Toast ringkasan menunjukkan: Otorisasi ulang selesai: N berhasil, M gagal
Tips: aktifkan otorisasi ulang otomatis

Jika Anda memiliki banyak akun, aktifkan Otorisasi ulang otomatis sesi mati. Saat memulai Anda hanya akan melihat antrean jendela QR — ambil ponsel Anda dan pindai semuanya sekaligus.

Apakah saya harus memindai QR setiap kali?

Tidak. Sesi disimpan dalam file dan bertahan selama berbulan-bulan. QR hanya diminta ketika sesi benar-benar mati. Dalam penggunaan sehari-hari semuanya dipulihkan secara diam-diam.

Apa arti "Tidak dapat dijangkau" (🟠)?

Bukan sesi mati — masalah jaringan. Aplikasi tidak mengatur ulang otorisasi dalam kasus ini, untuk mencegah logout palsu. Coba pemeriksaan lagi nanti.

Bagaimana jika pemeriksaan dinonaktifkan?

Aplikasi tetap berfungsi — sesi diperiksa secara lazy saat pertama kali digunakan. Tetapi Anda tidak akan tahu sebelumnya jika sesi mati; Anda akan mengetahuinya saat mencoba mengirim pesan.

Monitor kesehatan akun v4.0

Indikator risiko per akun, berdasarkan aktivitas pengiriman nyata dari 24 jam terakhir.

Membukanya

Pada kartu akun mana pun, klik ikon perisai. Modal terbuka dengan data kesehatan untuk akun tersebut.

Apa yang akan Anda lihat

Banner risiko
Hijau / Kuning / Merah, dengan rekomendasi singkat.
Terkirim (24j)
Berapa banyak pengiriman sukses dalam sehari terakhir.
Kesalahan (24j)
Kesalahan dan FloodWait digabungkan.
Flood (1j)
Kesalahan FloodWait dalam satu jam terakhir.
PEER_FLOOD (sepanjang waktu)
Total peringatan anti-spam terkeras Telegram. Nilai apa pun > 0 mengubah indikator risiko menjadi merah.
Grafik aktivitas 7 hari
Batang = terkirim, garis = kesalahan. Memberi rasa tren secara langsung.
Kesalahan terkini
5 peristiwa kesalahan terakhir dengan target dan jenis kesalahan.

Tingkat risiko

TingkatPemicu
🟢 SehatAktivitas rendah, tanpa flood, tanpa riwayat PEER_FLOOD
🟡 Meningkat>20 terkirim, atau ada flood, atau ≥10 kesalahan dalam 24j
🔴 KritisAda PEER_FLOOD, atau >100 terkirim, atau ≥3 flood dalam 24j

Rekomendasi

Klik Rekomendasi di modal untuk daftar periksa berdasarkan data saat ini. Misalnya:

  • Jika PEER_FLOOD > 0 — jeda akun ini selama 24–48 jam
  • Jika flood sering — tingkatkan penundaan antar pesan
  • Jika terkirim > 100/24j — kurangi volume harian
  • Akun hijau mendapat "Anda baik-baik saja, lanjutkan apa yang Anda lakukan"

Penerima

Grup, saluran, dan kontak yang tersedia untuk akun saat ini, ditata dalam tiga kolom.

Anda biasanya tidak menambahkan penerima secara manual

Aplikasi membaca dialog Telegram nyata Anda dan hanya menampilkan obrolan di mana Anda bisa memposting — sebagai admin di saluran, atau sebagai anggota di grup. Cukup otorisasi akun dan klik Segarkan daftar.

Toolbar

TindakanDeskripsi
Segarkan daftarAmbil semua grup, saluran, dan kontak dari Telegram. Memakan waktu 5–30 detik tergantung berapa banyak obrolan yang Anda miliki.
Filter grupTampilkan hanya penerima dari grup bernama tertentu. Lihat bagian Grup Penerima.
Kelola grupBuat, ganti nama, dan hapus grup bernama.
Impor CSVMuat penerima secara massal dari file. Mendukung CSV, XLSX, dan JSON dengan dialog pratinjau.
Ekspor CSVSimpan daftar saat ini ke file CSV dengan UTF-8 BOM (ramah Excel).
Hapus semuaHapus setiap penerima akun ini. Tidak dapat dibatalkan — ekspor dulu jika ragu.

Tiga kolom

  • Grup — obrolan dan supergrup di mana Anda memiliki hak posting
  • Saluran — saluran siaran yang Anda kelola
  • Kontak — pengguna yang dapat Anda DM

Bekerja dengan item

  • Kotak centang — pilih penerima individual
  • Kotak centang di header — pilih / batalkan pilihan semua di kolom ini
  • Tombol hapus saat hover — hapus satu penerima dari daftar lokal (tidak mempengaruhi Telegram)
  • Tambah + — tambahkan satu penerima secara manual (mengetik nama yang tepat)
  • Hapus yang dipilih — hapus semua penerima yang dicentang

Bilah tindakan pilihan

Ketika setidaknya satu item dipilih, bilah tindakan ungu muncul di atas kolom dengan:

  • Tambahkan ke grup — pindahkan pilihan ke grup bernama
  • Hapus dari grup — hanya terlihat saat filter grup aktif
  • Hapus — hapus penerima yang dipilih sepenuhnya
  • Hapus pilihan — hapus centang semuanya
Daftar saya kosong setelah Segarkan

Berarti aplikasi tidak menemukan obrolan di mana Anda memiliki hak posting. Periksa bahwa: (1) akun adalah anggota beberapa grup, (2) di grup tersebut Anda memiliki izin untuk mengirim pesan, (3) untuk saluran, Anda memiliki hak admin dengan post_messages.

Bisakah saya memiliki daftar penerima yang berbeda per akun?

Ya. Setiap akun memiliki daftarnya sendiri, disimpan secara terpisah. Beralih akun memuat daftar yang benar secara otomatis.

Grup penerima v4.0

Koleksi penerima bernama — seperti "Utama", "VIP", "Tes" — untuk pemilihan sekali klik di iklan.

Apa itu grup penerima?

Ini adalah kumpulan penerima yang disimpan (grup + saluran + kontak) yang dapat Anda pilih dalam satu klik di editor iklan. Banyak-ke-banyak: penerima yang sama dapat menjadi anggota beberapa grup sekaligus.

Membuat grup

1 Klik "Kelola grup"

Toolbar di halaman Penerima, dekat filter grup.

2 Klik "Grup baru"

Ketik nama — misalnya "Saluran utama" — dan simpan.

3 Tambahkan penerima

Baik:

  • Centang penerima di kolom, lalu klik Tambahkan ke grup di bilah tindakan, atau
  • Saat mengimpor, tentukan kolom grup — lihat bagian Impor

Mengelola grup

Di dialog Kelola grup Anda dapat:

  • Ganti nama grup — ikon pensil
  • Hapus grup — ikon tempat sampah. Penerima itu sendiri tetap ada di daftar Anda; hanya keanggotaan grup yang dihapus.
  • Lihat jumlah anggota di sebelah setiap grup

Memfilter tampilan Penerima

Gunakan dropdown filter grup di toolbar untuk melihat hanya anggota grup tertentu. Opsi:

  • Semua penerima — tampilkan semuanya
  • Tanpa grup — hanya penerima yang tidak ada di grup mana pun
  • Nama grup tertentu

Memilih grup di editor iklan

Buka iklan apa pun → tab Penerima. Di atas tiga kolom Anda akan melihat deretan chip grup:

  • ○ nama — 12 — tidak ada yang dipilih (12 tersedia)
  • ◐ nama — 5/12 — dipilih sebagian
  • ✓ nama — 12 — dipilih sepenuhnya (hijau)

Klik chip untuk mengalihkan seluruh grup. Klik lagi untuk membatalkan pilihan semua di grup itu.

Grup kosong

Jika anggota grup tidak ada dalam daftar penerima Anda saat ini (misalnya, mereka dihapus oleh Segarkan daftar), chip menjadi abu-abu dan dinonaktifkan.

Impor CSV / Excel / JSON v4.0

Muat daftar penerima secara massal dari spreadsheet, dump JSON, atau CSV yang diekspor dari aplikasi lain.

Format yang didukung

  • CSV — mendeteksi pembatas secara otomatis (;, , atau tab)
  • Excel — .xlsx dan .xlsm dengan dialog pemetaan kolom interaktif
  • JSON — baik daftar objek atau dict dengan kunci group/channel/contact

Format CSV

Dua atau tiga kolom: type, name, dan opsional group.

type;name;group
group;Obrolan pemasaran;Utama
channel;@saluran_saya;Utama
contact;John Smith;
group;Obrolan tes;Tes

Tipe menerima sinonim dalam bahasa Inggris dan Rusia:

  • group, groups, группа, группы
  • channel, channels, канал, каналы
  • contact, contacts, контакт, контакты, user, users

Format JSON

Dua bentuk yang diterima:

[
  { "type": "group",   "name": "Obrolan pemasaran", "group": "Utama" },
  { "type": "channel", "name": "@saluran_saya",   "group": "Utama" }
]

Atau dikelompokkan berdasarkan tipe:

{
  "group":   ["Obrolan pemasaran", "Obrolan tes"],
  "channel": ["@saluran_saya"],
  "contact": ["John Smith"]
}

Pemetaan kolom Excel

Saat Anda mengimpor file .xlsx, dialog pemetaan muncul:

  • Kolom tipe — kolom mana yang menyimpan group/channel/contact
  • Kolom nama — kolom mana yang menyimpan nama penerima sebenarnya
  • Kolom grup — grup bernama opsional untuk menetapkan setiap penerima

Aplikasi menebak secara otomatis berdasarkan nama header ("type", "name", "group", dan padanan Rusianya). Pratinjau langsung menunjukkan 4 baris pertama seperti yang akan diurai.

Pratinjau impor

Setelah penguraian Anda akan melihat ringkasan:

  • Baru — berapa banyak baris baru yang akan ditambahkan
  • Duplikat — berapa banyak yang sudah ada di daftar Anda
  • Kesalahan — masalah penguraian, dengan nomor baris
  • Grup terdeteksi — nama grup yang ditemukan dalam file

Gabungkan vs Ganti

  • Gabungkan — menambahkan penerima baru, melewati duplikat, membiarkan yang ada tidak tersentuh
  • Ganti — menghapus daftar saat ini dan hanya menggunakan yang ada di file (dialog konfirmasi tambahan muncul)

Mengekspor ke CSV

Klik Ekspor CSV di toolbar. File disimpan dengan:

  • Pengodean UTF-8 BOM — Excel membuka teks non-ASCII dengan benar
  • Pembatas titik koma
  • Kolom grup opsional yang mencantumkan semua grup penerima tempat item tersebut berada

Nama file default: recipients_AccountName_20261016_143052.csv.

Excel menampilkan karakter rusak

File tidak disimpan sebagai UTF-8. Ekspor ulang dari aplikasi (selalu menulis UTF-8 BOM) atau di Notepad pilih "Save As → encoding UTF-8".

File besar (10.000+ baris)?

Penguraian cepat — beberapa milidetik per 1000 baris. Dialog pratinjau mungkin memakan waktu satu detik untuk file yang sangat besar, tetapi berfungsi dengan baik.

Ringkasan iklan

Halaman Iklan mencantumkan semua pesan terjadwal Anda untuk akun saat ini dan memberikan kontrol langsung atas masing-masing.

Tata letak

Dua panel terpisah:

  • Kiri — daftar iklan dengan penanda berjalan/dijeda/dihentikan
  • Kanan — detail untuk iklan yang dipilih

Penanda dalam daftar

  • ▶ — berjalan
  • ⏸ — dijeda
  • ⏹ — dihentikan

Tindakan toolbar

TombolApa fungsinya
SegarkanMuat ulang daftar iklan.
Iklan baruBuka editor iklan untuk kampanye baru.
Mulai semua / Hentikan semuaOperasi massal untuk akun saat ini.
Mulai semua (semua akun) — hanya EnterpriseMulai setiap iklan dari setiap akun yang diotorisasi.
Hentikan semua (semua akun) — hanya EnterprisePenghentian darurat di semua akun.

Panel detail

Menampilkan ringkasan konten iklan yang dipilih, interval, jendela waktu, jumlah penerima, penundaan, dan — saat berjalan — bilah kemajuan langsung.

Tombol kontrol:

  • Mulai — mulai mengirim
  • Jeda / Lanjutkan — hentikan sementara tanpa kehilangan status
  • Hentikan — batalkan sepenuhnya (siklus yang berjalan terputus seketika)
  • Edit, Duplikat, Hapus
Penyegaran langsung

Halaman melakukan polling status iklan yang berjalan setiap 1,8 detik. Kemajuan, penanda, dan tombol semuanya tetap sinkron dengan backend tanpa penyegaran manual.

Membuat iklan baru

Klik Iklan baru untuk membuka editor. Editor memiliki empat tab:

  1. Konten — teks, media, rotasi, rantai
  2. Penerima — grup, saluran, kontak, topik forum
  3. Jadwal — interval, jendela waktu, hari, penundaan, berhenti otomatis
  4. Lanjutan — batas kirim, templat

Setiap tab dibahas di bagiannya sendiri di bawah ini.

Editor iklan — Konten

Susun pesan. Tiga mode: pesan tunggal, rotasi konten, dan rantai pesan.

Mode 1 — Pesan tunggal

Mode default. Isi teks pesan dan opsional lampirkan media. Variabel didukung (lihat di bawah).

Mode 2 — Rotasi konten

Aktifkan Gunakan rotasi untuk menentukan beberapa varian (lihat bagian rotasi khusus).

Mode 3 — Rantai pesan

Aktifkan Rantai pesan untuk beralih ke skenario multi-langkah (lihat bagian rantai khusus).

Bidang pesan

Mendukung teks multiline, pemformatan HTML, dan variabel dinamis:

VariabelHasil
{date}Tanggal saat ini (YYYY-MM-DD)
{time}Waktu saat ini (HH:MM)
{datetime}Tanggal dan waktu
{day}Hari dalam seminggu
{month}Nama bulan
{random:1000}Bilangan bulat acak 0–1000
{random:1-100}Bilangan bulat acak dalam rentang
{random:red|green|blue}Pilihan acak
{date:%H:%M}Format strftime khusus

Dalam kampanye pelanggan (DM), variabel pengguna ini juga tersedia:

  • {name} — nama lengkap
  • {first_name}, {last_name} — bagian dari nama
  • {username} — @username jika ada
Penghitung karakter

Di bawah textarea aplikasi menampilkan jumlah karakter saat ini, sehingga Anda dapat melihat seberapa dekat Anda dengan batas 4096 karakter Telegram.

Media

Klik Tambah file untuk melampirkan foto, video, atau dokumen. Beberapa file (hingga 10) dikirim sebagai album Telegram.

  • File dicantumkan dengan nama dasarnya dan tombol hapus saat hover
  • Semua jenis file yang diterima Telegram: JPG, PNG, MP4, MOV, ZIP, PDF, dll.
  • Media diunggah per pesan — tidak ada masalah batas laju di luar penundaan pengiriman standar

Teruskan dari Pesan Tersimpan

Alih-alih menulis teks, Anda dapat meneruskan pesan tersimpan yang ada (atau seluruh album):

1 Aktifkan "Teruskan dari Pesan Tersimpan"

Bidang pesan reguler dan daftar media disembunyikan.

2 Klik "Pilih dari Tersimpan"

Pemilih terbuka dengan pesan tersimpan Anda. Gunakan pencarian untuk memfilter berdasarkan teks atau jenis media (foto/video/dokumen/teks).

3 Klik pesan

ID-nya ditempatkan di bidang. Saat iklan berjalan, aplikasi menyelesaikan album lengkap (jika itu album) dan meneruskannya apa adanya.

Konten yang diteruskan tidak dipersonalisasi

Variabel seperti {name} tidak berfungsi dalam pesan yang diteruskan — pesan disalin verbatim. Gunakan mode ini untuk pengumuman siaran, bukan penjangkauan yang dipersonalisasi.

Pratinjau dan Kirim uji

Di bagian bawah editor:

  • Pratinjau — menunjukkan pesan seperti yang akan terlihat di Telegram (dengan substitusi variabel tanggal/waktu)
  • Kirim uji — mengirim pesan sekali ke penerima pertama yang dipilih. Gunakan ini sebelum meluncurkan kampanye panjang.

Rotasi konten v4.0

Tentukan beberapa varian teks dan media. Setiap penerima mendapatkan yang berbeda — secara dramatis mengurangi deteksi pola spam.

Mengapa menggunakan rotasi?

Sistem anti-spam Telegram menandai pesan identik yang dikirim berulang kali. Ketika konten yang sama dikirim ke ratusan penerima, akun dapat dibatasi. Dengan rotasi, setiap pesan adalah kombinasi teks + media yang unik.

Mengaktifkan rotasi

1 Centang "Gunakan rotasi" di tab Konten

Bidang pesan tunggal digantikan oleh daftar varian.

2 Varian pertama sudah terisi sebelumnya

Apa pun yang ada di bidang pesan tunggal menjadi teks dan media varian #1.

3 Tambahkan varian

Klik Tambah varian. Isi teks yang berbeda dan/atau lampirkan media yang berbeda.

Aturan pemasangan

Teks + media selalu berjalan bersamaan

Teks varian #3 selalu dikirim dengan media varian #3. Ini menjaga varian tetap koheren — tidak ada kombinasi gambar-teks yang tidak cocok.

Mode rotasi

ModePerilaku
AcakUntuk setiap penerima, varian acak dipilih. Direkomendasikan untuk pengiriman yang paling tidak berpola.
SiklusVarian digunakan secara berurutan: 1, 2, 3, 1, 2, 3…

Media per varian

Setiap varian memiliki daftar medianya sendiri. Klik Tambah file di bawah varian mana pun untuk melampirkan media khusus untuk varian itu. Jika varian tidak memiliki media, maka dikirim sebagai pesan teks saja.

Menggunakan rotasi di dalam rantai

Rotasi juga berfungsi di dalam rantai — setiap langkah dapat memiliki tombol Gunakan rotasi sendiri. Langkah 1 mungkin mengirim 3 varian teks secara acak, Langkah 2 mungkin tidak memiliki rotasi, Langkah 3 mungkin bersiklus melalui 5 gambar berbeda. Penghitung setiap langkah independen.

Direkomendasikan: 3–5 varian

Dua varian masih menghasilkan pola berulang. Lima atau lebih benar-benar memvariasikan aliran pesan. Gabungkan dengan media bergilir untuk perlindungan terkuat.

Rantai pesan v4.0

Ubah satu iklan menjadi dialog multi-langkah — 2 hingga 5 pesan dikirim satu demi satu dengan jeda yang dapat dikonfigurasi.

Mengaktifkan rantai

1 Centang "Rantai pesan" di tab Konten

UI pesan tunggal dan rotasi hilang. Sebagai gantinya Anda mendapatkan pembangun langkah.

2 Migrasikan konten yang ada (opsional)

Jika Anda memiliki pesan yang ditulis dalam mode tunggal, aplikasi secara otomatis mengubahnya menjadi langkah pertama.

Setiap langkah memiliki

  • Teks — badan pesan terpisah
  • Media — lampiran terpisah (foto, video, dokumen)
  • Rotasi opsional — tombol per langkah untuk menentukan beberapa varian dalam langkah
  • Penundaan setelah — berapa detik menunggu sebelum mengirim langkah berikutnya (hanya muncul di antara langkah, bukan setelah yang terakhir)

Mengelola langkah

  • Tambah langkah — tambahkan langkah kosong baru di akhir
  • Panah ↑ / ↓ — atur ulang langkah (dinonaktifkan pada yang pertama/terakhir)
  • X — hapus langkah (minimal satu langkah harus tetap ada)

Rotasi per langkah

Di dalam langkah mana pun, aktifkan Gunakan rotasi untuk menentukan beberapa varian teks+media untuk langkah itu. Mode rotasi (acak/siklus) terpisah per langkah.

Bagaimana penundaan dan interval berinteraksi

Penundaan setelah memicu di antara langkah untuk penerima yang sama. Penundaan antar pesan milik iklan memicu di antara penerima. Jadi rantai 3 langkah ke 10 penerima ≈ (3 kirim + 2 jeda internal) × 10 + 9 penundaan antar penerima.

Pratinjau timeline

Klik Pratinjau untuk melihat seluruh rantai sebagai timeline bernomor dengan gelembung konten per langkah dan indikator jeda di antaranya.

Contoh dunia nyata — Urutan pemanasan

Untuk kampanye pelanggan, rantai 3 langkah bekerja seperti ini:

LangkahKontenPenundaan setelah
1"Hai {first_name}! Saya perhatikan Anda tertarik pada pemasaran — pertanyaan cepat?"45 detik
2"Kami menjalankan komunitas privat kecil di mana kami berbagi kasus nyata."60 detik
3"Mau tautannya? Gratis."—
Bisakah saya merantai lebih dari 5 pesan?

Ya — tidak ada batas keras, tetapi 2–5 langkah adalah titik manisnya. Rantai yang lebih panjang mulai terasa seperti spam.

Apakah langkah berhenti jika salah satu gagal?

Jika suatu langkah tidak dapat dikirim (pengguna memblokir, tidak ada izin, dll.), langkah selanjutnya untuk penerima itu dilewati, dan kampanye beralih ke penerima berikutnya. Jika PEER_FLOOD atau aturan berhenti otomatis terpicu, seluruh kampanye berhenti.

Jadwal

Kontrol kapan dan seberapa sering iklan berjalan. Dua mode penjadwalan, plus jendela waktu, hari-dalam-seminggu, dan perlindungan berhenti otomatis.

Mode jadwal

Interval
Iklan berjalan sekali, lalu menunggu N menit, berjalan lagi, dan seterusnya. Sederhana dan dapat diprediksi. Direkomendasikan: 180+ menit.
Waktu tetap
Iklan berjalan pada waktu tertentu dalam sehari (mis. 09:00 dan 18:00). Sempurna untuk pengumuman harian.

Mode interval

Atur interval dalam menit. Rekomendasi minimum: 180 untuk saluran, 60 batas mutlak. Di bawah itu Telegram mulai merespons dengan FloodWait.

Mode waktu tetap

Tambahkan satu atau lebih waktu dalam sehari (HH:MM). Aplikasi menghitung jadwal berikutnya — jika suatu hari semua waktunya sudah lewat, waktu pertama hari berikutnya digunakan.

Filter hari dalam seminggu berlaku lebih dulu

Jika suatu waktu jatuh pada hari yang tidak Anda centang, aplikasi melewati ke hari yang valid berikutnya secara otomatis.

Jendela waktu

Batasi pengiriman ke jam tertentu — mis. hanya selama jam kerja. Jendela semalam juga berfungsi (22:00 → 06:00).

Penggantian jendela waktu global

Jika Anda mengaktifkan Jendela waktu global di Pengaturan, itu menggantikan pengaturan per iklan. Petunjuk ungu muncul di editor iklan — jendela per iklan dinonaktifkan.

Hari dalam seminggu

Tujuh kotak centang: Senin hingga Minggu. Hanya hari yang dicentang yang diizinkan untuk mengirim. Jika aplikasi berjalan tetapi hari saat ini tidak dicentang, aplikasi mencatat "hari salah" dan menunggu.

Penundaan antar pesan

Rentang acak dalam detik. Untuk setiap penerima, penundaan diambil secara seragam antara min dan maks.

SkenarioDirekomendasikan
Saluran kecil (< 20 penerima)10–30 detik
Daftar sedang (20–100)30–120 detik
Daftar besar (100+)60–300 detik

Perlindungan berhenti otomatis

AturanPerilaku
Berhenti setelah N kesalahan berturut-turutJika N kesalahan terjadi berturut-turut (penghitung diatur ulang pada pengiriman sukses apa pun), kampanye berhenti. Direkomendasikan: 5–10.
Berhenti setelah N FloodWait / jamJika N FloodWait terjadi dalam satu jam bergulir, kampanye berhenti. Direkomendasikan: 3–5.
PEER_FLOOD (selalu aktif)Penghentian segera — tidak dapat dinonaktifkan. Sinyal anti-spam terkeras Telegram.
0 = dinonaktifkan

Secara default, kedua aturan berhenti otomatis adalah 0. Atur untuk kampanye produksi — tidak ada alasan baik untuk tidak melakukannya.

Apa yang terjadi saat berhenti otomatis terpicu

  1. Kampanye berhenti segera
  2. Entri log muncul: "Berhenti otomatis: 5 kesalahan berturut-turut. Iklan 'X' dihentikan."
  3. Jika notifikasi Telegram diaktifkan, Anda menerima laporan di Pesan Tersimpan
  4. Iklan tetap ada di daftar Anda — perbaiki masalah dan mulai ulang

Topik forum

Jika grup yang dipilih adalah forum Telegram (dengan topik), Anda dapat mengirim ke topik tertentu — atau ke obrolan utama.

Apa itu grup forum?

Supergrup di mana admin mengaktifkan "Topics" — pesan diatur ke utas terpisah. Grup reguler tidak memiliki topik.

Mengonfigurasi topik

1 Tambahkan grup di tab Penerima

Grup forum apa pun yang Anda pilih akan menampilkan tombol topik.

2 Klik "Konfigurasi topik"

Dialog terbuka dengan pohon grup dan topiknya. Topik dimuat dari Telegram sesuai permintaan (di-cache setelah pengambilan pertama).

3 Centang topik yang Anda inginkan

Setiap grup memiliki daftar kotak centangnya sendiri. Obrolan utama muncul sebagai item pertama.

4 Simpan

Pilihan Anda disimpan per iklan dan per grup.

Apa yang terjadi saat mengirim

Untuk setiap grup penerima yang merupakan forum, aplikasi mengirim pesan terpisah ke setiap topik yang dicentang. Jika Anda mencentang 3 topik dalam satu grup dan grup yang sama juga dipilih untuk iklan lain, topik hanya berlaku untuk iklan ini.

Menghitung penerima

Jumlah "total penerima" dalam detail iklan mencakup pemisahan topik. Satu grup dengan 3 topik dipilih dihitung sebagai 3 penerima.

Obrolan utama

Selalu tersedia. Jika Anda hanya mencentang obrolan utama — tanpa topik — pesan hanya masuk ke feed umum.

Kampanye pelanggan (DM)

Kumpulkan peserta dari grup atau saluran mana pun, lalu kirimkan mereka pesan langsung yang dipersonalisasi.

Baca ini dulu

DM massal adalah bentuk otomatisasi Telegram yang paling agresif. Telegram memblokir ini lebih cepat daripada apa pun. Selalu mulai dengan batas kecil (5–10 pesan per hari) dan jangan pernah menonaktifkan berhenti otomatis. Gunakan akun khusus yang tidak penting untuk pengujian pertama.

Cara kerjanya

  1. Anda menentukan sumber — grup atau saluran yang Anda miliki aksesnya
  2. Aplikasi mengambil daftar peserta (dengan filter)
  3. Aplikasi mengirim setiap peserta DM yang dipersonalisasi
  4. Kemajuan dilacak — pengguna yang sama tidak pernah menerima pesan dua kali

Membuat kampanye

1 Atur sumbernya

Salah satu dari:

  • @username — jika grup memiliki nama pengguna publik
  • t.me/... — tautan undangan lengkap
  • Nama dialog yang tepat — jika grup bersifat privat
2 Tulis pesannya

Mendukung variabel pengguna: {name}, {first_name}, {last_name}, {username}.

3 Konfigurasikan filter
  • Kecualikan bot — aktif secara default, sangat direkomendasikan
  • Kecualikan pengguna tanpa nama pengguna — nonaktif secara default
  • Hanya aktif selama N hari — filter berdasarkan tanggal terakhir dilihat, 0 = tanpa filter
4 Atur kecepatan & batas
  • Penundaan antar pesan — min dan maks detik. Direkomendasikan: 30–60 menit, hingga 300 untuk keamanan
  • Batas harian per lintasan — berapa banyak pesan yang akan dikirim dalam satu kali jalan. Mulai dengan 5–10
  • Batas pengambilan — berapa banyak peserta yang akan dimuat sekaligus
5 Atur interval

Seberapa sering kampanye berjalan satu lintasan. Untuk kampanye DM, 1440 menit (sekali sehari) adalah yang paling aman.

Pratinjau peserta

Klik Pratinjau pada kampanye mana pun. Jendela terbuka dengan daftar pengguna yang akan ditargetkan, menampilkan nama, @username, dan ID pengguna. Verifikasi filter bekerja seperti yang diharapkan sebelum meluncurkan.

Menjalankan kampanye

Klik Mulai. Lintasan pertama berjalan segera. Statistik langsung muncul di panel info dan diperbarui setiap detik:

  • Terkirim — pesan terkirim
  • Dilewati — pengguna tanpa nama pengguna, dilindungi privasi, dinonaktifkan, bot
  • Gagal — kesalahan (biasanya privasi atau flood)
  • Dilacak — total pengguna berbeda yang telah menerima pesan

Kondisi lewati

Pengguna dilewati secara diam-diam (dihitung dalam Dilewati) ketika Telegram mengembalikan:

  • Pembatasan privasi — "pengguna tidak menerima pesan dari orang asing"
  • Bukan kontak timbal balik
  • Akun dinonaktifkan
  • Anda diblokir oleh pengguna

Atur ulang kemajuan

Klik Atur ulang untuk menghapus daftar "sudah dikirim". Gunakan ini jika Anda ingin mengirim kampanye yang sama lagi — tetapi hanya setelah mengubah pesan secara bermakna.

Alasan penyelesaian

AlasanArti
all_doneSemua peserta yang diambil telah diproses
manualAnda menghentikan kampanye
peer_floodTelegram menandai akun — berhenti keras
empty_sourceGrup/saluran sumber tidak memiliki peserta yang cocok dengan filter Anda
Volume harian yang aman

Tidak ada angka universal — itu tergantung pada usia akun, aktivitas, dan suasana anti-spam Telegram hari itu. Mulai dengan 5–10 pesan per hari untuk minggu pertama. Jangan pernah melebihi 50 tanpa alasan yang sangat baik.

Penggabung grup

Bergabung secara massal ke grup dan saluran dari daftar tautan dengan penundaan yang dapat dikonfigurasi.

Menyiapkan tautan

Tempel tautan di textarea — satu per baris. Format yang didukung:

  • https://t.me/joinchat/XXXXX — tautan undangan privat
  • t.me/username — grup atau saluran publik
  • @username — publik
  • +invite_hash — undangan privat

Penundaan antar bergabung

Direkomendasikan: 10–30 detik. Nilai yang lebih rendah menyebabkan kesalahan FloodWait dengan sangat cepat. Default 5 detik agresif — Anda ingin setidaknya 15.

Menjalankan penggabung

  1. Tempel tautan atau klik Muat dari file untuk mengimpor .txt
  2. Atur penundaan
  3. Klik Mulai bergabung

Aplikasi memproses tautan satu per satu:

  • Bilah kemajuan menunjukkan posisi saat ini
  • Setiap upaya dicatat di Log Peristiwa
  • Daftar hasil langsung muncul di bawah dengan indikator ✓ / ✗
  • Toast akhir menunjukkan: N berhasil, M gagal

Menyimpan daftar Anda

Daftar tautan Anda secara otomatis disimpan di localStorage antar sesi. Klik Simpan ke file untuk mengekspornya sebagai .txt untuk cadangan.

Hati-hati dengan bergabung massal

Bergabung ke 100+ grup dalam sehari pada akun baru hampir selalu menghasilkan pemblokiran sementara. Mulai dengan 5–10 per hari, tersebar di beberapa akun. Tingkatkan hanya jika akun tidak menunjukkan tanda-tanda stres.

Apa yang terjadi jika aplikasi ditutup di tengah bergabung?

Penggabung berhenti. Saat restart, daftar tautan dipertahankan, tetapi status yang berjalan tidak. Anda perlu mengklik Mulai lagi — aplikasi tidak melewati obrolan yang sudah bergabung secara otomatis. Jika ragu, periksa log untuk melihat tautan mana yang berhasil.

Kampanye story

Secara otomatis menerbitkan story Telegram sesuai jadwal. Memerlukan Telegram Premium pada akun.

Premium diperlukan

Story adalah fitur Telegram Premium. Jika akun Anda tidak memiliki Premium, aplikasi akan menolak memulai kampanye dengan kesalahan yang jelas.

Membuat kampanye story

1 Klik "Kampanye story baru"

Isi:

  • Nama — label internal
  • File media — satu foto atau video (JPEG/PNG untuk foto, MP4/MOV untuk video)
  • Keterangan — teks opsional pada story
  • Interval — seberapa sering menerbitkan. Untuk story harian, gunakan 1440 menit

Menjalankan kampanye

Pilih kampanye, klik Mulai. Aplikasi:

  • Memeriksa bahwa akun memiliki Premium
  • Memverifikasi file media ada
  • Menerbitkan story pertama segera
  • Menjadwalkan story berikutnya pada interval yang ditentukan

Persyaratan media

TipeFormatBatas
FotoJPG, PNG, WEBP, GIF, BMPHingga 5 MB
VideoMP4, MOV, AVI, MKV, WEBMHingga 60 detik, hingga 5 GB
Apakah saya memerlukan Premium di setiap akun?

Ya — story bersifat per akun. Jika akun A memiliki Premium dan akun B tidak, hanya A yang dapat menerbitkan story.

Apa yang terjadi pada FloodWait?

Aplikasi berhenti sejenak untuk waktu yang diperlukan, mencatat peristiwa ke Log Peristiwa dan Statistik, lalu melanjutkan secara otomatis.

Bisakah saya menjadwalkan story untuk waktu tertentu?

Belum — penjadwal hanya interval untuk story. Opsi waktu tetap direncanakan untuk AutoPoster Cloud.

Balasan otomatis Enterprise

Secara otomatis membalas pesan pribadi yang masuk berdasarkan pencocokan kata kunci. Hanya paket Enterprise.

Fitur khusus Enterprise

Pada Standard atau uji coba, bagian Balasan otomatis menampilkan status terkunci dengan tautan peningkatan. Editor aturan, pengujian, dan eksekusi apa pun memerlukan Enterprise.

Apa fungsinya

Aplikasi mengawasi semua pesan pribadi yang masuk pada akun saat ini. Ketika pesan cocok dengan kondisi aturan, tindakan yang dikonfigurasi terpicu.

Membuat aturan

1 Klik "Aturan baru"

Isi:

  • Nama — label internal untuk aturan
  • Diaktifkan — tombol hidup/mati global
  • Tipe pencocokan — berisi, sama persis, regex, atau apa pun
  • Kata kunci — satu per baris
  • Tindakan — balas, lewati diam-diam, atau beri tahu pemilik
  • Teks balasan — mendukung {first_name}, {username}, dll.
  • Penundaan balasan — detik untuk menunggu sebelum mengirim (terasa lebih manusiawi)
  • Waktu tunggu — detik minimum antara balasan ke pengguna yang sama
  • Hanya obrolan pribadi — kontrol cakupan

Tipe pencocokan

TipePerilaku
BerisiKata kunci apa pun muncul di mana saja dalam pesan (tidak peka huruf besar-kecil)
Sama persisSeluruh pesan sama persis dengan kata kunci
RegexPencocokan regex gaya Python — paling kuat
Apa punTerpicu pada pesan masuk apa pun. Bidang kata kunci disembunyikan.

Tindakan

TindakanPerilaku
BalasKirim teks balasan yang dikonfigurasi ke pengirim
Lewati diam-diamCocokkan pesan tetapi tidak melakukan apa pun (berguna untuk mencatat pola)
Beri tahu pemilikTeruskan pesan ke Pesan Tersimpan Anda dengan nama aturan

Menguji aturan

Klik Tes pada aturan balasan yang diaktifkan. Aplikasi mengirim teks balasan ke Pesan Tersimpan Anda sendiri — berguna untuk melihat dengan tepat bagaimana itu dirender dengan substitusi variabel.

Bagaimana aturan terpicu

  • Pesan masuk diurai
  • Aturan diperiksa secara berurutan; kecocokan pertama menang
  • Pemeriksaan waktu tunggu terjadi — pengguna yang sama tidak dapat dibalas otomatis lebih sering daripada waktu tunggu
  • Jika tindakan adalah balas dan penundaan diatur, aplikasi menunggu beberapa detik lalu mengirim
Dukungan grup forum

Jika pesan masuk berasal dari topik grup forum, balasan dikirim kembali ke topik yang sama — bukan ke obrolan umum. Ini otomatis.

Apakah ini membalas bot?

Tidak — pesan bot diabaikan. Pesan sendiri juga diabaikan.

Apakah waktu tunggu bertahan antar restart?

Waktu tunggu hanya disimpan di memori. Memulai ulang aplikasi mengatur ulangnya. Jika ini penting bagi Anda, biarkan aplikasi tetap berjalan.

Bisakah saya menggunakan variabel dalam balasan?

Ya — {first_name}, {last_name}, {username}, dan {name} semuanya diganti dengan info pengirim.

Statistik v4.0

Dasbor analitik lengkap: aktivitas berdasarkan hari dan jam, target teratas, kesalahan teratas, peristiwa terkini dengan ekspor CSV.

Filter

Periode
24 jam terakhir / 7 hari / 30 hari / Sepanjang waktu
Akun
Semua akun atau satu akun tertentu
Kampanye
Kampanye apa pun yang telah menghasilkan peristiwa

Kartu KPI

  • Terkirim — pengiriman sukses (hijau)
  • Kesalahan — kesalahan keras (merah)
  • Flood — peristiwa FloodWait (kuning)
  • Tingkat — terkirim / (terkirim + kesalahan + flood) sebagai persentase
  • Tampilan — total tampilan untuk pesan saluran yang dilacak

Grafik

Aktivitas per hari — grafik batang terkirim per hari, dengan garis kesalahan overlay.

Aktivitas per jam — grafik batang terkirim per jam dalam sehari. Berguna untuk menemukan jendela pengiriman terbaik Anda.

Target teratas

10 penerima paling sering digunakan teratas dengan jumlah terkirim, jumlah kesalahan, dan — untuk saluran — lencana total tampilan.

Kesalahan teratas

10 jenis kesalahan teratas berdasarkan frekuensi. Berguna untuk memahami masalah sistematis:

  • not_found — penerima tidak ada lagi
  • privacy — pembatasan privasi pengguna
  • peer_flood — sinyal berhenti keras dari Telegram
  • flood_wait — batas laju tercapai
  • Dan lainnya, tergantung pada kesalahan spesifik yang dikembalikan

Peristiwa terkini

30 peristiwa terakhir dengan stempel waktu, nama kampanye, target, dan pil status. Difilter oleh periode/akun/kampanye yang sama dengan KPI.

Pelacakan tampilan saluran

Untuk saluran siaran di mana akun Anda adalah admin, aplikasi mengambil jumlah tampilan secara otomatis di latar belakang. Diperbarui setiap 10 menit untuk pesan hingga 7 hari.

Ekspor CSV

Klik Ekspor CSV untuk menyimpan semua peristiwa yang cocok dengan filter saat ini ke file CSV (hingga 100.000 baris). Kolom:

timestamp;account_id;campaign_name;campaign_type;target_name;target_kind;status;error_kind;views

Retensi

Statistik disimpan secara lokal di SQLite. Peristiwa yang lebih lama dari 90 hari secara otomatis dihapus oleh tugas latar belakang harian. Ubah retensi di konfigurasi jika perlu.

Log peristiwa

Setiap tindakan yang diambil aplikasi dicatat di sini. Gunakan untuk memantau kampanye dan mendiagnosis masalah.

Jenis peristiwa

  • INFO (biru) — peristiwa rutin: surat dimulai, pesan terkirim, kampanye selesai
  • WARNING (oranye) — potensi masalah: interval kecil, jaringan lambat, pengguna dilewati
  • ERROR (merah) — kegagalan sebenarnya: entitas tidak ditemukan, tidak ada izin, PEER_FLOOD

Filter

FilterEfek
TingkatTampilkan hanya INFO / WARNING / ERROR / SEMUA
AkunFilter ke peristiwa akun tertentu
PencarianPencarian teks bebas di badan pesan (debounce 200 ms)
Mode senyapSembunyikan pesan rutin seperti pengiriman individual — hanya tampilkan hal penting. Diaktifkan secara default; tombol dipertahankan.

Penghitung

Di atas badan log Anda melihat penghitung langsung:

  • Total — semua peristiwa yang terlihat
  • Terkirim — pengiriman sukses
  • Peringatan — peringatan
  • Kesalahan — kesalahan

Mengekspor

  • Ekspor TXT — teks biasa, satu peristiwa per baris
  • Ekspor CSV — terstruktur dengan stempel waktu, tingkat, jenis, tanda senyap, akun, pesan. UTF-8 BOM untuk Excel.

Salin semua

Menyalin semua peristiwa yang difilter ke clipboard dalam format TXT yang sama. Berguna untuk menempel ke tiket dukungan.

Menghapus

Klik Hapus untuk menghapus buffer yang terlihat dan daftar dalam memori. Log file di disk (data/logs/app.log) tidak terpengaruh.

Tips untuk pemecahan masalah

Jika sesuatu tidak berfungsi, nonaktifkan Mode senyap untuk melihat setiap peristiwa individual. Log lengkap akan menunjukkan dengan tepat apa yang terjadi di tingkat pesan.

Pengaturan

Semua konfigurasi global di satu halaman.

Umum

PengaturanDeskripsi
Bahasa25 bahasa antarmuka. Perubahan memicu muat ulang aplikasi penuh.
TemaSistem / Gelap / Terang. Berlaku seketika tanpa muat ulang.

Proxy global

Proxy tunggal yang digunakan oleh semua akun yang tidak memiliki proxy sendiri. Bidang: tipe (SOCKS5 / SOCKS4 / HTTP), host, port, nama pengguna dan kata sandi opsional.

  • Simpan — menulis ke konfigurasi
  • Tes — memeriksa IP eksternal Anda melalui proxy ini via api.ipify.org. Hasil muncul sebagai toast.
  • Hapus — mengatur ulang semua bidang dan menghapus proxy global

Jendela waktu global

Jendela pengiriman tunggal yang diterapkan ke setiap iklan dan kampanye di seluruh akun. Saat diaktifkan, ini menggantikan pengaturan per iklan.

Mulai otomatis

  • Mulai otomatis semua iklan setelah otorisasi — ketika akun diotorisasi, setiap iklan yang dimilikinya dimulai segera

Pemeriksaan kesehatan sesi

Dibahas secara rinci di bagian Pemeriksaan Kesehatan Sesi:

  • Aktifkan saat memulai
  • Interval pemeriksaan otomatis (menit, 0 = dinonaktifkan)
  • Otorisasi ulang otomatis sesi mati

Notifikasi Telegram

Lihat bagian khusus di bawah ini.

Lisensi

Menampilkan paket saat ini, hari tersisa, tanggal berakhir. Tombol untuk membuka kembali dialog aktivasi.

Data & log

  • Statistik penyimpanan — total ukuran data, penghitung akun, penerima, kampanye
  • Buka folder log — membuka data/logs/ di pengelola file Anda
  • Ekspor cadangan — profil lengkap ke ZIP
  • Impor cadangan — pulihkan dari ZIP dengan dialog pratinjau
  • Periksa pembaruan — pemeriksaan pembaruan manual
  • Debug — menampilkan dump JSON dari status subsistem pembaruan (berguna untuk dukungan)

Zona bahaya

  • Atur ulang pengaturan — menghapus proxy, jendela waktu, mulai otomatis, pemeriksaan sesi, dan pengaturan notifikasi kembali ke default
  • Hapus akun — menghapus setiap akun dan sesinya. Dialog konfirmasi terlebih dahulu.

Notifikasi Telegram

Dapatkan laporan kampanye langsung di Telegram — ke Pesan Tersimpan Anda atau obrolan apa pun.

Mengaktifkan

1 Centang "Aktifkan notifikasi"

Di Pengaturan, di bawah kartu notifikasi Telegram.

2 Pilih target
  • Pesan Tersimpan — paling aman, paling sederhana
  • Obrolan apa pun — membuka pemilih dengan semua dialog Anda, termasuk pencarian
3 Pilih peristiwa
  • Mulai — nonaktif secara default
  • Selesai — aktif secara default, termasuk statistik
  • Berhenti — aktif secara default, termasuk manual dan berhenti otomatis
  • Kesalahan — aktif secara default, termasuk PEER_FLOOD, flood, kesalahan berturut-turut

Pengujian

Klik Kirim notifikasi uji. Ini menggunakan akun otorisasi pertama dan mengirim pesan uji ke target pilihan Anda. Jika tidak ada akun yang diotorisasi, Anda akan mendapatkan kesalahan yang jelas.

Peristiwa yang dikirim

Setiap notifikasi membawa ringkasan yang diformat. Laporan penyelesaian kampanye tipikal terlihat seperti:

✅ Surat selesai

📣 Kampanye: Promo
📤 Terkirim: 45
❌ Kesalahan: 2

⏱ Durasi: 12 mnt
🕐 14:30 — 14:42
Notifikasi tidak tiba — apa yang harus diperiksa

(1) Tanda aktif menyala, (2) setidaknya satu peristiwa dicentang, (3) akun diotorisasi, (4) jika Anda memilih obrolan tertentu, akun Anda dapat menulis ke sana (beberapa saluran tidak mengizinkan pesan dari non-admin).

Apakah notifikasi dikirim dari akun saya?

Ya. Setiap notifikasi melalui akun saat ini. Laporan muncul di Pesan Tersimpan akun yang sama (atau obrolan yang dipilih).

Pencadangan profil lengkap v4.0

Satu klik untuk mengekspor semuanya: konfigurasi, database, sesi, iklan, kampanye, dan statistik sebagai satu file ZIP.

Apa yang disertakan

  • config.json — semua pengaturan, cache kunci lisensi
  • autoposter.db — akun, penerima, iklan, story, pelanggan, templat, aturan balasan otomatis, statistik
  • sessions/*.session — file sesi Telegram (opsional, lihat di bawah)
  • templates/ — data folder templat apa pun

Apa yang dikecualikan

  • logs/ — file log
  • exports/ — file CSV yang diekspor
  • backups/ — cadangan lama
  • File sementara SQLite WAL/SHM

Mengekspor

1 Pengaturan → Ekspor cadangan

Dialog muncul dengan kotak centang opsional "sertakan sesi".

2 Pilih apakah akan menyertakan sesi
  • Dicentang — pemulihan penuh memungkinkan, tidak perlu otorisasi ulang. Sesi bersifat sensitif — simpan ZIP dengan aman.
  • Tidak dicentang — aman untuk dibagikan. Saat memulihkan, Anda perlu mengotorisasi ulang setiap akun dengan QR.
3 Lokasi penyimpanan

Nama file default: tgautoposter_backup_20261016_143052.zip. Kemajuan dicatat di Log Peristiwa.

Mengimpor

1 Pengaturan → Impor cadangan

Pemilih file terbuka. Pilih ZIP.

2 Pratinjau manifes

Dialog menampilkan tanggal pembuatan cadangan, jumlah file, dan apakah itu berisi sesi.

3 Konfirmasi

Aplikasi membuat cadangan keamanan otomatis dari status Anda saat ini (data/backups/before_import_*.zip), lalu memulihkan ZIP di atasnya.

4 Mulai ulang

Dialog konfirmasi menawarkan untuk memuat ulang aplikasi segera.

Perlakukan ZIP cadangan seperti kata sandi

Jika arsip menyertakan sesi, siapa pun yang memiliki ZIP dapat masuk ke akun Telegram Anda. Simpan terenkripsi (7-Zip, VeraCrypt) atau simpan di media yang aman secara fisik.

Cadangan keamanan otomatis

Sebelum impor apa pun, aplikasi membuat cadangan penuh dari profil Anda saat ini. Jika ada yang salah, Anda dapat memulihkannya dari data/backups/before_import_*.zip.

Pembaruan

Aplikasi memeriksa versi baru saat memulai dan menawarkan jendela changelog ketika tersedia.

Pemeriksaan otomatis

2,5 detik setelah memulai, permintaan kecil dikirim ke server pembaruan. Jika versi yang lebih baru ada, dialog changelog muncul dengan item yang dikategorikan (fitur, perbaikan, peningkatan, keamanan).

Dialog pembaruan

  • Unduh — membuka halaman unduhan di browser Anda
  • Ingatkan nanti — dialog ditutup, akan muncul lagi pada peluncuran berikutnya
  • Lewati versi ini — jangan pernah tampilkan versi spesifik ini lagi (jika versi yang lebih baru keluar, dialog kembali)
Pembaruan wajib

Pembaruan kritis (keamanan atau kompatibilitas) muncul tanpa tombol "Ingatkan nanti" / "Lewati" — Anda perlu mengunduh dan menginstalnya untuk melanjutkan.

Pemeriksaan manual

Dua cara:

  • Ikon unduhan di topbar
  • Pengaturan → Data & log → Periksa pembaruan

Info debug

Pengaturan → Debug menampilkan dump JSON dengan versi Anda saat ini, respons server, dan apakah pembaruan akan terpicu. Berguna saat membuka tiket dukungan.

Apakah pembaruan menginstal sendiri?

Belum. Aplikasi membuka halaman unduhan — Anda menginstal versi baru secara manual. Pembaruan otomatis senyap direncanakan untuk AutoPoster Cloud.

Apakah saya akan kehilangan data saat memperbarui?

Tidak. Folder data/ Anda tidak tersentuh. Cukup ganti EXE / DMG.

Bagaimana jika server pembaruan mati?

Tidak ada yang buruk terjadi. Pemeriksaan gagal secara diam-diam dan aplikasi berlanjut. Tanpa popup, tanpa kesalahan.

Data & folder

Semuanya disimpan dalam satu folder. Pahami itu, dan Anda memahami aplikasinya.

Lokasi folder

PlatformJalur
Windows<folder dengan EXE>/data/
macOS~/Library/Application Support/TG AutoPoster Pro/

Apa yang ada di dalamnya

File / FolderTujuan
config.jsonSemua pengaturan, cache lisensi, konfigurasi session_check, notifikasi, proxy global
autoposter.dbDatabase SQLite — akun, penerima, grup, iklan, story, pelanggan, templat, aturan balasan otomatis, peristiwa statistik
sessions/Sesi Telegram terenkripsi, satu per akun. Jangan pernah membagikan file ini.
logs/app.log (bergilir, 5 MB × 3 file) dan crash.log (hanya dibuat saat crash)
backups/Cadangan otomatis: snapshot config.json dan ZIP pra-impor
exports/Folder penyimpanan default untuk ekspor CSV / TXT / ZIP
.migrated_v4File penanda — menunjukkan migrasi data lama berjalan

Cadangan otomatis

Setiap kali Anda menyimpan pengaturan atau kampanye, config.json sebelumnya disalin ke backups/ dengan stempel waktu. Hanya 5 yang terbaru disimpan.

Memulihkan cadangan config secara manual

  1. Tutup aplikasi
  2. Buka data/backups/ dan temukan salinan yang Anda inginkan
  3. Ganti namanya menjadi config.json dan ganti yang saat ini
  4. Mulai ulang aplikasi
Sebelum perubahan besar — cadangkan

Sebelum beralih akun, menginstal ulang, atau pindah ke komputer baru — ekspor ZIP profil lengkap atau salin seluruh folder data/ ke tempat yang aman.

Bermigrasi ke komputer baru

  1. Salin seluruh folder data/ (atau padanan macOS) ke USB
  2. Instal aplikasi di komputer baru
  3. Tutup sekali (sehingga membuat folder data/ kosong)
  4. Ganti folder data/ baru dengan yang dari USB
  5. Luncurkan — semuanya dipertahankan

Pemecahan masalah

Jawaban cepat untuk masalah paling umum.

Aplikasi tidak diluncurkan di Windows

Kemungkinan besar Windows Defender / SmartScreen memblokirnya. Klik kanan EXE → Properties → centang Unblock di bagian bawah tab General. Jika tidak membantu — tambahkan pengecualian di Windows Security. Coba jalankan sebagai Administrator sekali.

Aplikasi tidak diluncurkan di Mac ("app is damaged")

Buka Terminal dan jalankan: xattr -cr /Applications/TelegramAutoPoster.app — ini menghapus tanda karantina. Kemudian coba luncurkan lagi.

Kode QR tidak dapat dipindai atau kode SMS tidak pernah tiba

Periksa bahwa ponsel Anda memiliki akses internet dan Telegram mutakhir. Jika proxy diatur — verifikasi dengan tombol "Tes proxy". Terkadang Telegram membatasi kode untuk sementara; tunggu 5 menit dan coba lagi.

Daftar penerima kosong setelah Segarkan

Berarti aplikasi tidak menemukan obrolan di mana Anda memiliki hak posting. Periksa: (1) akun adalah anggota beberapa grup, (2) di grup tersebut Anda dapat mengirim pesan, (3) untuk saluran, Anda memiliki hak admin dengan post_messages.

Kesalahan FloodWait pada setiap pengiriman

Telegram membatasi laju akun. Tingkatkan penundaan antar pesan (tab Jadwal). Tunggu 24–48 jam dan lanjutkan dengan volume lebih rendah. Pertimbangkan merotasi beberapa akun untuk mendistribusikan beban.

Kesalahan "Peer flood"

Peringatan anti-spam terkeras Telegram. Kampanye berhenti secara otomatis. JANGAN memulainya kembali segera — tunggu 24–48 jam. Jika berulang, akun mungkin dibatasi secara permanen.

Pemeriksaan lisensi gagal — "Kesalahan jaringan"

Internet atau ISP Anda memblokir server kami. Aplikasi memiliki masa tenggang offline hingga 30 hari — Anda dapat terus bekerja. Jika berulang di luar itu, konfigurasikan proxy di Pengaturan → Proxy global.

Status akun tiba-tiba menunjukkan "Tidak diotorisasi"

Telegram mencabut sesi. Jarang, tetapi terjadi jika Anda masuk dari terlalu banyak perangkat, mengatur ulang sesi di Telegram, atau orang lain mengakses akun. Cukup klik "Otorisasi" lagi.

Notifikasi tidak tiba di Telegram

Periksa: (1) diaktifkan di Pengaturan, (2) setidaknya satu peristiwa dicentang, (3) obrolan yang dipilih adalah salah satu yang dapat ditulis oleh akun Anda, (4) akun diotorisasi. Jika semuanya terlihat OK — periksa log Peristiwa untuk kesalahan.

Aplikasi lambat / lag dengan banyak akun

Kinerja menurun ketika Anda memiliki 30+ akun yang aktif mengirim. Coba: (1) tutup bagian yang tidak digunakan, (2) jangan menjalankan beberapa kampanye frekuensi tinggi secara bersamaan, (3) periksa penggunaan CPU/RAM di Task Manager.

Bagaimana cara melihat apa yang salah — log lengkap

Buka Log peristiwa, nonaktifkan Mode senyap, dan reproduksi masalahnya. Salin log (tombol Salin semua) dan kirimkan kepada kami di Telegram @igor_shelloff. Atau ekspor sebagai TXT.

Di mana saya bisa mendapatkan bantuan?

Hubungi kami di Telegram: @igor_shelloff — biasanya membalas dalam beberapa jam. Sertakan: apa yang Anda lakukan, apa yang terjadi, dan kutipan log yang relevan.