- 2026-05-21
- by LethaldiranMX
- Trends
- 0 Comments
DeveloperAutomatically classify Contact Form 7 submissions with AI to separate real customer inquiries from cold sales emails.
YomuForm is a plugin for Contact Form 7 that uses AI to classify each form submission as either a real customer inquiry or a sales solicitation. Cold sales outreach, recruiting pitches, business development proposals, scams, and competitor research are detected and labeled, so site owners can:
- Declutter the inbox by filtering out cold sales outreach
- Restore the accuracy of Google Analytics conversion tracking by excluding fake conversions
Before Contact Form 7 sends the email, YomuForm injects the classification result into the subject and body, making it easy to route messages with mail-client filters or GA4 rules.
Features
- Seamless Contact Form 7 integration via the wpcf7_before_send_mail hook. No template edits required.
- Bring Your Own Key (BYOK): use your own API key for Anthropic Claude, OpenAI, or Google Gemini. Classification traffic does not pass through the plugin author’s servers.
- Ready-to-use prompt out of the box. Optional “additional guidance” textarea lets you tune the classifier to your industry and policy.
- Test panel: try classifications with sample inputs without touching the production flow. Ships with 10 sample submissions.
- Judgment log: last 100 classifications stored in the dashboard, including timestamp, category, confidence, reason, and a 500-character excerpt of the submission.
- Single-recipient email notification for “real inquiry” submissions, so the noise of sales spam is filtered out of your alert channel.
- CF7 receipt mail augmentation: a “flag: 1/0” + confidence stamp is injected at the top of the standard CF7 email so client-side filters can route reliably.
- API keys stored encrypted with AES-256 (key material derived from wp_salt(‘auth’)).
- Verify button to test API connectivity before saving.
- Category management: full CRUD (add / remove / rename / edit description / toggle sales flag) on all classification categories, including the 6 defaults.
External services
This plugin sends form submission content to whichever AI provider you configure. To use the plugin you must obtain and enter your own API key from one of the supported providers. The plugin author does not proxy, store, or otherwise handle this classification traffic.
Anthropic Claude
Used when “Anthropic” is selected as the provider in the settings. The plugin sends a single POST request to https://api.anthropic.com/v1/messages with the user’s prompt (which contains the Contact Form 7 submission content) and the user’s API key in the x-api-key header. This happens once per Contact Form 7 submission, only when the API key is set.
- Site: https://www.anthropic.com/
- Terms of service: https://www.anthropic.com/legal/consumer-terms
- Privacy policy: https://www.anthropic.com/legal/privacy
OpenAI
Used when “OpenAI” is selected as the provider. The plugin sends a single POST request to https://api.openai.com/v1/chat/completions with the user’s prompt and Bearer token authorization. This happens once per Contact Form 7 submission, only when the API key is set.
- Site: https://openai.com/
- Terms of use: https://openai.com/policies/terms-of-use
- Privacy policy: https://openai.com/policies/privacy-policy
Google Gemini
Used when “Gemini” is selected as the provider. The plugin sends a single POST request to https://generativelanguage.googleapis.com/v1beta/models/{model}:generateContent (with the model name selected by the user) and the user’s API key in the query string. This happens once per Contact Form 7 submission, only when the API key is set.
- Site: https://ai.google.dev/
- Gemini API terms: https://ai.google.dev/gemini-api/terms
- Privacy policy: https://policies.google.com/privacy
Privacy Notice
This plugin handles the following data:
- Form submission content – Contact Form 7 submission content is sent to the AI provider you configure (Anthropic, OpenAI, or Google) for classification. The plugin author neither proxies nor stores this traffic.
- Judgment log – A 500-character excerpt of the submission, plus its SHA-256 hash, plus the classification result, confidence, reason, model name, and token count, are stored in the WordPress database. The log is capped at 100 entries (ring buffer); older entries are deleted automatically.
- API key – Your AI provider API key is encrypted with AES-256-CBC before storage. It is deleted when the plugin is uninstalled.
All data is removed on uninstall (see uninstall.php).
