Lahat ng kailangan mong malaman

I-download at i-install

Ang app ay portable sa Windows at drag-and-drop sa macOS. Walang dependencies, walang admin rights.

Windows

macOS

Saan nakatira ang data

Pag-setup ng Telegram API

Ang bawat Telegram client ay nangangailangan ng api_id at api_hash — libreng opisyal na credentials mula sa Telegram. Tumatagal ito ng mga 3 minuto.

Activation at mga plano

Tatlong plano, isang activation window. Lumipat anumang oras sa pamamagitan ng paglalagay ng bagong key.

Mga plano sa isang sulyap

Pag-activate ng key

Offline grace period

Sinusuri ng app ang lisensya tuwing 6 na oras. Kung may problema sa network, patuloy itong gumagana mula sa cached state hanggang 30 araw (hanggang sa huling na-verify na end date). Makikita mo ang kulay-abong Offline badge sa license card, ngunit walang nawawalang functionality.

Saan makikita ang status

• Sidebar card — pangalan ng plano, mga araw na natitira, end date
• Settings → License — parehong impormasyon sa settings page
• Top banner — makikita kung nawawala o nag-expire ang lisensya

Mga Account

Ang Accounts page ay ang iyong home base. Lahat ng iba pa — mga tatanggap, ad, campaign — ay nabibilang sa kasalukuyang napiling account.

Ang account grid

Ang bawat account ay isang card na nagpapakita ng:

• Pangalan at initial badge
• Status — Authorized (berde) o Not authorized (abo)
• Impormasyon ng user — ang display name at @username sa Telegram
• Telepono, Proxy, at kasalukuyang status ng session

Ang account na kasalukuyang ginagamit mo ay minarkahan ng violet na border at CURRENT badge sa kanang itaas na sulok.

Toolbar

Mga aksyon sa card

Pagdaragdag ng bagong account

QR / SMS authorization

Dalawang paraan. Ang QR ay mas mabilis at hindi nangangailangan ng phone field — ang SMS ay fallback.

Pagpili ng paraan

I-click ang Authorize sa anumang account. May bubukas na dialog na may dalawang opsyon:

• QR code — inirerekomenda. Nangangailangan lamang ng API ID + API Hash.
• SMS code — nangangailangan ng numero ng telepono sa settings ng account.

Kung walang laman ang phone, hindi pinagana ang SMS option na may hint.

QR login

SMS login

Pagsusuri ng kalusugan ng session v4.0

Pinapanatili ng app na buhay ang iyong mga session sa Telegram nang hindi mo kailangang alagaan ang mga ito.

Paano ito gumagana

Sa pagsisimula ng app at sa nako-configure na interval, dinadaanan ng app ang bawat account at bine-verify na buhay ang session. Mabilis ito — isang request bawat account. Walang QR o SMS, naglo-load ang session mula sa data/sessions/.

Ang mga check ay tumatakbo sa isang background thread pool (hanggang 3 account nang parallel), kaya nananatiling responsive ang interface.

Mga status indicator

Sa Accounts page, ang bawat card ay may kulay na tuldok sa tabi ng pangalan nito:

• 🟢 Authorized — buhay ang session, handa nang magtrabaho
• 🔴 Not authorized — patay ang session, kailangan ng QR re-authorization
• 🟠 Unreachable — problema sa network (walang internet, patay ang proxy). Malamang buhay pa ang session — hindi lang namin na-verify
• ⚪ Not configured — walang API credentials ang account
• 🟣 Checking — kasalukuyang nagsusuri

Pag-enable at pag-configure

Pumunta sa Settings → Session health check:

Manu-manong check

I-click ang Check sessions sa toolbar sa Accounts page. Makikita ang progreso sa pamamagitan ng dot indicator; ipinapakita ng button ang checking… X/Y.

Re-authorization queue

Kapag may nakitang patay na session, iniaalok ng app na i-re-authorize ang mga ito nang isa-isa:

1. May prompt na lalabas: "Found N dead sessions. Re-authorize all now?"
2. I-click ang Yes — may magbubukas na QR login window para sa unang patay na account
3. I-scan ang QR gamit ang iyong telepono. Kapag na-authorize ang account na iyon, awtomatikong magbubukas ang susunod na QR
4. Magpapatuloy ang proseso hanggang maubos ang queue
5. Ang summary toast ay magpapakita: Re-auth finished: N successful, M failed

Monitor ng kalusugan ng account v4.0

Isang risk indicator bawat account, batay sa totoong aktibidad ng pagpapadala sa huling 24 na oras.

Pagbubukas nito

Sa anumang account card, i-click ang shield icon. May bubukas na modal na may data ng kalusugan para sa account na iyon.

Ano ang makikita mo

Mga antas ng panganib

Mga rekomendasyon

I-click ang Recommendations sa modal para sa checklist batay sa kasalukuyang data. Halimbawa:

• Kung PEER_FLOOD > 0 — i-pause ang account na ito ng 24–48 oras
• Kung madalas ang flood — dagdagan ang delay sa pagitan ng mga mensahe
• Kung naipadala > 100/24h — bawasan ang pang-araw-araw na volume
• Ang mga berdeng account ay nakakakuha ng "You're good, keep doing what you're doing"

Mga Tatanggap

Mga grupo, channel at contact na available para sa kasalukuyang account, na inayos sa tatlong column.

Toolbar

Tatlong column

• Groups — mga chat at supergroup kung saan may karapatan kang mag-post
• Channels — mga broadcast channel na iyong pinangangasiwaan
• Contacts — mga user na maaari mong i-DM

Paggawa sa mga item

• Checkbox — pumili ng indibidwal na tatanggap
• Checkbox sa header — piliin / alisin ang lahat sa column na ito
• Delete button on hover — alisin ang isang tatanggap mula sa lokal na listahan (hindi nakakaapekto sa Telegram)
• Add + — manu-manong magdagdag ng isang tatanggap (i-type ang eksaktong pangalan)
• Remove selected — alisin ang lahat ng naka-check na tatanggap

Selection actions bar

Kapag may hindi bababa sa isang item na napili, may lalabas na violet action bar sa itaas ng mga column na may:

• Add to group — ilipat ang napili sa isang pinangalanang grupo
• Remove from group — makikita lamang kapag may aktibong group filter
• Delete — alisin ang mga napiling tatanggap nang buo
• Clear selection — alisin ang check sa lahat

Mga grupo ng tatanggap v4.0

Mga pinangalanang koleksyon ng mga tatanggap — tulad ng "Main", "VIP", "Test" — para sa one-click na pagpili sa mga ad.

Paglikha ng grupo

Pamamahala ng mga grupo

Sa Manage groups dialog, maaari mong:

• Palitan ang pangalan ng grupo — pencil icon
• Tanggalin ang grupo — trash icon. Ang mga tatanggap mismo ay mananatili sa iyong listahan; tanging ang membership ng grupo ang aalisin.
• Makita ang bilang ng miyembro sa tabi ng bawat grupo

Pag-filter ng Recipients view

Gamitin ang group filter dropdown sa toolbar upang tingnan lamang ang mga miyembro ng isang partikular na grupo. Mga opsyon:

• All recipients — ipakita ang lahat
• Without group — mga tatanggap lamang na wala sa anumang grupo
• Anumang partikular na pangalan ng grupo

Pagpili ng grupo sa ad editor

Buksan ang anumang ad → Recipients tab. Sa itaas ng tatlong column, makikita mo ang row ng group chips:

• ○ pangalan — 12 — walang napili (12 available)
• ◐ pangalan — 5/12 — bahagyang napili
• ✓ pangalan — 12 — ganap na napili (berde)

I-click ang chip upang i-toggle ang buong grupo. I-click muli upang alisin ang check sa lahat sa grupong iyon.

Import CSV / Excel / JSON v4.0

Bulk-load ng listahan ng tatanggap mula sa spreadsheet, JSON dump, o CSV na na-export mula sa ibang app.

Mga sinusuportahang format

• CSV — auto-detect ng delimiter (;, , o tab)
• Excel — .xlsx at .xlsm na may interactive na column-mapping dialog
• JSON — alinman sa listahan ng object o dict na may group/channel/contact key

Format ng CSV

Dalawa o tatlong column: type, name, at opsyonal na group.

type;name;group
group;Marketing chat;Main
channel;@my_channel;Main
contact;John Smith;
group;Test chat;Test

Tumatanggap ang type ng mga kasingkahulugan sa Ingles at Ruso:

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

Format ng JSON

Dalawang tinatanggap na hugis:

[
  { "type": "group",   "name": "Marketing chat", "group": "Main" },
  { "type": "channel", "name": "@my_channel",   "group": "Main" }
]

O naka-grupo ayon sa type:

{
  "group":   ["Marketing chat", "Test chat"],
  "channel": ["@my_channel"],
  "contact": ["John Smith"]
}

Excel column mapping

Kapag nag-import ka ng .xlsx file, may lalabas na mapping dialog:

• Type column — kung aling column ang may hawak ng group/channel/contact
• Name column — kung aling column ang may hawak ng aktwal na pangalan ng tatanggap
• Group column — opsyonal na pinangalanang grupo upang italaga ang bawat tatanggap

Awtomatikong hinuhulaan ng app batay sa mga pangalan ng header ("type", "name", "group", at ang kanilang mga katumbas sa Ruso). Ang live preview ay nagpapakita ng unang 4 na row kung paano ito i-parse.

Preview ng import

Pagkatapos ng parsing, makikita mo ang summary:

• Bago — ilang bagong row ang idadagdag
• Mga duplicate — ilan ang umiiral na sa iyong listahan
• Mga error — mga problema sa pag-parse, na may mga numero ng linya
• Mga natukoy na grupo — mga pangalan ng grupo na nakita sa file

Merge vs Replace

• Merge — nagdadagdag ng mga bagong tatanggap, nilalaktawan ang mga duplicate, hindi ginagalaw ang mga umiiral
• Replace — binubura ang kasalukuyang listahan at ginagamit lamang ang nasa file (may lalabas na karagdagang confirmation dialog)

Pag-export sa CSV

I-click ang Export CSV sa toolbar. Ang file ay naka-save na may:

• UTF-8 BOM encoding — bubukas nang tama ang Excel sa non-ASCII text
• Semicolon delimiter
• Opsyonal na group column na naglilista ng lahat ng grupo ng tatanggap kung saan nabibilang ang item

Default na filename: recipients_AccountName_20261016_143052.csv.

Pangkalahatang-tanaw ng Ads

Inililista ng Ads page ang lahat ng iyong naka-iskedyul na mensahe para sa kasalukuyang account at nagbibigay ng live na kontrol sa bawat isa.

Layout

Dalawang-panel na split:

• Kaliwa — listahan ng ad na may running/paused/stopped marker
• Kanan — mga detalye para sa napiling ad

Mga marker sa listahan

• ▶ — tumatakbo
• ⏸ — naka-pause
• ⏹ — huminto

Mga aksyon sa toolbar

Details panel

Ipinapakita ang content summary ng napiling ad, interval, time window, bilang ng tatanggap, delay, at — habang tumatakbo — isang live progress bar.

Mga button sa kontrol:

• Start — simulan ang pagpapadala
• Pause / Resume — pansamantalang ihinto nang hindi nawawala ang estado
• Stop — kanselahin nang buo (agad na naaabala ang tumatakbong cycle)
• Edit, Duplicate, Delete

Paglikha ng bagong ad

I-click ang New ad upang buksan ang editor. Ang editor ay may apat na tab:

1. Content — text, media, rotation, chains
2. Recipients — mga grupo, channel, contact, forum topic
3. Schedule — interval, time window, araw, delay, auto-stop
4. Advanced — limitasyon sa pagpapadala, template

Ang bawat tab ay saklaw sa sarili nitong seksyon sa ibaba.

Editor ng Ad — Content

Bumuo ng mensahe. Tatlong mode: single message, content rotation, at message chains.

Mode 1 — Single message

Ang default na mode. Punan ang text ng mensahe at opsyonal na mag-attach ng media. Sinusuportahan ang mga variable (tingnan sa ibaba).

Mode 2 — Content rotation

I-enable ang Use rotation upang tukuyin ang maraming variant (tingnan ang nakalaang seksyon ng rotation).

Mode 3 — Message chains

I-enable ang Message chains upang lumipat sa multi-step scenario (tingnan ang nakalaang seksyon ng chain).

Field ng Mensahe

Sinusuportahan ang multiline text, HTML formatting, at dynamic na variable:

Sa subscriber campaigns (DM), available din ang mga user variable na ito:

• {name} — buong pangalan
• {first_name}, {last_name} — mga bahagi ng pangalan
• {username} — @username kung mayroon

Media

I-click ang Add files upang mag-attach ng mga larawan, video, o dokumento. Maramihang file (hanggang 10) ay ipinapadala bilang isang Telegram album.

• Ang mga file ay nakalista gamit ang kanilang base name at isang hover-delete button
• Anumang uri ng file na tinatanggap ng Telegram: JPG, PNG, MP4, MOV, ZIP, PDF, atbp.
• Ang media ay ina-upload bawat mensahe — walang isyu sa rate-limit na lampas sa karaniwang delay sa pagpapadala

Forward mula sa Saved Messages

Sa halip na magsulat ng text, maaari mong i-forward ang isang umiiral na saved message (o isang buong album):

Preview at Test send

Sa ibaba ng editor:

• Preview — ipinapakita ang mensahe kung paano ito magmumukha sa Telegram (na may substitution ng date/time variable)
• Test send — ipinapadala ang mensahe isang beses sa unang napiling tatanggap. Gamitin ito bago ilunsad ang isang mahabang campaign.

Pag-ikot ng nilalaman v4.0

Tukuyin ang maramihang text at media variant. Bawat tatanggap ay nakakakuha ng iba — lubhang nagpapababa ng spam-pattern detection.

Pag-enable ng rotation

Panuntunan sa pagpapares

Mga mode ng rotation

Per-variant media

Ang bawat variant ay may sariling listahan ng media. I-click ang Add files sa ilalim ng anumang variant upang mag-attach ng media na partikular sa variant na iyon. Kung walang media ang isang variant, ipinapadala ito bilang text-only na mensahe.

Paggamit ng rotation sa loob ng chains

Gumagana ang rotation sa loob ng chains — ang bawat hakbang ay maaaring may sariling Use rotation toggle. Ang Step 1 ay maaaring magpadala ng 3 text variant nang random, ang Step 2 ay maaaring walang rotation, ang Step 3 ay maaaring mag-cycle sa 5 iba't ibang larawan. Ang counter ng bawat hakbang ay independiyente.

Mga kadena ng mensahe v4.0

Gawing multi-step dialogue ang isang ad — 2 hanggang 5 mensahe na ipinapadala nang sunud-sunod na may nako-customize na pause.

Pag-enable ng chains

Bawat hakbang ay may

• Text — hiwalay na body ng mensahe
• Media — hiwalay na attachment (photo, video, doc)
• Opsyonal na rotation — per-step toggle upang tukuyin ang maramihang variant sa loob ng hakbang
• Delay after — ilang segundo ang hihintayin bago ipadala ang susunod na hakbang (ipinapakita lamang sa pagitan ng mga hakbang, hindi pagkatapos ng huling hakbang)

Pamamahala ng mga hakbang

• Add step — magdagdag ng bagong walang laman na hakbang sa dulo
• ↑ / ↓ arrow — muling ayusin ang mga hakbang (hindi pinagana sa una/huli)
• X — tanggalin ang isang hakbang (minimum na isang hakbang ang dapat manatili)

Per-step rotation

Sa loob ng anumang hakbang, i-enable ang Use rotation upang tukuyin ang maramihang text+media variant para sa hakbang na iyon. Ang mode ng rotation (random/cycle) ay hiwalay bawat hakbang.

Preview ng timeline

I-click ang Preview upang makita ang buong chain bilang isang numbered timeline na may per-step content bubble at pause indicator sa pagitan ng mga ito.

Real-world na halimbawa — Warm-up sequence

Para sa subscriber campaigns, ang 3-step chain ay gumagana nang ganito:

Iskedyul

Kontrolin kung kailan at gaano kadalas mag-fire ang ad. Dalawang mode ng pag-iskedyul, kasama ang time window, days-of-week at auto-stop protection.

Mga mode ng iskedyul

Interval mode

Itakda ang interval sa minuto. Minimum na rekomendasyon: 180 para sa mga channel, 60 absolute floor. Sa ibaba nito, nagsisimulang tumugon ang Telegram gamit ang FloodWait.

Fixed-times mode

Magdagdag ng isa o higit pang oras ng araw (HH:MM). Kinakalkula ng app ang susunod na naka-iskedyul na pagtakbo — kung ang lahat ng oras ng isang araw ay nakalipas na, ang unang oras ng susunod na araw ang gagamitin.

Time window

Limitahan ang pagpapadala sa mga partikular na oras — hal. sa oras ng trabaho lamang. Gumagana rin ang overnight window (22:00 → 06:00).

Days of week

Pitong checkbox: Lunes hanggang Linggo. Tanging ang mga naka-check na araw ang pinapayagang magpadala. Kung tumatakbo ang app ngunit ang kasalukuyang araw ay hindi naka-check, naglo-log ito ng "wrong day" at naghihintay.

Delay sa pagitan ng mga mensahe

Isang random range sa segundo. Para sa bawat tatanggap, ang delay ay iginuhit nang pantay-pantay sa pagitan ng min at max.

Auto-stop protection

Ano ang mangyayari kapag nag-fire ang auto-stop

1. Agad na hihinto ang campaign
2. May lalabas na log entry: "Auto-stop: 5 consecutive errors. Ad 'X' stopped."
3. Kung naka-enable ang Telegram notification, makakatanggap ka ng ulat sa Saved Messages
4. Mananatili ang ad sa iyong listahan — ayusin ang isyu at i-restart

Mga paksa sa forum

Kung ang napiling grupo ay isang Telegram forum (may mga paksa), maaari kang magpadala sa mga partikular na paksa — o sa pangunahing chat.

Pag-configure ng mga topic

Ano ang mangyayari sa pagpapadala

Para sa bawat tatanggap na grupo na isang forum, nagpapadala ang app ng hiwalay na mensahe sa bawat naka-check na topic. Kung nag-check ka ng 3 topic sa isang grupo at ang parehong grupo ay napili rin para sa ibang ad, ang mga topic ay nalalapat lamang sa ad na ito.

Pagbilang ng mga tatanggap

Ang "total recipients" count sa ad details ay kasama ang topic splits. Ang isang grupo na may 3 topic na napili ay binibilang bilang 3 tatanggap.

Main chat

Laging available. Kung i-check mo lamang ang main chat — walang topic — ang mensahe ay napupunta lamang sa general feed.

Mga campaign ng subscriber (DM)

Kolektahin ang mga kalahok mula sa anumang grupo o channel, pagkatapos ay magpadala sa kanila ng personalized na direct message.

Paano ito gumagana

1. Tukuyin mo ang isang source — isang grupo o channel kung saan may access ka
2. Kinukuha ng app ang listahan ng kalahok (na may mga filter)
3. Nagpapadala ito sa bawat kalahok ng personalized na DM
4. Ang progreso ay nasusubaybayan — hindi kailanman makakatanggap ang parehong user ng mensahe nang dalawang beses

Paglikha ng campaign

Preview ng mga kalahok

I-click ang Preview sa anumang campaign. May bubukas na window na may listahan ng mga user na ita-target, na nagpapakita ng pangalan, @username at user ID. I-verify na gumagana ang mga filter ayon sa inaasahan bago ilunsad.

Pagpapatakbo ng campaign

I-click ang Start. Agad na tumatakbo ang unang pass. Ang live stats ay lumalabas sa info panel at nag-a-update bawat segundo:

• Naipadala — mga mensaheng naihatid
• Nilaktawan — mga user na walang username, protektado ng privacy, deactivated, bot
• Nabigo — mga error (karaniwang privacy o flood)
• Nasubaybayan — kabuuang natatanging user na nakatanggap na ng mensahe

Mga kondisyon ng paglaktaw

Ang mga user ay tahimik na nilalaktawan (binibilang sa Nilaktawan) kapag nagbalik ang Telegram ng:

• Mga paghihigpit sa privacy — "hindi tumatanggap ang user ng mensahe mula sa estranghero"
• Hindi mutual na contact
• Deactivated na account
• Na-block ka ng user

I-reset ang progreso

I-click ang Reset upang i-clear ang listahan ng "naipadala na". Gamitin ito kung gusto mong ipadala muli ang parehong campaign — ngunit pagkatapos lamang baguhin ang mensahe nang makabuluhan.

Mga dahilan ng pagkumpleto

Pagsali sa grupo

Bulk-join sa mga grupo at channel mula sa isang listahan ng link na may nako-customize na delay.

Paghahanda ng mga link

I-paste ang mga link sa textarea — isa bawat linya. Mga sinusuportahang format:

• https://t.me/joinchat/XXXXX — pribadong invite link
• t.me/username — pampublikong grupo o channel
• @username — pampubliko
• +invite_hash — pribadong invite

Delay sa pagitan ng pagsali

Inirerekomenda: 10–30 segundo. Ang mas mababang halaga ay humahantong sa FloodWait error nang napakabilis. Ang default na 5 segundo ay agresibo — kakailanganin mo ng hindi bababa sa 15.

Pagpapatakbo ng joiner

1. I-paste ang mga link o i-click ang Load from file upang mag-import ng .txt
2. Itakda ang delay
3. I-click ang Start joining

Pinoproseso ng app ang mga link nang isa-isa:

• Ipinapakita ng progress bar ang kasalukuyang posisyon
• Ang bawat pagtatangka ay naka-log sa Event Log
• May lalabas na live results list sa ibaba na may ✓ / ✗ indicator
• Ang final toast ay nagpapakita: N successful, M failed

Pag-save ng iyong listahan

Awtomatikong naka-save ang iyong listahan ng link sa localStorage sa pagitan ng mga session. I-click ang Save to file upang i-export ito bilang .txt para sa backup.

Mga campaign sa story

Awtomatikong mag-publish ng Telegram story ayon sa iskedyul. Nangangailangan ng Telegram Premium sa account.

Paglikha ng story campaign

Pagpapatakbo ng campaign

Piliin ang campaign, i-click ang Start. Ang app ay:

• Sumusuri na ang account ay may Premium
• Bine-verify na umiiral ang media file
• Nag-publish ng unang story agad
• Nag-iskedyul ng mga kasunod na story sa tinukoy na interval

Mga kinakailangan sa media

Auto-reply Enterprise

Awtomatikong tumugon sa mga papasok na pribadong mensahe batay sa pagtutugma ng keyword. Enterprise plan lamang.

Ano ang ginagawa nito

Sinusubaybayan ng app ang lahat ng papasok na pribadong mensahe sa kasalukuyang account. Kapag may mensahe na tumutugma sa kondisyon ng isang panuntunan, nag-fire ang naka-configure na aksyon.

Paglikha ng panuntunan

Mga uri ng pagtutugma

Mga aksyon

Pagsubok ng panuntunan

I-click ang Test sa anumang naka-enable na reply-rule. Ipinapadala ng app ang reply text sa iyong sariling Saved Messages — kapaki-pakinabang upang makita nang eksakto kung paano ito nagre-render kasama ang variable substitution.

Paano nag-trigger ang mga panuntunan

• Ang papasok na mensahe ay pina-parse
• Ang mga panuntunan ay sinusuri sa order; ang unang tugma ang mananalo
• Nangyayari ang cooldown check — ang parehong user ay hindi maaaring ma-auto-reply nang mas madalas kaysa sa cooldown
• Kung ang aksyon ay reply at may delay, maghihintay ang app ng ganoong segundo pagkatapos ay magpapadala

Estadistika v4.0

Buong analytics dashboard: aktibidad ayon sa araw at oras, nangungunang target, nangungunang error, kamakailang mga kaganapan na may CSV export.

Mga filter

Mga KPI card

• Naipadala — matagumpay na pagpapadala (berde)
• Mga Error — hard error (pula)
• Floods — FloodWait event (dilaw)
• Rate — naipadala / (naipadala + error + flood) bilang porsyento
• Views — kabuuang views para sa naka-track na mensahe sa channel

Mga chart

Activity by day — bar chart ng naipadala bawat araw, na may error line overlay.

Activity by hour — bar chart ng naipadala bawat oras ng araw. Kapaki-pakinabang upang matukoy ang iyong pinakamagandang sending window.

Top targets

Top-10 pinaka-ginagamit na tatanggap na may bilang ng naipadala, bilang ng error, at — para sa mga channel — total views badge.

Top errors

Top-10 uri ng error ayon sa dalas. Kapaki-pakinabang upang maunawaan ang mga sistematikong isyu:

• not_found — wala na ang tatanggap
• privacy — paghihigpit sa privacy ng user
• peer_flood — hard stop signal mula sa Telegram
• flood_wait — naabot ang rate-limit
• At iba pa, depende sa partikular na error na ibinalik

Recent events

Ang huling 30 kaganapan na may timestamp, pangalan ng campaign, target, at status pill. Na-filter ayon sa parehong period/account/campaign gaya ng KPI.

Channel views tracking

Para sa mga broadcast channel kung saan admin ang iyong account, awtomatikong kinukuha ng app ang view count sa background. Nire-refresh tuwing 10 minuto para sa mga mensaheng hanggang 7 araw ang edad.

Export CSV

I-click ang Export CSV upang i-save ang lahat ng kaganapan na tumutugma sa kasalukuyang filter sa isang CSV file (hanggang 100,000 row). Mga column:

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

Retention

Ang statistics ay naka-imbak nang lokal sa SQLite. Ang mga kaganapan na mas luma sa 90 araw ay awtomatikong nililinis ng pang-araw-araw na background job. Baguhin ang retention sa config kung kailangan.

Log ng kaganapan

Ang bawat aksyon na ginagawa ng app ay naka-log dito. Gamitin ito upang subaybayan ang mga campaign at i-diagnose ang mga problema.

Mga uri ng kaganapan

• INFO (asul) — routine na kaganapan: nagsimula ang mailing, naipadala ang mensahe, natapos ang campaign
• WARNING (orange) — potensyal na isyu: maliit na interval, mabagal na network, nilaktawang user
• ERROR (pula) — aktwal na pagkabigo: entity not found, walang permiso, PEER_FLOOD

Mga filter

Mga counter

Sa itaas ng body ng log, makikita mo ang live counter:

• Total — lahat ng nakikitang kaganapan
• Naipadala — matagumpay na pagpapadala
• Mga Babala — mga babala
• Mga Error — mga error

Pag-export

• Export TXT — plain text, isang kaganapan bawat linya
• Export CSV — structured na may timestamp, level, kind, silent flag, account, message. UTF-8 BOM para sa Excel.

Copy all

Kinokopya ang lahat ng na-filter na kaganapan sa clipboard sa parehong TXT format. Kapaki-pakinabang para sa pag-paste sa isang support ticket.

Pag-clear

I-click ang Clear upang burahin ang nakikitang buffer at ang in-memory listahan. Hindi apektado ang file log sa disk (data/logs/app.log).

Mga Setting

Lahat ng global configuration sa isang page.

Pangkalahatan

Global proxy

Isang proxy na ginagamit ng lahat ng account na walang sariling proxy. Mga field: type (SOCKS5 / SOCKS4 / HTTP), host, port, opsyonal na username at password.

• Save — nagsusulat sa config
• Test — sinusuri ang iyong external IP sa pamamagitan ng proxy na ito via api.ipify.org. Ang resulta ay lumalabas bilang toast.
• Clear — nire-reset ang lahat ng field at inaalis ang global proxy

Global time window

Isang sending window na inilalapat sa bawat ad at campaign sa lahat ng account. Kapag pinagana, ino-override nito ang per-ad setting.

Auto-start

• Auto-start all ads after authorization — kapag na-authorize ang isang account, agad na magsisimula ang bawat ad na pag-aari nito

Session health check

Saklaw nang detalyado sa seksyon ng Session Health Check:

• I-enable sa pagsisimula
• Auto-check interval (minuto, 0 = hindi pinagana)
• Auto re-authorize dead sessions

Telegram notifications

Tingnan ang nakalaang seksyon sa ibaba.

License

Ipinapakita ang kasalukuyang plano, mga araw na natitira, end date. Button upang muling buksan ang activation dialog.

Data at logs

• Storage stats — kabuuang laki ng data, account, tatanggap, campaign counter
• Open logs folder — binubuksan ang data/logs/ sa iyong file manager
• Backup export — buong profile sa ZIP
• Backup import — i-restore mula sa ZIP na may preview dialog
• Check for updates — manu-manong update check
• Debug — nagpapakita ng JSON dump ng update subsystem state (kapaki-pakinabang para sa support)

Danger zone

• Reset settings — binubura ang proxy, time window, autostart, session check at notification setting pabalik sa default
• Clear accounts — tinatanggal ang bawat account at ang session nito. May confirmation dialog muna.

Mga abiso sa Telegram

Makatanggap ng ulat ng campaign diretso sa Telegram — sa iyong Saved Messages o anumang chat.

Pag-enable

Pagsubok

I-click ang Send test notification. Ginagamit nito ang unang authorized account at nagpapadala ng test message sa iyong napiling target. Kung walang authorized account, makakakuha ka ng malinaw na error.

Mga kaganapang naihatid

Ang bawat notification ay may naka-format na summary. Ang karaniwang ulat ng pagkumpleto ng campaign ay mukhang:

✅ Mailing completed

📣 Campaign: Promo
📤 Sent: 45
❌ Errors: 2

⏱ Duration: 12 min
🕐 14:30 — 14:42

Buong backup ng profile v4.0

Isang click upang i-export ang lahat: config, database, session, ad, campaign at statistics bilang isang ZIP file.

Ano ang kasama

• config.json — lahat ng setting, license key cache
• autoposter.db — account, tatanggap, ad, story, subscriber, template, auto-reply rule, statistics
• sessions/*.session — mga Telegram session file (opsyonal, tingnan sa ibaba)
• templates/ — anumang template folder data

Ano ang hindi kasama

• logs/ — mga log file
• exports/ — mga na-export na CSV file
• backups/ — lumang backup
• WAL/SHM SQLite temporary file

Pag-export

Pag-import

Mga update

Sinusuri ng app ang mga bagong bersyon sa pagsisimula at nag-aalok ng changelog window kapag may available.

Awtomatikong check

2.5 segundo pagkatapos ng pagsisimula, may maliit na request na pumupunta sa update server. Kung may mas bagong bersyon, may lalabas na changelog dialog na may categorized na item (feature, fix, improvement, security).

Update dialog

• Download — binubuksan ang download page sa iyong browser
• Remind later — nagsasara ang dialog, muling lalabas sa susunod na paglulunsad
• Skip this version — huwag kailanman ipakita ang partikular na bersyon na ito muli (kung may mas bagong lumabas, babalik ang dialog)

Manu-manong check

Dalawang paraan:

• Ang download icon sa topbar
• Settings → Data & logs → Check for updates

Debug info

Settings → Debug ay nagpapakita ng JSON dump na may iyong kasalukuyang bersyon, ang tugon ng server, at kung magti-trigger ang update. Kapaki-pakinabang kapag nagbubukas ng support ticket.

Data at mga folder

Lahat ay naka-imbak sa isang folder. Unawain ito, at nauunawaan mo ang app.

Mga lokasyon ng folder

Ano ang nasa loob

Awtomatikong backup

Sa bawat pag-save mo ng setting o campaign, ang dating config.json ay kinokopya sa backups/ na may timestamp. Tanging ang 5 pinakabago ang pinapanatili.

Manu-manong pag-restore ng config backup

1. Isara ang app
2. Buksan ang data/backups/ at hanapin ang kopyang gusto mo
3. Palitan ang pangalan nito sa config.json at palitan ang kasalukuyan
4. I-restart ang app

Paglipat sa bagong computer

1. Kopyahin ang buong data/ folder (o katumbas sa macOS) sa isang USB stick
2. I-install ang app sa bagong computer
3. Isara ito isang beses (upang makagawa ito ng walang laman na data/ folder)
4. Palitan ang bagong data/ folder ng mula sa stick
5. Ilunsad — lahat ay napanatili

Pag-troubleshoot

Mabilis na sagot sa mga pinakakaraniwang isyu.