Dari mengunduh aplikasi hingga menjalankan rantai, kampanye DM, dan analitik. Ditulis untuk pemula total — dengan langkah konkret dan contoh nyata.
Dari nol hingga surat pertama Anda dalam waktu kurang dari 10 menit.
Akun Telegram (atau beberapa), komputer dengan Windows 10+ atau macOS 11+, dan sekitar 10 menit waktu luang.
Dapatkan penginstal dari halaman unduhan:
.exe — tidak perlu instalasi.dmg — seret aplikasi ke ApplicationsPada peluncuran pertama Anda akan melihat jendela aktivasi. Tempel kunci Anda dan klik Aktifkan. Jika Anda belum memiliki kunci — dapatkan uji coba gratis 3 hari.
Masuk ke my.telegram.org, buat aplikasi, dan salin api_id dan api_hash Anda. Panduan lengkap — ada di tab API Telegram.
Buka Akun → Tambah akun, isi Nama, ID API, Hash API (telepon opsional untuk QR). Kemudian klik Otorisasi dan pindai kode QR dengan ponsel Anda.
Buka Penerima → Segarkan daftar untuk menarik grup, saluran, dan kontak Telegram Anda. Atau impor dari file.
Buka Iklan → Iklan baru, tulis pesan Anda, pilih penerima, atur jadwal — dan tekan Mulai.
Aplikasi menjalankan kampanye di latar belakang dan mengirim pesan sesuai jadwal. Pantau kemajuan di halaman Iklan dan dasbor Statistik.
Aplikasi ini portabel di Windows dan seret-lepas di macOS. Tanpa dependensi, tanpa hak admin.
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.
Windows mungkin menampilkan dialog biru: "Windows protected your PC". Ini normal untuk aplikasi yang tidak ditandatangani.
Windows menandai aplikasi apa pun tanpa sertifikat penandatanganan kode berbayar (biasanya $100+/tahun). Aplikasi ini sepenuhnya aman — Anda dapat memverifikasinya di VirusTotal.
Buka TelegramAutoPoster.dmg dan seret aplikasi ke folder Applications Anda.
Klik kanan ikon aplikasi → Buka → konfirmasi Buka di dialog keamanan. Atau buka System Settings → Privacy & Security → Open Anyway.
| Platform | Jalur |
|---|---|
| Windows | <folder dengan EXE>/data/ |
| macOS | ~/Library/Application Support/TG AutoPoster Pro/ |
Klik kanan EXE → Send to → Desktop (create shortcut). Di macOS seret aplikasi ke Dock.
Setiap klien Telegram membutuhkan api_id dan api_hash — kredensial resmi gratis dari Telegram. Mendapatkannya memakan waktu sekitar 3 menit.
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.
Di browser Anda, buka https://my.telegram.org.
Masukkan nomor dalam format internasional yang dimulai dengan + — misalnya +628123456789. Telegram akan mengirim kode konfirmasi ke aplikasi Anda atau melalui SMS.
Klik API development tools di dasbor.
Isi formulir — nilainya tidak masalah sama sekali, Telegram menyimpannya hanya untuk catatan mereka. Pilih platform Desktop dan klik Create application.
Anda akan melihat dua nilai:
1234567abcdef1234567890abcdef1234567890Siapa 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.
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.
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.
Tunggu 24 jam. Ini terjadi jika Anda membuat beberapa aplikasi atau masuk/keluar terlalu sering. Batasnya akan diatur ulang secara otomatis.
Tiga paket, satu jendela aktivasi. Beralih kapan saja dengan memasukkan kunci baru.
| Paket | Akun | Ekstra utama |
|---|---|---|
| Standard — $5/bln | 1 | Kampanye DM, rantai, rotasi, analitik, pemeriksaan sesi |
| Enterprise — $10/bln | Tak terbatas | + Balasan otomatis, mulai/berhenti massal, story, monitor kesehatan, cadangan |
| Supporter — $19.99/bln | Tak terbatas | + Dukungan prioritas, kredit aplikasi, akses awal beta Cloud |
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.
Di sidebar, jika tidak ada lisensi yang aktif, Anda akan melihat kartu merah dengan tombol Aktifkan. Atau buka Pengaturan → Lisensi → Aktifkan.
Kunci terlihat seperti XXXX-XXXX-XXXX-XXXX. Tempel dan tekan Enter atau klik Aktifkan.
Setelah aktivasi berhasil, status lisensi diperbarui secara instan dan aplikasi dimuat ulang.
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.
Halaman Akun adalah basis Anda. Segala hal lainnya — penerima, iklan, kampanye — milik akun yang saat ini dipilih.
Setiap akun adalah kartu yang menampilkan:
Akun yang sedang Anda kerjakan ditandai dengan batas ungu dan lencana CURRENT di sudut kanan atas.
| Tombol | Apa fungsinya |
|---|---|
| Segarkan | Membaca ulang daftar akun dari database lokal. |
| Periksa sesi | Menjalankan pemeriksaan kesehatan sesi di semua akun (lihat bagian khusus di bawah). |
| Tambah akun | Membuka 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 | Deskripsi |
|---|---|
| Jadikan saat ini | Beralih 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 ulang | Memulai alur login QR/SMS untuk akun ini. |
| Edit | Ubah 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. |
Menghapus akan menghilangkan akun dan semua iklan/kampanyenya dari database lokal. Deotorisasi menyimpan semuanya — hanya file sesi yang dibuang.
Isi:
Klik Simpan. Dialog konfirmasi muncul menawarkan untuk mengotorisasi segera — klik Otorisasi.
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.
Dua metode. QR lebih cepat dan tidak memerlukan kolom telepon — SMS adalah cadangan.
Klik Otorisasi pada akun mana pun. Dialog terbuka dengan dua opsi:
Jika telepon kosong, opsi SMS dinonaktifkan dengan petunjuk.
Di ponsel Anda, buka Telegram → Settings → Devices → Scan QR.
Arahkan kamera ke kode di layar Anda. Jendela ditutup secara otomatis.
Jika Anda mengaktifkan 2FA, prompt kata sandi muncul berikutnya. Ketik kata sandi cloud Anda.
QR berlaku selama 180 detik. Jika kedaluwarsa, batalkan dan coba lagi — yang baru akan dibuat.
Telegram mengirim kode ke aplikasi Anda (atau melalui SMS). Dialog muncul meminta kode.
Ketik kode 5 digit dan tekan Enter. Jika 2FA diaktifkan, Anda akan mendapat prompt kata sandi tepat setelahnya.
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 data/sessions/session_<account_id>.session di samping EXE. File inilah yang membuat Anda tetap masuk — tidak perlu memindai ulang sampai Telegram mencabut sesi.
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.
Aplikasi menjaga sesi Telegram Anda tetap hidup tanpa Anda harus mengawasinya.
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.
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.
Di halaman Akun, setiap kartu mendapat titik berwarna di sebelah namanya:
Buka Pengaturan → Pemeriksaan kesehatan sesi:
| Opsi | Deskripsi |
|---|---|
| Periksa saat memulai | Jalankan pemeriksaan setiap kali aplikasi diluncurkan. Diaktifkan secara default. |
| Interval pemeriksaan otomatis | Pemeriksaan berkala dalam hitungan menit. 0 = dinonaktifkan. Disarankan: 60 atau 120. |
| Otorisasi ulang otomatis sesi mati | Ketika sesi mati ditemukan, segera buka antrean otorisasi ulang QR tanpa bertanya. |
Klik Periksa sesi di toolbar pada halaman Akun. Kemajuan terlihat melalui indikator titik; tombol menunjukkan memeriksa… X/Y.
Ketika sesi mati ditemukan, aplikasi menawarkan untuk mengotorisasi ulang satu per satu:
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.
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.
Bukan sesi mati — masalah jaringan. Aplikasi tidak mengatur ulang otorisasi dalam kasus ini, untuk mencegah logout palsu. Coba pemeriksaan lagi nanti.
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.
Indikator risiko per akun, berdasarkan aktivitas pengiriman nyata dari 24 jam terakhir.
Pada kartu akun mana pun, klik ikon perisai. Modal terbuka dengan data kesehatan untuk akun tersebut.
| Tingkat | Pemicu |
|---|---|
| 🟢 Sehat | Aktivitas rendah, tanpa flood, tanpa riwayat PEER_FLOOD |
| 🟡 Meningkat | >20 terkirim, atau ada flood, atau ≥10 kesalahan dalam 24j |
| 🔴 Kritis | Ada PEER_FLOOD, atau >100 terkirim, atau ≥3 flood dalam 24j |
Klik Rekomendasi di modal untuk daftar periksa berdasarkan data saat ini. Misalnya:
Grup, saluran, dan kontak yang tersedia untuk akun saat ini, ditata dalam tiga kolom.
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.
| Tindakan | Deskripsi |
|---|---|
| Segarkan daftar | Ambil semua grup, saluran, dan kontak dari Telegram. Memakan waktu 5–30 detik tergantung berapa banyak obrolan yang Anda miliki. |
| Filter grup | Tampilkan hanya penerima dari grup bernama tertentu. Lihat bagian Grup Penerima. |
| Kelola grup | Buat, ganti nama, dan hapus grup bernama. |
| Impor CSV | Muat penerima secara massal dari file. Mendukung CSV, XLSX, dan JSON dengan dialog pratinjau. |
| Ekspor CSV | Simpan daftar saat ini ke file CSV dengan UTF-8 BOM (ramah Excel). |
| Hapus semua | Hapus setiap penerima akun ini. Tidak dapat dibatalkan — ekspor dulu jika ragu. |
Ketika setidaknya satu item dipilih, bilah tindakan ungu muncul di atas kolom dengan:
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.
Ya. Setiap akun memiliki daftarnya sendiri, disimpan secara terpisah. Beralih akun memuat daftar yang benar secara otomatis.
Koleksi penerima bernama — seperti "Utama", "VIP", "Tes" — untuk pemilihan sekali klik di iklan.
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.
Toolbar di halaman Penerima, dekat filter grup.
Ketik nama — misalnya "Saluran utama" — dan simpan.
Baik:
Di dialog Kelola grup Anda dapat:
Gunakan dropdown filter grup di toolbar untuk melihat hanya anggota grup tertentu. Opsi:
Buka iklan apa pun → tab Penerima. Di atas tiga kolom Anda akan melihat deretan chip grup:
Klik chip untuk mengalihkan seluruh grup. Klik lagi untuk membatalkan pilihan semua di grup itu.
Jika anggota grup tidak ada dalam daftar penerima Anda saat ini (misalnya, mereka dihapus oleh Segarkan daftar), chip menjadi abu-abu dan dinonaktifkan.
Muat daftar penerima secara massal dari spreadsheet, dump JSON, atau CSV yang diekspor dari aplikasi lain.
;, , atau tab).xlsx dan .xlsm dengan dialog pemetaan kolom interaktifgroup/channel/contactDua 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, usersDua 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"]
}
Saat Anda mengimpor file .xlsx, dialog pemetaan muncul:
group/channel/contactAplikasi menebak secara otomatis berdasarkan nama header ("type", "name", "group", dan padanan Rusianya). Pratinjau langsung menunjukkan 4 baris pertama seperti yang akan diurai.
Setelah penguraian Anda akan melihat ringkasan:
Klik Ekspor CSV di toolbar. File disimpan dengan:
Nama file default: recipients_AccountName_20261016_143052.csv.
File tidak disimpan sebagai UTF-8. Ekspor ulang dari aplikasi (selalu menulis UTF-8 BOM) atau di Notepad pilih "Save As → encoding UTF-8".
Penguraian cepat — beberapa milidetik per 1000 baris. Dialog pratinjau mungkin memakan waktu satu detik untuk file yang sangat besar, tetapi berfungsi dengan baik.
Halaman Iklan mencantumkan semua pesan terjadwal Anda untuk akun saat ini dan memberikan kontrol langsung atas masing-masing.
Dua panel terpisah:
| Tombol | Apa fungsinya |
|---|---|
| Segarkan | Muat ulang daftar iklan. |
| Iklan baru | Buka editor iklan untuk kampanye baru. |
| Mulai semua / Hentikan semua | Operasi massal untuk akun saat ini. |
| Mulai semua (semua akun) — hanya Enterprise | Mulai setiap iklan dari setiap akun yang diotorisasi. |
| Hentikan semua (semua akun) — hanya Enterprise | Penghentian darurat di semua akun. |
Menampilkan ringkasan konten iklan yang dipilih, interval, jendela waktu, jumlah penerima, penundaan, dan — saat berjalan — bilah kemajuan langsung.
Tombol kontrol:
Halaman melakukan polling status iklan yang berjalan setiap 1,8 detik. Kemajuan, penanda, dan tombol semuanya tetap sinkron dengan backend tanpa penyegaran manual.
Klik Iklan baru untuk membuka editor. Editor memiliki empat tab:
Setiap tab dibahas di bagiannya sendiri di bawah ini.
Susun pesan. Tiga mode: pesan tunggal, rotasi konten, dan rantai pesan.
Mode default. Isi teks pesan dan opsional lampirkan media. Variabel didukung (lihat di bawah).
Aktifkan Gunakan rotasi untuk menentukan beberapa varian (lihat bagian rotasi khusus).
Aktifkan Rantai pesan untuk beralih ke skenario multi-langkah (lihat bagian rantai khusus).
Mendukung teks multiline, pemformatan HTML, dan variabel dinamis:
| Variabel | Hasil |
|---|---|
{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 adaDi bawah textarea aplikasi menampilkan jumlah karakter saat ini, sehingga Anda dapat melihat seberapa dekat Anda dengan batas 4096 karakter Telegram.
Klik Tambah file untuk melampirkan foto, video, atau dokumen. Beberapa file (hingga 10) dikirim sebagai album Telegram.
Alih-alih menulis teks, Anda dapat meneruskan pesan tersimpan yang ada (atau seluruh album):
Bidang pesan reguler dan daftar media disembunyikan.
Pemilih terbuka dengan pesan tersimpan Anda. Gunakan pencarian untuk memfilter berdasarkan teks atau jenis media (foto/video/dokumen/teks).
ID-nya ditempatkan di bidang. Saat iklan berjalan, aplikasi menyelesaikan album lengkap (jika itu album) dan meneruskannya apa adanya.
Variabel seperti {name} tidak berfungsi dalam pesan yang diteruskan — pesan disalin verbatim. Gunakan mode ini untuk pengumuman siaran, bukan penjangkauan yang dipersonalisasi.
Di bagian bawah editor:
Tentukan beberapa varian teks dan media. Setiap penerima mendapatkan yang berbeda — secara dramatis mengurangi deteksi pola spam.
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.
Bidang pesan tunggal digantikan oleh daftar varian.
Apa pun yang ada di bidang pesan tunggal menjadi teks dan media varian #1.
Klik Tambah varian. Isi teks yang berbeda dan/atau lampirkan media yang berbeda.
Teks varian #3 selalu dikirim dengan media varian #3. Ini menjaga varian tetap koheren — tidak ada kombinasi gambar-teks yang tidak cocok.
| Mode | Perilaku |
|---|---|
| Acak | Untuk setiap penerima, varian acak dipilih. Direkomendasikan untuk pengiriman yang paling tidak berpola. |
| Siklus | Varian digunakan secara berurutan: 1, 2, 3, 1, 2, 3… |
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.
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.
Dua varian masih menghasilkan pola berulang. Lima atau lebih benar-benar memvariasikan aliran pesan. Gabungkan dengan media bergilir untuk perlindungan terkuat.
Ubah satu iklan menjadi dialog multi-langkah — 2 hingga 5 pesan dikirim satu demi satu dengan jeda yang dapat dikonfigurasi.
UI pesan tunggal dan rotasi hilang. Sebagai gantinya Anda mendapatkan pembangun langkah.
Jika Anda memiliki pesan yang ditulis dalam mode tunggal, aplikasi secara otomatis mengubahnya menjadi langkah pertama.
Di dalam langkah mana pun, aktifkan Gunakan rotasi untuk menentukan beberapa varian teks+media untuk langkah itu. Mode rotasi (acak/siklus) terpisah per langkah.
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.
Klik Pratinjau untuk melihat seluruh rantai sebagai timeline bernomor dengan gelembung konten per langkah dan indikator jeda di antaranya.
Untuk kampanye pelanggan, rantai 3 langkah bekerja seperti ini:
| Langkah | Konten | Penundaan 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." | — |
Ya — tidak ada batas keras, tetapi 2–5 langkah adalah titik manisnya. Rantai yang lebih panjang mulai terasa seperti spam.
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.
Kontrol kapan dan seberapa sering iklan berjalan. Dua mode penjadwalan, plus jendela waktu, hari-dalam-seminggu, dan perlindungan berhenti otomatis.
Atur interval dalam menit. Rekomendasi minimum: 180 untuk saluran, 60 batas mutlak. Di bawah itu Telegram mulai merespons dengan FloodWait.
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.
Jika suatu waktu jatuh pada hari yang tidak Anda centang, aplikasi melewati ke hari yang valid berikutnya secara otomatis.
Batasi pengiriman ke jam tertentu — mis. hanya selama jam kerja. Jendela semalam juga berfungsi (22:00 → 06:00).
Jika Anda mengaktifkan Jendela waktu global di Pengaturan, itu menggantikan pengaturan per iklan. Petunjuk ungu muncul di editor iklan — jendela per iklan dinonaktifkan.
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.
Rentang acak dalam detik. Untuk setiap penerima, penundaan diambil secara seragam antara min dan maks.
| Skenario | Direkomendasikan |
|---|---|
| Saluran kecil (< 20 penerima) | 10–30 detik |
| Daftar sedang (20–100) | 30–120 detik |
| Daftar besar (100+) | 60–300 detik |
| Aturan | Perilaku |
|---|---|
| Berhenti setelah N kesalahan berturut-turut | Jika N kesalahan terjadi berturut-turut (penghitung diatur ulang pada pengiriman sukses apa pun), kampanye berhenti. Direkomendasikan: 5–10. |
| Berhenti setelah N FloodWait / jam | Jika 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. |
Secara default, kedua aturan berhenti otomatis adalah 0. Atur untuk kampanye produksi — tidak ada alasan baik untuk tidak melakukannya.
Jika grup yang dipilih adalah forum Telegram (dengan topik), Anda dapat mengirim ke topik tertentu — atau ke obrolan utama.
Supergrup di mana admin mengaktifkan "Topics" — pesan diatur ke utas terpisah. Grup reguler tidak memiliki topik.
Grup forum apa pun yang Anda pilih akan menampilkan tombol topik.
Dialog terbuka dengan pohon grup dan topiknya. Topik dimuat dari Telegram sesuai permintaan (di-cache setelah pengambilan pertama).
Setiap grup memiliki daftar kotak centangnya sendiri. Obrolan utama muncul sebagai item pertama.
Pilihan Anda disimpan per iklan dan per grup.
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.
Jumlah "total penerima" dalam detail iklan mencakup pemisahan topik. Satu grup dengan 3 topik dipilih dihitung sebagai 3 penerima.
Selalu tersedia. Jika Anda hanya mencentang obrolan utama — tanpa topik — pesan hanya masuk ke feed umum.
Kumpulkan peserta dari grup atau saluran mana pun, lalu kirimkan mereka pesan langsung yang dipersonalisasi.
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.
Salah satu dari:
@username — jika grup memiliki nama pengguna publikt.me/... — tautan undangan lengkapMendukung variabel pengguna: {name}, {first_name}, {last_name}, {username}.
Seberapa sering kampanye berjalan satu lintasan. Untuk kampanye DM, 1440 menit (sekali sehari) adalah yang paling aman.
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.
Klik Mulai. Lintasan pertama berjalan segera. Statistik langsung muncul di panel info dan diperbarui setiap detik:
Pengguna dilewati secara diam-diam (dihitung dalam Dilewati) ketika Telegram mengembalikan:
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 | Arti |
|---|---|
all_done | Semua peserta yang diambil telah diproses |
manual | Anda menghentikan kampanye |
peer_flood | Telegram menandai akun — berhenti keras |
empty_source | Grup/saluran sumber tidak memiliki peserta yang cocok dengan filter Anda |
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.
Bergabung secara massal ke grup dan saluran dari daftar tautan dengan penundaan yang dapat dikonfigurasi.
Tempel tautan di textarea — satu per baris. Format yang didukung:
https://t.me/joinchat/XXXXX — tautan undangan privatt.me/username — grup atau saluran publik@username — publik+invite_hash — undangan privatDirekomendasikan: 10–30 detik. Nilai yang lebih rendah menyebabkan kesalahan FloodWait dengan sangat cepat. Default 5 detik agresif — Anda ingin setidaknya 15.
.txtAplikasi memproses tautan satu per satu:
Daftar tautan Anda secara otomatis disimpan di localStorage antar sesi. Klik Simpan ke file untuk mengekspornya sebagai .txt untuk cadangan.
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.
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.
Secara otomatis menerbitkan story Telegram sesuai jadwal. Memerlukan Telegram Premium pada akun.
Story adalah fitur Telegram Premium. Jika akun Anda tidak memiliki Premium, aplikasi akan menolak memulai kampanye dengan kesalahan yang jelas.
Isi:
Pilih kampanye, klik Mulai. Aplikasi:
| Tipe | Format | Batas |
|---|---|---|
| Foto | JPG, PNG, WEBP, GIF, BMP | Hingga 5 MB |
| Video | MP4, MOV, AVI, MKV, WEBM | Hingga 60 detik, hingga 5 GB |
Ya — story bersifat per akun. Jika akun A memiliki Premium dan akun B tidak, hanya A yang dapat menerbitkan story.
Aplikasi berhenti sejenak untuk waktu yang diperlukan, mencatat peristiwa ke Log Peristiwa dan Statistik, lalu melanjutkan secara otomatis.
Belum — penjadwal hanya interval untuk story. Opsi waktu tetap direncanakan untuk AutoPoster Cloud.
Secara otomatis membalas pesan pribadi yang masuk berdasarkan pencocokan kata kunci. Hanya paket Enterprise.
Pada Standard atau uji coba, bagian Balasan otomatis menampilkan status terkunci dengan tautan peningkatan. Editor aturan, pengujian, dan eksekusi apa pun memerlukan Enterprise.
Aplikasi mengawasi semua pesan pribadi yang masuk pada akun saat ini. Ketika pesan cocok dengan kondisi aturan, tindakan yang dikonfigurasi terpicu.
Isi:
| Tipe | Perilaku |
|---|---|
| Berisi | Kata kunci apa pun muncul di mana saja dalam pesan (tidak peka huruf besar-kecil) |
| Sama persis | Seluruh pesan sama persis dengan kata kunci |
| Regex | Pencocokan regex gaya Python — paling kuat |
| Apa pun | Terpicu pada pesan masuk apa pun. Bidang kata kunci disembunyikan. |
| Tindakan | Perilaku |
|---|---|
| Balas | Kirim teks balasan yang dikonfigurasi ke pengirim |
| Lewati diam-diam | Cocokkan pesan tetapi tidak melakukan apa pun (berguna untuk mencatat pola) |
| Beri tahu pemilik | Teruskan pesan ke Pesan Tersimpan Anda dengan nama 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.
Jika pesan masuk berasal dari topik grup forum, balasan dikirim kembali ke topik yang sama — bukan ke obrolan umum. Ini otomatis.
Tidak — pesan bot diabaikan. Pesan sendiri juga diabaikan.
Waktu tunggu hanya disimpan di memori. Memulai ulang aplikasi mengatur ulangnya. Jika ini penting bagi Anda, biarkan aplikasi tetap berjalan.
Ya — {first_name}, {last_name}, {username}, dan {name} semuanya diganti dengan info pengirim.
Dasbor analitik lengkap: aktivitas berdasarkan hari dan jam, target teratas, kesalahan teratas, peristiwa terkini dengan ekspor CSV.
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.
10 penerima paling sering digunakan teratas dengan jumlah terkirim, jumlah kesalahan, dan — untuk saluran — lencana total tampilan.
10 jenis kesalahan teratas berdasarkan frekuensi. Berguna untuk memahami masalah sistematis:
not_found — penerima tidak ada lagiprivacy — pembatasan privasi penggunapeer_flood — sinyal berhenti keras dari Telegramflood_wait — batas laju tercapai30 peristiwa terakhir dengan stempel waktu, nama kampanye, target, dan pil status. Difilter oleh periode/akun/kampanye yang sama dengan KPI.
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.
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
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.
Setiap tindakan yang diambil aplikasi dicatat di sini. Gunakan untuk memantau kampanye dan mendiagnosis masalah.
| Filter | Efek |
|---|---|
| Tingkat | Tampilkan hanya INFO / WARNING / ERROR / SEMUA |
| Akun | Filter ke peristiwa akun tertentu |
| Pencarian | Pencarian teks bebas di badan pesan (debounce 200 ms) |
| Mode senyap | Sembunyikan pesan rutin seperti pengiriman individual — hanya tampilkan hal penting. Diaktifkan secara default; tombol dipertahankan. |
Di atas badan log Anda melihat penghitung langsung:
Menyalin semua peristiwa yang difilter ke clipboard dalam format TXT yang sama. Berguna untuk menempel ke tiket dukungan.
Klik Hapus untuk menghapus buffer yang terlihat dan daftar dalam memori. Log file di disk (data/logs/app.log) tidak terpengaruh.
Jika sesuatu tidak berfungsi, nonaktifkan Mode senyap untuk melihat setiap peristiwa individual. Log lengkap akan menunjukkan dengan tepat apa yang terjadi di tingkat pesan.
Semua konfigurasi global di satu halaman.
| Pengaturan | Deskripsi |
|---|---|
| Bahasa | 25 bahasa antarmuka. Perubahan memicu muat ulang aplikasi penuh. |
| Tema | Sistem / Gelap / Terang. Berlaku seketika tanpa muat ulang. |
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.
api.ipify.org. Hasil muncul sebagai toast.Jendela pengiriman tunggal yang diterapkan ke setiap iklan dan kampanye di seluruh akun. Saat diaktifkan, ini menggantikan pengaturan per iklan.
Dibahas secara rinci di bagian Pemeriksaan Kesehatan Sesi:
Lihat bagian khusus di bawah ini.
Menampilkan paket saat ini, hari tersisa, tanggal berakhir. Tombol untuk membuka kembali dialog aktivasi.
data/logs/ di pengelola file AndaDapatkan laporan kampanye langsung di Telegram — ke Pesan Tersimpan Anda atau obrolan apa pun.
Di Pengaturan, di bawah kartu notifikasi Telegram.
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.
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
(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).
Ya. Setiap notifikasi melalui akun saat ini. Laporan muncul di Pesan Tersimpan akun yang sama (atau obrolan yang dipilih).
Satu klik untuk mengekspor semuanya: konfigurasi, database, sesi, iklan, kampanye, dan statistik sebagai satu file ZIP.
logs/ — file logexports/ — file CSV yang dieksporbackups/ — cadangan lamaDialog muncul dengan kotak centang opsional "sertakan sesi".
Nama file default: tgautoposter_backup_20261016_143052.zip. Kemajuan dicatat di Log Peristiwa.
Pemilih file terbuka. Pilih ZIP.
Dialog menampilkan tanggal pembuatan cadangan, jumlah file, dan apakah itu berisi sesi.
Aplikasi membuat cadangan keamanan otomatis dari status Anda saat ini (data/backups/before_import_*.zip), lalu memulihkan ZIP di atasnya.
Dialog konfirmasi menawarkan untuk memuat ulang aplikasi segera.
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.
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.
Aplikasi memeriksa versi baru saat memulai dan menawarkan jendela changelog ketika tersedia.
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).
Pembaruan kritis (keamanan atau kompatibilitas) muncul tanpa tombol "Ingatkan nanti" / "Lewati" — Anda perlu mengunduh dan menginstalnya untuk melanjutkan.
Dua cara:
Pengaturan → Debug menampilkan dump JSON dengan versi Anda saat ini, respons server, dan apakah pembaruan akan terpicu. Berguna saat membuka tiket dukungan.
Belum. Aplikasi membuka halaman unduhan — Anda menginstal versi baru secara manual. Pembaruan otomatis senyap direncanakan untuk AutoPoster Cloud.
Tidak. Folder data/ Anda tidak tersentuh. Cukup ganti EXE / DMG.
Tidak ada yang buruk terjadi. Pemeriksaan gagal secara diam-diam dan aplikasi berlanjut. Tanpa popup, tanpa kesalahan.
Semuanya disimpan dalam satu folder. Pahami itu, dan Anda memahami aplikasinya.
| Platform | Jalur |
|---|---|
| Windows | <folder dengan EXE>/data/ |
| macOS | ~/Library/Application Support/TG AutoPoster Pro/ |
| File / Folder | Tujuan |
|---|---|
config.json | Semua pengaturan, cache lisensi, konfigurasi session_check, notifikasi, proxy global |
autoposter.db | Database 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_v4 | File penanda — menunjukkan migrasi data lama berjalan |
Setiap kali Anda menyimpan pengaturan atau kampanye, config.json sebelumnya disalin ke backups/ dengan stempel waktu. Hanya 5 yang terbaru disimpan.
data/backups/ dan temukan salinan yang Anda inginkanconfig.json dan ganti yang saat iniSebelum beralih akun, menginstal ulang, atau pindah ke komputer baru — ekspor ZIP profil lengkap atau salin seluruh folder data/ ke tempat yang aman.
data/ (atau padanan macOS) ke USBdata/ kosong)data/ baru dengan yang dari USBJawaban cepat untuk masalah paling umum.
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.
Buka Terminal dan jalankan: xattr -cr /Applications/TelegramAutoPoster.app — ini menghapus tanda karantina. Kemudian coba luncurkan lagi.
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.
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.
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.
Peringatan anti-spam terkeras Telegram. Kampanye berhenti secara otomatis. JANGAN memulainya kembali segera — tunggu 24–48 jam. Jika berulang, akun mungkin dibatasi secara permanen.
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.
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.
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.
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.
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.
Hubungi kami di Telegram: @igor_shelloff — biasanya membalas dalam beberapa jam. Sertakan: apa yang Anda lakukan, apa yang terjadi, dan kutipan log yang relevan.