Title: SmartGuard AI for Gravity Forms Author: Andreas Ostheimer Published: 3, Agostu de 2026 Last modified: 3, Agostu de 2026 --- Guetar plugins ![](https://ps.w.org/smartguard-ai-for-gravity-forms/assets/banner-772x250.png?rev =3632476) ![](https://ps.w.org/smartguard-ai-for-gravity-forms/assets/icon-256x256.png?rev =3632476) # SmartGuard AI for Gravity Forms By [Andreas Ostheimer](https://profiles.wordpress.org/helpstring/) [Download](https://downloads.wordpress.org/plugin/smartguard-ai-for-gravity-forms.1.3.4.zip) * [Details](https://ast.wordpress.org/plugins/smartguard-ai-for-gravity-forms/#description) * [Reviews](https://ast.wordpress.org/plugins/smartguard-ai-for-gravity-forms/#reviews) * [Installation](https://ast.wordpress.org/plugins/smartguard-ai-for-gravity-forms/#installation) * [Development](https://ast.wordpress.org/plugins/smartguard-ai-for-gravity-forms/#developers) [Support](https://wordpress.org/support/plugin/smartguard-ai-for-gravity-forms/) ## Description SmartGuard AI adds an AI relevance firewall to Gravity Forms. Traditional spam tools mostly ask: “Does this look like bot traffic?” SmartGuard asks: “Is this submission relevant for this form and this business?” That is why it works well for websites that receive many human-written but irrelevant messages. ### Why teams install SmartGuard AI * Higher signal quality in Gravity Forms entries, not just bot blocking. * Explainable decisions with score, threshold, reason, model profile, and history. * Faster moderation with direct `Confirm spam` / `Confirm not spam` actions. * Better long-term accuracy via adaptive thresholds from real admin feedback. * Scale-ready operations: async queue, retry/backoff, circuit breaker, and API usage limits. * Integration-ready for agencies and automation stacks (REST, signed webhooks, MCP tools/resources, HubSpot connector). ### What you can control * Decision states: `flagged`, `passed`, `review`, `skipped`, `queued`. * Global + per-form control: enable/disable, threshold override, prompt version, A/B mode, model profile. * Cost/risk controls: minimum content length, daily/weekly/monthly API limits, pattern cache. * Governance controls: retention settings, excluded fields, audit trail, white- label and multisite defaults. ### Best fit use cases * Contact forms with recurring irrelevant outreach or low-quality lead spam. * Clinics, legal firms, consultancies, and local services where relevance is critical. * Multi-form setups where each form needs a different strictness level. * Agencies operating multiple client sites with standardized anti-spam operations. ### Quick setup (about 5 minutes) 1. Activate SmartGuard AI and ensure Gravity Forms is active. 2. Add your OpenAI API key. 3. Set threshold and uncertainty margin. 4. Submit one test entry and review the score/reason in the entries list. 5. Tune per-form thresholds where needed. Bundled locales: * 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. Requirements: * WordPress 5.9 or higher * PHP 7.4 or higher * Gravity Forms 2.5 or higher (required) * OpenAI API key ### External services ### OpenAI API This plugin connects to the OpenAI API to analyze enabled form submissions and calculate a relevance score. * What the service is used for: AI-based spam and relevance scoring for Gravity Forms entries. * 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/completions` for scoring requests and `https://api.openai.com/v1/models/{configured-model}` for the read- only connection test. * Service provider: OpenAI. * Terms of Use: https://openai.com/policies/terms-of-use * Privacy Policy: 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. ### HubSpot API (optional) This plugin includes an optional HubSpot connector that is disabled by default. * What the service is used for: forwarding SmartGuard decision and feedback events to a CRM notes endpoint for follow-up workflows. * Data sent: SmartGuard event metadata including entry ID, form ID, status or feedback label, score, threshold, reason, and timestamp. The default connector does not send submitted field values to HubSpot. * When data is sent: only when the site admin enables the HubSpot connector and SmartGuard emits a supported decision or feedback event. * Where data is sent: `https://api.hubapi.com/crm/v3/objects/notes` by default, or the custom endpoint URL configured by the site admin. * Service provider: HubSpot for the default endpoint. If a custom endpoint is configured, the same event payload is sent to that configured external service instead. * Terms of Use: https://legal.hubspot.com/website-terms-of-use * Privacy Policy: https://legal.hubspot.com/privacy-policy ## Screenshots [⌊Global setup dashboard: API key, context, thresholds, reliability controls, integrations, and privacy settings.⌉⌊Global setup dashboard: API key, context, thresholds, reliability controls, integrations, and privacy settings.⌉[ Global setup dashboard: API key, context, thresholds, reliability controls, integrations, and privacy settings. [⌊Explainable entry decisions: status, score, threshold, reason, plus one-click feedback actions.⌉⌊Explainable entry decisions: status, score, threshold, reason, plus one-click feedback actions.⌉[ Explainable entry decisions: status, score, threshold, reason, plus one-click feedback actions. [⌊Per-form tuning in Gravity Forms: enable/disable, threshold override, prompt strategy, and model profile.⌉⌊Per-form tuning in Gravity Forms: enable/disable, threshold override, prompt strategy, and model profile.⌉[ Per-form tuning in Gravity Forms: enable/disable, threshold override, prompt strategy, and model profile. [⌊Native WordPress plugin integration with SmartGuard AI active in the standard Plugins screen.⌉⌊Native WordPress plugin integration with SmartGuard AI active in the standard Plugins screen.⌉[ Native WordPress plugin integration with SmartGuard AI active in the standard Plugins screen. ## Installation 1. Upload the `smartguard-ai-for-gravity-forms` folder to `/wp-content/plugins/` or install the plugin ZIP via WordPress admin. 2. Activate **SmartGuard AI** in WordPress. 3. Ensure Gravity Forms is installed and activated. 4. Open **SmartGuard AI** settings in the WordPress admin menu. 5. Add your OpenAI API key. 6. Set spam threshold, uncertainty margin, and API/cost limits. 7. Optional: configure adaptive thresholds, async processing, and webhook integration. 8. Optional: per form, open **Forms -> Settings -> SmartGuard AI** and configure form- specific enable/disable, threshold override, prompt version, A/B mode, and model profile. ## FAQ ### Does this plugin work without Gravity Forms? No. Gravity Forms is required. ### What happens if the OpenAI API is unavailable? The plugin fails open for reliability: entries are not auto-marked as spam when no valid score is returned. ### What does the score mean? The score represents how relevant the submission appears for your website context. Lower than threshold is treated as spam. ### Is this a replacement for all spam tools? SmartGuard AI is best used as an additional relevance-based layer. You can still combine it with classic protections (honeypots, captcha, blocklists) for stronger coverage. ### Where are results stored? The plugin stores decision status, score, threshold, reason, prompt version, confidence, feedback labels, and decision history in Gravity Forms entry meta. Aggregated decision/ feedback logs are stored in WordPress options for analytics, learning, and exports. ### Why does an entry show “Skipped” or “Review”? SmartGuard uses: – `Review` when score is inside the uncertainty margin around threshold. – `Skipped` when checks are disabled, content is too short, limits/circuit prevent API calls, or API response is invalid. ### Is there an API for integrations? Yes. SmartGuard provides REST endpoints for stats, entry details, feedback, review queue, exports, audit logs, and MCP-compatible resources/tools. Signed outbound webhooks and signed inbound feedback webhook are also available. ### Is there WP-CLI support? Yes. Use `wp smartguard` commands for stats, review queue, threshold tuning, feedback import, and connector inspection. ### Is there a complete settings reference? Yes. Open **SmartGuard AI -> Settings** and use the built-in **Settings Reference** section. Form-specific controls remain available under **Forms -> Settings -> SmartGuard AI**. ### Can translations be managed on 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 for `de_DE` and `de_AT`. ## Reviews There are no reviews for this plugin. ## Contributors & Developers “SmartGuard AI for Gravity Forms” is open source software. The following people have contributed to this plugin. Contributors * [ Andreas Ostheimer ](https://profiles.wordpress.org/helpstring/) “SmartGuard AI for Gravity Forms” has been translated into 2 locales. Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/smartguard-ai-for-gravity-forms/contributors) for their contributions. [Translate “SmartGuard AI for Gravity Forms” into your language.](https://translate.wordpress.org/projects/wp-plugins/smartguard-ai-for-gravity-forms) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/smartguard-ai-for-gravity-forms/), check out the [SVN repository](https://plugins.svn.wordpress.org/smartguard-ai-for-gravity-forms/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/smartguard-ai-for-gravity-forms/) by [RSS](https://plugins.trac.wordpress.org/log/smartguard-ai-for-gravity-forms/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 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 * Added WordPress.org-facing external service documentation for OpenAI and the optional HubSpot connector. * Updated plugin contributor metadata for the WordPress.org owner account. #### 1.3.2 * Extended settings UI polish with fast section navigation chips and clearer long- form orientation. * Improved settings-page usability on desktop/mobile with refined spacing and sticky save area. * Added Docker smoke-test report for relevant vs spammy submission behavior. * Removed leftover Firecrawl placeholder file from packaging surface. #### 1.3.1 * Polished SmartGuard admin UI for faster scanning and easier configuration (structured KPI cards, clearer section layout, improved spacing on desktop/mobile). * Added scoped admin stylesheet loaded only on SmartGuard settings pages. * Removed unused Firecrawl placeholder class from plugin package. #### 1.3.0 * Added prompt A/B testing mode with deterministic variant assignment and KPI attribution by variant. * Added per-form model profile selection (`cost`, `balanced`, `quality`) with model metadata tracking. * Added HubSpot reference CRM connector with configurable endpoint and flagged- only filtering. * Added multisite network defaults page with optional enforced white-label branding. * Added WP-CLI command suite (`wp smartguard ...`) for stats, review queue, threshold updates, and feedback. * Added agency/white-label settings (brand name, support URL/email, client mode). * Extended REST stats and reporting with prompt-variant/model-profile comparisons. * Expanded operations and partner documentation (multisite, WP-CLI, HubSpot, agency program). #### 1.2.0 * Added uncertainty zone with `review` decision state. * Added admin feedback actions (`Confirm spam` / `Confirm not spam`) with persisted learning labels. * Added adaptive per-form threshold learning and drift signal state. * Added decision history with prompt version, source, and confidence metadata. * Added REST API core: stats, entry details, feedback, review queue, audit, export. * Added MCP-compatible resources/tools API layer. * Added signed outbound and inbound webhooks with retry and idempotency. * Added async processing mode, retry/backoff, circuit breaker, and pattern cache. * Added privacy controls: excluded field types/labels and retention settings. * Added scheduled weekly report framework and extension connector registry. * Added adapter architecture with Gravity Forms adapter and CF7 skeleton. #### 1.1.0 * Fixed AI status display for entries without SmartGuard meta. * Added per-form SmartGuard enable/disable and optional form threshold override. * Added AI reason tracking and display in entry list. * Added cost/rate controls: minimum submission length and daily API request limit. * Improved privacy/external-service disclosure in plugin settings. #### 1.0.0 * Initial public release. * Gravity Forms integration for AI-based spam scoring. * Admin settings for API key, context, threshold, and notifications. ## Meta * Version **1.3.4** * Last updated **6 díes ago** * Active installations **Fewer than 10** * WordPress version ** 5.9 or higher ** * Tested up to **7.0.3** * PHP version ** 7.4 or higher ** * Languages * [Czech](https://cs.wordpress.org/plugins/smartguard-ai-for-gravity-forms/), [English (UK)](https://en-gb.wordpress.org/plugins/smartguard-ai-for-gravity-forms/) y [English (US)](https://wordpress.org/plugins/smartguard-ai-for-gravity-forms/). * [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/smartguard-ai-for-gravity-forms) * Tags * [AI](https://ast.wordpress.org/plugins/tags/ai/)[forms](https://ast.wordpress.org/plugins/tags/forms/) [gravity forms](https://ast.wordpress.org/plugins/tags/gravity-forms/)[openai](https://ast.wordpress.org/plugins/tags/openai/) [spam](https://ast.wordpress.org/plugins/tags/spam/) * [Advanced View](https://ast.wordpress.org/plugins/smartguard-ai-for-gravity-forms/advanced/) ## Ratings No reviews have been submitted yet. [Your review](https://wordpress.org/support/plugin/smartguard-ai-for-gravity-forms/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/smartguard-ai-for-gravity-forms/reviews/) ## Contributors * [ Andreas Ostheimer ](https://profiles.wordpress.org/helpstring/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/smartguard-ai-for-gravity-forms/)