Popis
SmartGuard AI doplňuje Gravity Forms o firewall založený na umělé inteligenci, který filtruje obsah podle relevance.
Tradiční nástroje na boj proti spamu se většinou ptají: „Vypadá to jako provoz generovaný botem?“
SmartGuard se ptá: „Je tento záznam relevantní pro tento formulář a tuto firmu?“
Právě proto se tento systém osvědčuje u webových stránek, na které přichází mnoho zpráv napsaných lidmi, které však nejsou relevantní.
Proč si týmy instalují SmartGuard AI
- Vyšší kvalita signálu u záznamů v Gravity Forms, nejen blokování botů.
- Vysvětlitelné rozhodnutí včetně skóre, prahové hodnoty, odůvodnění, profilu modelu a historie.
- Rychlejší moderování díky přímým akcím
Potvrdit spam/Potvrdit, že nejde o spam. - Vyšší dlouhodobá přesnost díky adaptivním prahovým hodnotám založeným na skutečné zpětné vazbě od správců.
- Provoz připravený na škálování: asynchronní fronta, opakování pokusů/odklad, jistič a limity využití API.
- Připraveno k integraci s agenturami a automatizačními platformami (REST, podepsané webhooky, nástroje a zdroje MCP, konektor HubSpot).
Co můžete ovlivnit
- Rozhodnutí uvádí:
označeno,schváleno,k přezkoumání,přeskočeno,zařazeno do fronty. - Globální a individuální ovládání: zapnutí/vypnutí, přepsání prahové hodnoty, verze výzvy, režim A/B, profil modelu.
- Kontrola nákladů a rizik: minimální délka obsahu, denní/týdenní/měsíční limity API, mezipaměť vzorů.
- Kontrolní mechanismy správy: nastavení doby uchovávání, vyloučená pole, auditní stopa, výchozí nastavení pro white-label a multisite.
Nejvhodnější oblasti použití
- Kontaktní formuláře, do nichž se opakovaně dostávají irelevantní zprávy nebo nevyžádané zprávy s nekvalitními potenciálními zákazníky.
- Kliniky, advokátní kanceláře, poradenské firmy a místní služby, u nichž je relevantnost klíčová.
- Nastavení více formulářů, kde každý formulář vyžaduje jinou úroveň přísnosti.
- Agentury, které spravují více webových stránek klientů a využívají standardizované postupy v boji proti spamu.
Rychlé nastavení (cca 5 minut)
- Aktivujte funkci SmartGuard AI a ujistěte se, že je aktivní modul Gravity Forms.
- Zadejte svůj klíč k API OpenAI.
- Nastavte prahovou hodnotu a rozpětí nejistoty.
- Odešlete jeden zkušební příspěvek a v seznamu příspěvků si zkontrolujte skóre a zdůvodnění.
- V případě potřeby upravte prahové hodnoty pro výkon.
Součástí balíčku jsou následující jazykové balíčky:
- bg_BG, hr, cs_CZ, da_DK, nl_NL, en_GB, et, fi, fr_FR, de_DE, de_AT, el, hu_HU, ga, it_IT, lv, lt_LT, mt_MT, pl_PL, pt_PT, ro_RO, sk_SK, sl_SI, es_ES, sv_SE, he_IL.
Požadavky:
- WordPress 5.9 nebo novější
- PHP 7.4 nebo novější
- Gravity Forms 2.5 nebo novější (nutné)
- Klíč k API OpenAI
Externí služby
Rozhraní API OpenAI
Tento plugin se připojuje k rozhraní API OpenAI, aby analyzoval odeslané formuláře, u nichž je tato funkce povolena, a vypočítal skóre relevance.
- K čemu služba slouží: Hodnocení spamu a relevance na základě umělé inteligence u záznamů z formulářů Gravity Forms.
- Data sent for scoring: submitted field labels and submitted values from the form entry being analyzed, plus the optional website context configured by the site admin.
- Data sent for the explicit connection test: only the API authorization header and configured model identifier; no form data or prompt content is sent.
- When data is sent: when an enabled form entry is checked by SmartGuard and passes local guardrails, or when an administrator explicitly selects Test API connection in the plugin settings.
- Where data is sent:
https://api.openai.com/v1/chat/completionsfor scoring requests andhttps://api.openai.com/v1/models/{configured-model}for the read-only connection test. - Poskytovatel služby: OpenAI.
- Podmínky použití: https://openai.com/policies/terms-of-use
- Zásady ochrany osobních údajů: https://openai.com/policies/privacy-policy
Custom outbound webhook (optional)
This plugin can send signed SmartGuard events to an endpoint URL configured by the site administrator. The feature is disabled by default.
- What the service is used for: forwarding decision and feedback events to an automation or integration endpoint selected by the site administrator.
- Data sent: delivery ID, event name, timestamp, attempt number, entry ID, form ID, decision status, score, threshold, reason, prompt version/variant, model profile/model, or feedback label/source, depending on the event. Submitted form field values are not included.
- When data is sent: only when outbound webhooks are enabled and SmartGuard creates or updates a decision or feedback label; failed deliveries can be retried.
- Where data is sent: the custom endpoint URL entered by the site administrator in SmartGuard settings.
- Service provider and terms: determined by the configured endpoint. The site administrator is responsible for reviewing that provider’s terms and privacy policy before enabling the webhook.
API HubSpot (volitelné)
Tento plugin obsahuje volitelný konektor pro HubSpot, který je ve výchozím nastavení deaktivován.
- Účel služby: předávání událostí týkajících se rozhodnutí a zpětné vazby ze služby SmartGuard do koncového bodu pro poznámky v systému CRM za účelem následných pracovních postupů.
- Odesílaná data: Metadata událostí SmartGuard, včetně ID záznamu, ID formuláře, označení stavu nebo zpětné vazby, skóre, prahové hodnoty, důvodu a časového razítka. Výchozí konektor neodesílá hodnoty odeslaných polí do HubSpotu.
- Kdy se data odesílají: pouze v případě, že správce webu aktivuje konektor HubSpot a služba SmartGuard vygeneruje podporovanou událost typu rozhodnutí nebo zpětné vazby.
- Kam se data odesílají: Ve výchozím nastavení na
https://api.hubapi.com/crm/v3/objects/notes, případně na vlastní URL koncového bodu nakonfigurovanou správcem webu. - Poskytovatel služby: HubSpot pro výchozí koncový bod. Je-li nakonfigurován vlastní koncový bod, je stejná data události odeslána místo toho do této nakonfigurované externí služby.
- Podmínky použití: https://legal.hubspot.com/website-terms-of-use
- Zásady ochrany osobních údajů: https://legal.hubspot.com/privacy-policy
Snímky obrazovky




Instalace
- Nahrajte složku
smartguard-ai-for-gravity-formsdo adresáře/wp-content/plugins/nebo nainstalujte plugin ve formátu ZIP prostřednictvím administrátorského rozhraní WordPressu. - Aktivujte v systému WordPress SmartGuard AI.
- Ujistěte se, že je modul Gravity Forms nainstalován a aktivován.
- V administračním menu WordPressu otevřete nastavení SmartGuard AI.
- Zadejte svůj klíč k API OpenAI.
- Nastavte prahovou hodnotu pro spam, míru nejistoty a limity pro API a náklady.
- Volitelně: nakonfigurujte adaptivní prahové hodnoty, asynchronní zpracování a integraci webhooků.
- Volitelné: u každého formuláře otevřete Formuláře –> Nastavení –> SmartGuard AI a nakonfigurujte pro daný formulář zapnutí/vypnutí, přepsání prahové hodnoty, verzi výzvy, režim A/B a profil modelu.
Nejčastější dotazy
-
Funguje tento plugin i bez Gravity Forms?
-
Ne. Je nutné použít Gravity Forms.
-
Plugin se z důvodu spolehlivosti řídí zásadou „fail open“: záznamy nejsou automaticky označovány jako spam, pokud není vráceno žádné platné skóre.
-
Co znamená toto skóre?
-
Skóre vyjadřuje, do jaké míry se příspěvek jeví jako relevantní pro kontext vaší webové stránky. Hodnota nižší než prahová hodnota je považována za spam.
-
Je to náhrada za všechny nástroje na boj proti spamu?
-
SmartGuard AI se nejlépe využívá jako doplňková vrstva založená na relevanci. Pro ještě účinnější ochranu jej můžete kombinovat s klasickými ochrannými opatřeními (honeypoty, captcha, blokovací seznamy).
-
Kde se ukládají výsledky?
-
Plugin ukládá stav rozhodnutí, skóre, prahovou hodnotu, důvod, verzi výzvy, míru jistoty, štítky zpětné vazby a historii rozhodnutí do metadat záznamů Gravity Forms. Souhrnné protokoly rozhodnutí a zpětné vazby se ukládají do nastavení WordPressu pro účely analýzy, učení a exportu.
-
Proč se u záznamu zobrazuje „Přeskočeno“ nebo „Ke kontrole“?
-
SmartGuard používá:
–Hodnocení, pokud se skóre nachází v rámci mezí nejistoty kolem prahové hodnoty.
–Přeskočeno, pokud jsou kontroly deaktivovány, obsah je příliš krátký, limity nebo ochranné mechanismy brání volání API nebo je odpověď API neplatná. -
Existuje nějaké API pro integraci?
-
Ano. SmartGuard poskytuje REST koncové body pro statistiky, podrobnosti o záznamech, zpětnou vazbu, frontu ke kontrole, exporty, auditní protokoly a zdroje/nástroje kompatibilní s MCP. K dispozici jsou také podepsané odchozí webhooky a podepsané příchozí webhooky pro zpětnou vazbu.
-
Je k dispozici podpora WP-CLI?
-
Ano. Pro statistiky, kontrolu fronty, nastavení prahových hodnot, import zpětné vazby a kontrolu konektorů použijte příkazy
wp smartguard. -
Existuje nějaký kompletní přehled nastavení?
-
Ano. Otevřete SmartGuard AI –> Nastavení a využijte vestavěnou sekci Návod k nastavení. Ovládací prvky specifické pro jednotlivé formuláře zůstávají k dispozici v části Formuláře –> Nastavení –> SmartGuard AI.
-
Lze překlady spravovat na WordPress.org?
-
Yes. Translations can be maintained on
translate.wordpress.org(project:smartguard-ai-for-gravity-forms), and WordPress delivers approved language packs automatically. This package also includes reviewed German fallback catalogs forde_DEandde_AT.
Recenze
Pro tento plugin nejsou žádné recenze.
Autoři
SmartGuard AI for Gravity Forms je otevřený software. Následující lidé přispěli k vývoji tohoto pluginu.
SpolupracovníciPlugin „SmartGuard AI for Gravity Forms“ byl přeložen do 2 jazyků. Děkujeme všem překladatelům za jejich pomoc.
Přeložte “SmartGuard AI for Gravity Forms” do svého jazyka.
Zajímá vás vývoj?
Prohledejte kód, podívejte se do SVN repozitáře, nebo se přihlaste k odběru protokolu vývoje pomocí RSS.
Přehled změn
1.3.4
- Rebuilt 30-day dashboard metrics from privacy-safe Gravity Forms entry metadata, including legacy decisions, skipped checks, and scoring coverage.
- Replaced automatic API validation on settings saves with an explicit read-only model-access test that sends no form data or prompt content.
- Completed and refreshed German admin translations for Germany and Austria, including localized weekly quality reports.
1.3.3
- Byla doplněna dokumentace k externím službám pro OpenAI a volitelnému konektoru HubSpot určená pro WordPress.org.
- Byla aktualizována metadata přispěvatele pluginu pro účet vlastníka na WordPress.org.
1.3.2
- Vylepšení uživatelského rozhraní rozšířených nastavení pomocí karet pro rychlou navigaci mezi sekcemi a přehlednějšího uspořádání dlouhých textů.
- Zlepšena použitelnost stránky s nastavením na počítači i mobilu díky vylepšenému rozložení a fixované oblasti pro uložení.
- Byla přidána zpráva o zkušebním testu v Dockeru, která rozlišuje mezi relevantním a spamovým chováním při odesílání.
- Z povrchu balíčku byl odstraněn zbývající zástupný soubor Firecrawl.
1.3.1
- Vylepšené uživatelské rozhraní pro správu SmartGuard umožňuje rychlejší skenování a snadnější konfiguraci (strukturované karty KPI, přehlednější uspořádání sekcí, vylepšené rozložení na počítači i mobilu).
- Byl přidán stylový list pro správce s omezeným rozsahem, který se načítá pouze na stránkách nastavení SmartGuard.
- Z balíčku pluginu byla odstraněna nepoužívaná třída „Firecrawl“ sloužící jako zástupný symbol.
1.3.0
- Byl přidán režim A/B testování s deterministickým přiřazováním variant a přiřazováním KPI podle jednotlivých variant.
- Byla přidána možnost výběru profilu modelu pro jednotlivé formuláře (
cost,balanced,quality) se sledováním metadat modelu. - Byl přidán konektor CRM od společnosti HubSpot s konfigurovatelným koncovým bodem a filtrováním pouze označených záznamů.
- Byla přidána stránka s výchozími nastaveními pro síť s více weby s volitelným vynuceným brandingem typu „white-label“.
- Byla přidána sada příkazů WP-CLI (
wp smartguard ...) pro statistiky, frontu ke kontrole, aktualizace prahových hodnot a zpětnou vazbu. - Byla přidána nastavení pro agentury a white-label (název značky, URL/e-mail podpory, režim klienta).
- Rozšířené statistiky a přehledy REST s porovnáním variant výzev a profilů modelů.
- Rozšířená dokumentace k provozním činnostem a partnerům (multisite, WP-CLI, HubSpot, program pro agentury).
1.2.0
- Byla přidána zóna nejistoty s rozhodovacím stavem
review. - Byly přidány akce pro zpětnou vazbu správce (
Potvrdit spam/Potvrdit, že nejde o spam) s trvale uloženými štítky pro učení. - Bylo přidáno adaptivní učení prahových hodnot pro jednotlivé tvary a stav signálu driftu.
- Byla přidána historie rozhodnutí s metadaty obsahujícími verzi výzvy, zdroj a míru spolehlivosti.
- Bylo přidáno jádro REST API: statistiky, podrobnosti záznamů, zpětná vazba, fronta ke kontroly, audit, export.
- Byla přidána vrstva API pro zdroje a nástroje kompatibilní s MCP.
- Byly přidány podepsané odchozí a příchozí webhooky s funkcí opakování a idempotencí.
- Byl přidán režim asynchronního zpracování, opakování pokusů/odklad, mechanismus „circuit breaker“ a mezipaměť vzorů.
- Byly přidány ovládací prvky pro ochranu soukromí: vyloučené typy polí/označení a nastavení doby uchovávání.
- Byla přidána struktura pro plánované týdenní zprávy a registr konektorů rozšíření.
- Byla přidána architektura adaptéru s adaptérem Gravity Forms a šablonou CF7.
1.1.0
- Opraveno zobrazení stavu AI u záznamů bez metadat SmartGuard.
- Byla přidána možnost zapnutí/vypnutí funkce SmartGuard pro jednotlivé formuláře a volitelné přepsání prahové hodnoty pro formulář.
- Bylo přidáno sledování důvodů AI a jejich zobrazení v seznamu účastníků.
- Byly přidány mechanismy pro řízení nákladů a rychlosti: minimální délka odeslaných dat a denní limit požadavků na API.
- Vylepšené nastavení ochrany osobních údajů a zveřejňování informací o externích službách v nastavení pluginu.
1.0.0
- První veřejné vydání.
- Integrace s Gravity Forms pro hodnocení spamu na základě umělé inteligence.
- Nastavení správce pro klíč API, kontext, prahovou hodnotu a oznámení.
