FB comment cleaner
Hides (or deletes) spam comments under your Facebook ad posts on a schedule. Dry-run by default, hide by default β both because hide is reversible.
Wiring
- Token: a user or System User token on the existing Facebook cost connection. The cleaner resolves page tokens through
/me/accounts(cached 24 h) β comment moderation needs the page token, not the user's. Required permissions:pages_read_user_content,pages_manage_engagement. - Posts: nothing to configure. The creative sync writes every ad's
creative.effective_object_story_idintocomment_postsβ the post list is a by-product of the cost sync. - Worker:
cli/comment_cleaner_cron.php(install.sh schedules it every 10 minutes). Reads new comments since the last check (filter=stream&order=reverse_chronological&since=β¦), applies the rule set, writes the journal, reschedules each post: new comments reset the delay, quiet posts back off exponentially (15 min β doubling, cap 24 h), ads that stopped running are checked once a day.
Rule sets
One rule set serves several FB connections. Checks run in a fixed order β stop words β admin regexes β links β contacts β emoji-only β char repeats β min length β and exceptions always win: author id (id:123), author name (name:β¦), or a phrase. The page's own comments are never touched.
- Stop words (β€500, one per line) match on the normalized text: lowercase, Cyrillic/Greek homoglyphs folded to Latin (
sΡΠ°mwith a Cyrillic Ρ still matchesscam), leetspeak decoded (fr33 b0nusβfree bonus), zero-width characters removed. The whole word mode wraps each word in boundaries βΠΊΠΈΠ΄does not fire onΠΊΠΈΠ΄Π°ΠΉ ΠΌΡΡ(the exact trap adset.pro falls into). - Regexes (β€50) are admin-only β a non-admin saving the set gets them stripped. Each pattern runs on a 500-char subject with a lowered backtrack limit: that is the timeout against catastrophic backtracking.
- Links are detected on the raw text β
spamlink .comwith a space before the dot still fires, messenger deep links (t.me/β¦,wa.me/β¦) count as links. The whitelist (domains, one per line) covers subdomains. - Contacts: phones (7β15 digits with separators), e-mails, and messenger invitations (
DM me,ΠΏΠΈΡΠΈ Π² Π»Ρ, β¦). - Emoji-only: no letters or digits at all after stripping emoji/punctuation.
- Char repeats: the same character 4+ times in a row.
- Min length: below N characters.
Presets ship ready: Links & contacts, DM funnel, Scam claims, Junk & bots (dictionaries in EN/RU/EL/PT). The Test the text button shows exactly which rule fires on a pasted comment.
Two modes: rules only (default) and everything except exceptions. A separate toggle decides whether comments under inactive (paused/deleted) ads are cleaned at all.
Journal and safety
The Comments tab (Aggregator section) shows every action: time, comment text, author, matched rule, action, status, with Restore / Hide / Delete buttons per row. Comment texts live 60 days, then the text is wiped and only the action record remains.
- Dry run writes the journal and touches nothing on Graph. When you switch it off, the panel shows how many comments the dry run would have hidden in the last 24 h.
- Auto-pause: an error rate above 30% in a cycle (minimum 10 actions) or a Graph rate-limit code (4, 17, 32, 613) pauses the worker with a banner and a Telegram message; resume is one button.
- A worker banner appears when posts are due but the cron has not run lately.
API
comment_rulesets (CRUD), comment_ruleset_test, comment_log (+24 h stats), comment_log_action (restore/hide/delete), comment_cleaner_status, comment_cleaner_resume.
Quick start: your first campaign
The short path: install the tracker, create a campaign, and get your first clicks and conversions in under an hour.
Read guide βDocsInstallation and updates
Install Orbitra on a fresh Ubuntu or Debian server with one command, and update to new versions safely.
Read guide βDocsMigrating from Keitaro
Move campaigns, offers, sources and domains from Keitaro to Orbitra in one click β what transfers and what to check.
Read guide βDocsMigrating from Binom
Move campaigns and streams from Binom to Orbitra: what transfers automatically and what to set up by hand.
Read guide βDocsFeature overview
Everything Orbitra can do: campaigns and streams, cloaking, landings, PWA, postbacks, costs, reports and integrations.
Read guide βDocsCampaigns and streams
The complete reference: campaign settings, stream types, schemas, rotation, filters, test links and every option explained.
Read guide βDocsCloaking
Full cloaking reference: detection layers, global settings, per-stream filters, verdicts and reports.
Read guide βDocsBrowser check
How the JS check catches bots, VMs and emulators through contradictions in the browser environment.
Read guide βDocsLanding pages
Landing types, the {offer} macro, the JS adapter, LeadForge and multi-offer landings β the complete reference.
Read guide βDocsPWA and Web Push
Build installable PWA apps and collect push subscribers: settings, icons, events and notifications.
Read guide βDocsPWA Funnel
A multi-step PWA funnel: install prompts, event tracking and re-engagement notifications.
Read guide βDocsConversion popups
Show real conversion events as on-page popups: setup, triggers and placement.
Read guide βDocsSession recordings and heatmaps
Replay real visits and see click and scroll maps. Storage limits and privacy notes.
Read guide βDocsContent gallery
Central storage for icons, screenshots and creatives used across PWAs and landings.
Read guide βDocsCreatives library
Store creatives with subid tracking and test them across campaigns.
Read guide βDocsExternal PWA and Telegram channels
Publish PWAs to external domains and run Telegram channels as a traffic source.
Read guide βDocsPostbacks and conversions
Incoming postbacks, conversion statuses and types, and outgoing S2S postbacks to your traffic source.
Read guide βDocsCosts
Import spend from Facebook, TikTok and Google Ads, or update it via API and cron β and how the revenue aggregator works.
Read guide βDocsPush and pop networks
Working with push and pop traffic sources: feeds, zone optimization and the zone killer.
Read guide βDocsFacebook / Meta
Cost import from Meta Ads and the Conversions API: server-side events with deduplication.
Read guide βDocsDolphin / Fbtool
Receive Facebook costs through the Dolphin (Fbtool) API in real time.
Read guide βDocsFB comment cleaner
Bulk-moderate comments under Meta ads: hide, delete and filter by keywords.
Read guide βDocsTraffic sources and affiliate networks
Catalog of 50+ traffic sources and 440+ networks: templates, parameters and postback URLs.
Read guide βDocsReports, logs and metrics
The report builder, saved reports, click logs and every metric explained.
Read guide βDocsDomains and SSL
Add domains, DNS, free Let's Encrypt certificates, redirects, parking and every switch on the page.
Read guide βDocsCloudflare
How to run campaign domains through Cloudflare: DNS, SSL modes and what to turn off.
Read guide βDocsAdministration
Users, roles and permissions, security settings, geo databases, updates and system health.
Read guide βDocsTelegram bot
Manage the tracker from Telegram: stats, conversions and alerts in chat.
Read guide βDocsMCP: an AI assistant in the tracker
Connect Claude or any MCP client to Orbitra and manage campaigns with plain-language commands.
Read guide β